> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ZoomViewer-Objekt (IZoomViewer-Schnittstelle)

> ZoomViewer-Objekt (IZoomViewer-Schnittstelle) in ABBYY FineReader Engine Visual Components unter Windows — Das ZoomViewer-Objekt ist ein ActiveX-Steuerelement, mit dem Sie ein vergrößertes Bild der gerade bearbeiteten Zeile oder des verarbeiteten Bildbereichs anzeigen können ...

<Warning>
  Visuelle Komponenten sind in FRE für Windows implementiert.
</Warning>

Das ZoomViewer-Objekt ist ein ActiveX-Steuerelement, mit dem Sie eine vergrößerte Ansicht der Zeile oder des verarbeiteten Bildbereichs anzeigen können, die bzw. der gerade bearbeitet wird. Während [Image Viewer](/de/fine-reader/engine/visual-components-reference/imageviewer) die allgemeine Seitenansicht anzeigt, bietet Zoom Viewer eine einfache Möglichkeit, das Bild detaillierter zu betrachten, die Position des Bereichs anzupassen oder unsichere Zeichen mit dem vergrößerten Bild zu vergleichen. Ein Bild wird über die Eigenschaft FRPage mit Zoom Viewer verbunden.

Die Zoom Viewer-Komponente sieht wie folgt aus:

<img src="https://mintcdn.com/abbyy/B_SRGbkkbQ9YH40E/images/fine-reader/engine/zoomviewer.gif?s=c3d3ed6f17c9738f26795a72a9c35c42" alt="ZoomViewer" width="494" height="212" data-path="images/fine-reader/engine/zoomviewer.gif" />

Sie können das Erscheinungsbild der Komponente über ihre Eigenschaften ändern. So können Sie beispielsweise das Kontextmenü der Komponente über die Eigenschaft Commands anpassen. Weitere Informationen finden Sie unter [Anpassen des Kontextmenüs und der Symbolleiste einer visuellen Komponente](/de/fine-reader/engine/guided-tour/advanced-techniques/using-gui-elements/customizing-the-context-menu-and-toolbar-of-a-visual-component).

Informationen zur Bildanzeige werden über spezielle ausgehende Schnittstellen bereitgestellt. Diese Schnittstellen sind [IZoomViewerEvents](/de/fine-reader/engine/visual-components-reference/izoomviewerevents) (für C++) und eine dispinterface [DIZoomViewerEvents](/de/fine-reader/engine/visual-components-reference/izoomviewerevents) (für Visual Basic).

Es ist wichtig zu beachten, dass sich Visual-Basic-Benutzer nicht um die Details der Implementierung von Ereignisschnittstellen kümmern müssen, da diese Entwicklungsplattform einfache Möglichkeiten zu deren Verarbeitung bietet. Dieses Objekt kann in Visual Basic mit WithEvents deklariert werden.

Für C++-Benutzer bedeutet dies, dass die Schnittstelle IConnectionPointContainer unterstützt wird. Um Ereignisbenachrichtigungen zu empfangen, sollte ein C++-Benutzer ein Objekt erstellen, das von der Schnittstelle IZoomViewerEvents abgeleitet ist, und dann mit den Standardmitteln von COM die Verbindung zwischen diesem Objekt und der im ZoomViewer-Objekt implementierten Ereignisquelle herstellen.

Die Zoom Viewer-Komponente kann mit der Komponente [Component Synchronizer](/de/fine-reader/engine/visual-components-reference/supplementary-objects/componentsynchronizer) verbunden werden. In diesem Fall werden alle Ereignisse in Zoom Viewer automatisch an andere mit dem Synchronizer verbundene Komponenten übertragen, und die gesamte Anwendung arbeitet synchron.

<div id="properties">
  ## Eigenschaften
</div>

