> ## 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.

# DocumentViewer-Objekt (IDocumentViewer-Schnittstelle)

> DocumentViewer-Objekt (IDocumentViewer-Schnittstelle) in ABBYY FineReader Engine Visual Components unter Windows — Das DocumentViewer-Objekt ist ein ActiveX-Steuerelement, mit dem Sie die Liste der Seiten im Dokument anzeigen und ...

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

Das DocumentViewer-Objekt ist ein ActiveX-Steuerelement, mit dem Sie die Liste der Seiten im Dokument anzeigen und ihren Status überwachen können. Sie können das erkannte Dokument auch speichern oder es mithilfe der in der Komponente verfügbaren Befehle in der ausgewählten Anwendung öffnen. Ein Dokument wird über die Eigenschaft FRDocument mit der Komponente verbunden.

Die visuelle Komponente Document Viewer kann je nach Wert der Eigenschaft Mode folgendermaßen aussehen:

* Detailansicht

Bietet detaillierte Informationen zu jeder Dokumentseite.

<img src="https://mintcdn.com/abbyy/lsETHFYUFiongXSm/images/fine-reader/engine/documentviewer_details.gif?s=17b7a922309b41af5818b19c3b5900ea" alt="DocumentViewer_Details" width="642" height="174" data-path="images/fine-reader/engine/documentviewer_details.gif" />

* Miniaturansicht

Zeigt Dokumentseiten als Miniaturansichten an.

<img src="https://mintcdn.com/abbyy/lsETHFYUFiongXSm/images/fine-reader/engine/documentviewer_thumbnails.gif?s=ea87d01ff27d7509886b17a0dbe3ad48" alt="DocumentViewer_Thumbnails" width="302" height="217" data-path="images/fine-reader/engine/documentviewer_thumbnails.gif" />

Sie können das Erscheinungsbild der Komponente über ihre Eigenschaften anpassen. So können Sie beispielsweise über die Eigenschaft Toolbar Schaltflächen zur Symbolleiste hinzufügen oder daraus entfernen oder über die Eigenschaft PopupMenu das Kontextmenü der Komponente ändern. Ausführliche 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).