<table>
  <thead>
    <tr>
      <th>
        <p>
          <strong>Name</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>Typ</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>Beschreibung</strong>
        </p>
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        <p>
          <a name="activetool" />

          <strong>ActiveTool</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/visual-components-reference/enumerations/boxeditortoolenum">
              BoxEditorToolEnum
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>Gibt das aktive Werkzeug für die Block- und Bildbearbeitung an.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="bottompaneenabled" />

          <strong>BottomPaneEnabled</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              VARIANT\_BOOL
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Gibt an, ob der untere Bereich des Zoom Viewers aktiviert ist. Wenn diese
          Eigenschaft FALSE ist, wird der untere Bereich nicht angezeigt.
        </p>

        <p>Standardmäßig ist der Wert TRUE.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="contextmenuenabled" />

          <strong>ContextMenuEnabled</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              VARIANT\_BOOL
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Gibt an, ob das Kontextmenü des Zoom Viewers aktiviert ist. Wenn diese
          Eigenschaft FALSE ist, wird das Kontextmenü nie angezeigt.
        </p>

        <p>Standardmäßig ist der Wert TRUE.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="commands" />

          <strong>Commands</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/visual-components-reference/supplementary-objects/commands">
              Commands
            </a>
          </strong>

          ,{" "}

          <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">
            schreibgeschützt
          </a>
        </p>
      </td>

      <td>
        <p>
          Ermöglicht den Zugriff auf die im Zoom Viewer verfügbaren Befehle. Siehe{" "}

          <a href="/de/fine-reader/engine/visual-components-reference/zoomviewer/zoom-viewer-commands">
            die Liste der im Zoom Viewer verfügbaren Befehle
          </a>

          .
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="frpage" />

          <strong>FRPage</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/api-reference/document-related-objects/frpage">
              FRPage
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>Stellt die mit dem Zoom Viewer verbundene Dokumentseite dar.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="locked" />

          <strong>Locked</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              VARIANT\_BOOL
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>Gibt an, ob der Zoom Viewer gesperrt ist.</p>
        <p>Diese Eigenschaft ist in folgenden Situationen nützlich:</p>

        <ul>
          <li>
            Ein Analyse-, Erkennungs-, Synthese- oder Exportvorgang wird über die
            FineReader Engine API aufgerufen (nicht über Visual Components), oder
          </li>

          <li>
            Ihre Anwendung empfängt Benachrichtigungen über bestimmte Ereignisse (z. B.
            vom

            <strong>
              {" "}

              <a href="/de/fine-reader/engine/api-reference/document-related-objects/frdocument">
                FRDocument
              </a>

              {" "}
            </strong>

            -Objekt) und verarbeitet Windows-Meldungen von Visual Components in
            diesen Ereignishandlern.
          </li>
        </ul>

        <p>
          In diesem Fall empfehlen wir, diese Eigenschaft vor der Analyse, Erkennung,
          Synthese oder dem Export auf TRUE zu setzen und nach Abschluss des Vorgangs
          auf FALSE zu setzen. In diesem Fall kann das Dokument nicht über den Zoom Viewer
          beschädigt werden.
        </p>

        <p>Standardmäßig ist der Wert FALSE.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="processingparams" />

          <strong>ProcessingParams</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/documentprocessingparams">
              DocumentProcessingParams
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Gibt die Standard-Verarbeitungsparameter für das Dokument an. Diese
          Parameter werden verwendet, wenn die Analyse- und Erkennungsprozesse
          direkt aus dem Zoom Viewer aufgerufen werden.
        </p>

        <Note>
          Wenn der Zoom Viewer mit dem Component Synchronizer verbunden ist, verwenden Sie die{" "}

          <a href="/de/fine-reader/engine/visual-components-reference/supplementary-objects/componentsynchronizer#processingparams">
            IComponentSynchronizer::ProcessingParams
          </a>

          {" "}

          -Eigenschaft, um die für die Verarbeitung verwendeten Parameter zu ändern. Wenn Sie
          Verarbeitungsparameter über die Eigenschaft des Zoom Viewers ändern, können Fehler
          auftreten.
        </Note>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>SettingsPath</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              BSTR
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Gibt den Pfad zum Ordner an, der Dateien mit den Einstellungen des Zoom Viewers enthält.
          Andere Visual Components haben dieselbe Eigenschaft. Jede Visual Component sollte ihren
          eigenen Ordner mit Einstellungen verwenden.
        </p>

        <p>
          Der Wert dieser Eigenschaft setzt sich aus dem Pfad zum Ordner, in dem ABBYY FineReader Engine
          benutzerspezifische Daten speichert, und dem Namen des zugehörigen Unterordners zusammen.
          Standardmäßig ist der Ordner mit benutzerspezifischen Daten der{" "}

          <a href="/de/fine-reader/engine/distribution/distribution-windows/distribution-kit#finereader_engine_data_folder">
            FineReader Engine-Datenordner
          </a>

          . Dieser kann während der Initialisierung von FineReader Engine geändert werden (über die{" "}

          <strong>
            <a href="/de/fine-reader/engine/api-reference/functions/initializeengine-function">
              InitializeEngine
            </a>
          </strong>

          {" "}

          -Funktion oder über die{" "}

          <strong>
            <a href="/de/fine-reader/engine/api-reference/engine-loaders/iengineloader/initializeengine-method">
              IEngineLoader::InitializeEngine
            </a>
          </strong>

          {" "}

          -Methode). Der Standardname des Unterordners ist eine beliebige GUID. Um den Namen des
          Unterordners zu ändern, geben Sie den neuen Namen in
          die Eigenschaften der Komponente in Visual Studio zur Entwurfszeit. Wenn
          Sie versuchen, den Wert der Eigenschaft zur Laufzeit festzulegen, wird
          dieser Wert ignoriert.
        </p>

        <p>
          Wenn Sie die Komponente beim Entwurf zu einem Formular in Visual Studio hinzufügen,
          wird der Wert der Eigenschaft entweder automatisch mit dem
          Standardwert oder manuell mit einem benutzerdefinierten Wert festgelegt. In beiden Fällen wird der
          Wert zur Entwurfszeit definiert. Falls der Wert der
          Eigenschaft aus irgendeinem Grund nicht zur Entwurfszeit definiert wird (z. B. wenn Sie die
          Komponente dynamisch zur Laufzeit generieren), erstellt die Komponente bei jeder Initialisierung einen neuen Ordner
          mit den Einstellungen. Um eine Vervielfachung der Ordner zu vermeiden,
          sollten Sie den erstellten Einstellungsordner nach der Deinitialisierung der Komponente löschen. In diesem Fall können Sie nur
          die Standardeinstellungen der Komponente verwenden und die
          Einstellungen nicht sitzungsübergreifend speichern.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="symbolrect" />

          <strong>SymbolRect</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/frrectangle">
              FRRectangle
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Speichert die Koordinaten des Zeichenrechtecks des aktuellen Zeichens in Pixeln.
          Die Koordinaten sind relativ zum Dokumentbild.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="symbolrectenabled" />

          <strong>SymbolRectEnabled</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              VARIANT\_BOOL
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Gibt an, ob das aktuelle Zeichen mit einem gelben
          Rechteck markiert werden soll.
        </p>

        <p>Standardmäßig ist der Wert TRUE.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="viewscale" />

          <strong>ViewScale</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              int
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Gibt den Maßstab des Bildes in Prozentpunkten an. Diese Eigenschaft
          kann auch auf eine der{" "}

          <strong>
            <a href="/de/fine-reader/engine/visual-components-reference/enumerations/scaletypes">
              ScaleTypes
            </a>
          </strong>

          {" "}

          Konstanten gesetzt werden.
        </p>

        <p>
          Standardmäßig ist der Wert ST\_PixelToPixel, d. h. das
          Bild wird im Pixel-für-Pixel-Modus angezeigt.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="visibledocumentarea" />

          <strong>VisibleDocumentArea</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/frrectangle">
              FRRectangle
            </a>
          </strong>

          ,{" "}

          <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">
            nur lesbar
          </a>
        </p>
      </td>

      <td>
        <p>
          Speichert die Koordinaten des sichtbaren Dokumentbereichs in Pixeln. Die
          Koordinaten sind relativ zum Dokumentbild.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="windowhandle" />

          <strong>WindowHandle</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              \_\_int64
            </a>
          </strong>

          , nur lesbar
        </p>
      </td>

      <td>
        <p>Gibt das Fenster-Handle des Clientbereichs zurück.</p>
      </td>
    </tr>
  </tbody>
</table>

<div id="methods">
  ## Methoden
</div>

| Name                                                                                                                      | Beschreibung                                                                                                                                                                                                                                                                              |
| ------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [CenterOnDocumentPoint](/de/fine-reader/engine/visual-components-reference/zoomviewer/centerondocumentpoint-method)       | Scrollt die Zoomansicht so, dass der angegebene Punkt in der Mitte der Ansicht angezeigt wird.                                                                                                                                                                                            |
| [DocumentToScreen](/de/fine-reader/engine/visual-components-reference/zoomviewer/documenttoscreen-method)                 | Konvertiert die Koordinaten des angegebenen Punkts auf dem Dokumentbild in Bildschirmkoordinaten.                                                                                                                                                                                         |
| [GetSelectedBlocksIndices](/de/fine-reader/engine/visual-components-reference/zoomviewer/getselectedblocksindices-method) | Gibt die Indizes der ausgewählten Blöcke zurück.                                                                                                                                                                                                                                          |
| [GetSelectedCells](/de/fine-reader/engine/visual-components-reference/zoomviewer/getselectedcells-method)                 | Gibt das umschließende Rechteck der ausgewählten Zellen im angegebenen Tabellenblock zurück.                                                                                                                                                                                              |
| [ScreenToDocument](/de/fine-reader/engine/visual-components-reference/zoomviewer/screentodocument-method)                 | Konvertiert die Bildschirmkoordinaten des angegebenen Punkts in Koordinaten auf dem Dokumentbild.                                                                                                                                                                                         |
| [SetSelectedBlocksIndices](/de/fine-reader/engine/visual-components-reference/zoomviewer/setselectedblocksindices-method) | Legt die Blockauswahl fest.                                                                                                                                                                                                                                                               |
| [SetSelectedCells](/de/fine-reader/engine/visual-components-reference/zoomviewer/setselectedcells-method)                 | Legt die ausgewählten Zellen des angegebenen Tabellenblocks fest.                                                                                                                                                                                                                         |
| [ShowDocumentArea](/de/fine-reader/engine/visual-components-reference/zoomviewer/showdocumentarea-method)                 | Scrollt die Zoomansicht so, dass der Dokumentbereich mit den angegebenen Koordinaten sichtbar wird (soweit möglich).                                                                                                                                                                      |
| [UpdateOptions](/de/fine-reader/engine/visual-components-reference/zoomviewer/updateoptions-method)                       | Aktualisiert die im Dialogfeld „Options“ von Zoom Viewer festgelegten Einstellungen. Möglicherweise müssen Sie diese Methode aufrufen, wenn die Optionen in einer anderen visuellen Komponente geändert wurden, um die Optionen von Zoom Viewer auf den aktuellen Stand zu aktualisieren. |

<div id="samples">
  ## Beispiele
</div>

Diese Komponente wird in folgenden Codebeispielen verwendet: [VisualComponents](/de/fine-reader/engine/guided-tour/samples#visualcomponents).

<div id="see-also">
  ## Siehe auch
</div>

[IZoomViewerEvents](/de/fine-reader/engine/visual-components-reference/izoomviewerevents)

[IComponentSynchronizer::ZoomViewer](/de/fine-reader/engine/visual-components-reference/supplementary-objects/componentsynchronizer#zoomviewer)

[Erstellen einer Anwendung mit grafischer Benutzeroberfläche](/de/fine-reader/engine/guided-tour/advanced-techniques/using-gui-elements/creating-an-application-with-gui)

[Anpassen von Kontextmenü und Symbolleiste einer visuellen Komponente](/de/fine-reader/engine/guided-tour/advanced-techniques/using-gui-elements/customizing-the-context-menu-and-toolbar-of-a-visual-component)