Die Informationen zur Dokumentüberwachung werden über spezielle ausgehende Schnittstellen bereitgestellt. Diese Schnittstellen sind [IDocumentViewerEvents](/de/fine-reader/engine/visual-components-reference/idocumentviewerevents) (für C++) und eine dispinterface [DIDocumentViewerEvents](/de/fine-reader/engine/visual-components-reference/idocumentviewerevents) (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 für deren Verarbeitung bietet. Dieses Objekt kann in Visual Basic als WithEvents deklariert werden.

Für C++-Benutzer bedeutet dies, dass das Objekt die Schnittstelle IConnectionPointContainer unterstützt. Um Benachrichtigungsereignisse zu empfangen, sollte ein C++-Benutzer ein von der Schnittstelle IDocumentViewerEvents abgeleitetes Objekt erstellen und dann mit Standard-COM-Mitteln die Verbindung zwischen diesem Objekt und der im DocumentViewer-Objekt implementierten Ereignisquelle herstellen.

Die visuelle Komponente Document Viewer kann mit der Komponente [Component Synchronizer](/de/fine-reader/engine/visual-components-reference/supplementary-objects/componentsynchronizer) verbunden werden. In diesem Fall werden alle Ereignisse von Document 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="activepage" />

          <strong>ActivePage</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>
          Gibt die aktive Seite im Document Viewer an. Wenn keine aktive
          Seite vorhanden ist, beträgt der Wert dieser Eigenschaft 0.
        </p>
      </td>
    </tr>

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

          <strong>CaptionPaneEnabled</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 Beschriftungsbereich des Document Viewers aktiviert ist. Wenn
          diese Eigenschaft FALSE ist, wird der Beschriftungsbereich 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 Document 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">
            read-only
          </a>
        </p>
      </td>

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

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

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

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

          <strong>FRDocument</strong>
        </p>
      </td>

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

      <td>
        <p>Gibt das mit dem Document Viewer verbundene Dokument an.</p>
      </td>
    </tr>

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

          <strong>LanguagePaneEnabled</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 Sprachbereich des Document Viewers aktiviert ist. Wenn
          diese Eigenschaft FALSE ist, wird der Sprachbereich nicht angezeigt.
        </p>

        <p>Standardmäßig ist der Wert TRUE.</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 Document 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-Nachrichten 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 sie nach Abschluss des Vorgangs
          wieder auf FALSE zu setzen. Auf diese Weise kann das Dokument nicht über den
          Document Viewer beschädigt werden.
        </p>

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

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

          <strong>Mode</strong>
        </p>
      </td>

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

      <td>
        <p>
          Gibt den aktuellen Modus des Document Viewers an: Detailansicht oder
          Miniaturansicht.
        </p>

        <p>Standardmäßig ist der Modus DVM\_Thumbnails.</p>
      </td>
    </tr>

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

          <strong>PopupMenu</strong>
        </p>
      </td>

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

          ,{" "}

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

      <td>
        <p>Ermöglicht den Zugriff auf die Einstellungen des Kontextmenüs.</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
          parameters are used if the analysis and recognition processes are
          called directly from Document Viewer.
        </p>

        <Note>
          If Document Viewer is connected to Component Synchronizer, use the{" "}

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

          {" "}

          property to change parameters used for processing. If you change
          processing parameters via the property of Document Viewer, errors may
          occur.
        </Note>
      </td>
    </tr>

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

          <strong>Title</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>Specifies the title of the Document Viewer component.</p>
        <p>By default, it is "Pages".</p>
      </td>
    </tr>

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

          <strong>Toolbar</strong>
        </p>
      </td>

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

          ,{" "}

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

      <td>
        <p>Provides access to the toolbar settings.</p>
      </td>
    </tr>

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

          <strong>SelectedPagesIndices</strong>
        </p>
      </td>

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

      <td>
        <p>Provides access to the collection of indices of selected pages.</p>
      </td>
    </tr>

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

          <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>
          Specifies the path to the folder which contains files with the
          settings of Document Viewer. Other Visual Components have the same
          property. Each Visual Component should use its own folder with
          settings.
        </p>

        <p>
          The value of this property is constructed from the path to the folder,
          in which ABBYY FineReader Engine stores user-specific data, and the
          name of its subfolder. By default, the folder with user-specific data
          is the{" "}

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

          . It can be changed during initialization of FineReader Engine (via
          the{" "}

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

          {" "}

          function, or via the{" "}

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

          {" "}

          method). The default name of the subfolder is an arbitrary GUID. To
          change the name of the subfolder, you should specify the new name in
          the properties of the component in Visual Studio at design time. If
          you try to specify the value of the property at run time, this value
          is ignored.
        </p>

        <p>
          Wenn Sie die Komponente zur Entwurfszeit in Visual Studio einem Formular 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. Wenn der Wert der Eigenschaft aus irgendeinem Grund zur Entwurfszeit nicht definiert ist (z. B. wenn Sie die
          Komponente dynamisch zur Laufzeit generieren), erstellt die Komponente bei jeder Initialisierung einen neuen Ordner
          mit den Einstellungen. Um eine Anhäufung von Ordnern 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="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>

          , read-only
        </p>
      </td>

      <td>
        <p>Returns the window handle of the client area.</p>
      </td>
    </tr>
  </tbody>
</table>

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

| Name                                                                                                    | Beschreibung                                                                                                                                                                                                                                                                                       |
| ------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [UpdateOptions](/de/fine-reader/engine/visual-components-reference/documentviewer/updateoptions-method) | Aktualisiert die im Dialogfeld „Optionen“ von Document 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 Document Viewer auf den aktuellen Stand zu aktualisieren. |

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

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

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

[IDocumentViewerEvents](/de/fine-reader/engine/visual-components-reference/idocumentviewerevents)

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

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

[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)