> ## 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 オブジェクト (IZoomViewer インターフェイス)

> Windows 上の ABBYY FineReader Engine ビジュアル コンポーネントにおける ZoomViewer オブジェクト (IZoomViewer インターフェイス) — ZoomViewer オブジェクトは、現在編集中の行または処理済み画像領域の拡大画像を表示できる ActiveX コントロールです...

<Warning>
  ビジュアル コンポーネント は Windows 版 FRE に実装されています。
</Warning>

ZoomViewer オブジェクトは、現在編集中の行または処理済み画像領域の拡大画像を表示できる ActiveX コントロールです。[Image Viewer](/ja/fine-reader/engine/visual-components-reference/imageviewer) がページ全体の表示を行うのに対し、Zoom Viewer では画像の詳細を確認したり、領域の位置を調整したり、不確かな文字を拡大画像と比較したりできます。画像は FRPage プロパティを介して Zoom Viewer に接続されます。

Zoom Viewer コンポーネントの外観は次のとおりです。

<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" />

このコンポーネントの外観は、プロパティを使用して変更できます。たとえば、Commands プロパティを使用してコンポーネントのコンテキストメニューを変更できます。詳しくは、[ビジュアル コンポーネント のコンテキストメニューとツールバーのカスタマイズ](/ja/fine-reader/engine/guided-tour/advanced-techniques/using-gui-elements/customizing-the-context-menu-and-toolbar-of-a-visual-component) を参照してください。

画像の表示に関する情報は、特別な送出インターフェイスを通じて通知されます。これらのインターフェイスは、[IZoomViewerEvents](/ja/fine-reader/engine/visual-components-reference/izoomviewerevents) (C++ 用) および dispinterface [DIZoomViewerEvents](/ja/fine-reader/engine/visual-components-reference/izoomviewerevents) (Visual Basic 用) です。

なお、Visual Basic ユーザーはイベントインターフェイス実装の詳細を意識する必要はありません。この開発プラットフォームには、イベントを簡単に処理するための手段が用意されています。このオブジェクトは Visual Basic で WithEvents として宣言できます。

C++ ユーザーにとって、これは IConnectionPointContainer インターフェイスをサポートしていることを意味します。通知イベントを受け取るには、C++ ユーザーは IZoomViewerEvents インターフェイスから派生したオブジェクトを作成し、その後、標準の COM の手段によって、そのオブジェクトと ZoomViewer オブジェクトに実装されたイベントソースとの接続を確立する必要があります。

Zoom Viewer コンポーネントは、[Component Synchronizer](/ja/fine-reader/engine/visual-components-reference/supplementary-objects/componentsynchronizer) コンポーネントに接続できます。この場合、Zoom Viewer のすべてのイベントは Synchronizer に接続された他のコンポーネントに自動的に送信され、アプリケーション全体が同期して動作します。

<div id="properties">
  ## プロパティ
</div>

<table>
  <thead>
    <tr>
      <th>
        <p>
          <strong>名前</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>型</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>説明</strong>
        </p>
      </th>
    </tr>
  </thead>

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

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

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

      <td>
        <p>ブロックおよび画像編集用のアクティブ ツールを指定します。</p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          Zoom Viewer の下部ペインが有効かどうかを指定します。このプロパティが FALSE の場合、下部ペインは表示されません。
        </p>

        <p>既定値は TRUE です。</p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          Zoom Viewer のコンテキスト メニューが有効かどうかを指定します。このプロパティが FALSE の場合、コンテキスト メニューは表示されません。
        </p>

        <p>既定値は TRUE です。</p>
      </td>
    </tr>

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

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

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

          ,{" "}

          <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">
            読み取り専用
          </a>
        </p>
      </td>

      <td>
        <p>
          Zoom Viewer で利用可能なコマンドへのアクセスを提供します。{" "}

          <a href="/ja/fine-reader/engine/visual-components-reference/zoomviewer/zoom-viewer-commands">
            Zoom Viewer で利用可能なコマンドのリスト
          </a>

          を参照してください。
        </p>
      </td>
    </tr>

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

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

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

      <td>
        <p>Zoom Viewer に接続されたドキュメント ページを表します。</p>
      </td>
    </tr>

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

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

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

      <td>
        <p>Zoom Viewer がロックされているかどうかを指定します。</p>
        <p>このプロパティは、次の状況で有用です：</p>

        <ul>
          <li>
            FineReader Engine API (Visual Components からではない) から分析、認識、合成、またはエクスポート操作が呼び出される場合、または
          </li>

          <li>
            アプリケーションが特定のイベントの通知 (例：

            <strong>
              {" "}

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

              {" "}
            </strong>

            オブジェクトから) を受信し、これらのイベント ハンドラーで Visual Components からの Windows メッセージを処理する場合。
          </li>
        </ul>

        <p>
          この場合、分析、認識、合成、またはエクスポートの前にこのプロパティを TRUE に設定し、操作の終了後に FALSE に設定することをお勧めします。この場合、ドキュメントは Zoom Viewer から変更されることがありません。
        </p>

        <p>既定値は FALSE です。</p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          ドキュメントの既定の処理パラメータを指定します。分析と認識プロセスが Zoom Viewer から直接呼び出された場合に、これらのパラメータが使用されます。
        </p>

        <Note>
          Zoom Viewer が Component Synchronizer に接続されている場合、処理に使用されるパラメータを変更するには、{" "}

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

          {" "}

          プロパティを使用してください。Zoom Viewer のプロパティ経由で処理パラメータを変更すると、エラーが発生する可能性があります。
        </Note>
      </td>
    </tr>

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

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

      <td>
        <p>
          Zoom Viewer の設定ファイルを含むフォルダーのパスを指定します。他の Visual Components も同じプロパティを有します。各 Visual Component は独自の設定フォルダーを使用すべきです。
        </p>

        <p>
          このプロパティの値は、ABBYY FineReader Engine がユーザー固有のデータを格納するフォルダーのパスと、そのサブフォルダーの名前から構成されます。既定では、ユーザー固有のデータのフォルダーは {" "}

          <a href="/ja/fine-reader/engine/distribution/distribution-windows/distribution-kit#finereader_engine_data_folder">
            FineReader Engine データ フォルダー
          </a>

          です。これは FineReader Engine の初期化中に変更できます ({" "}

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

          {" "}

          関数経由、または {" "}

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

          {" "}

          メソッド経由) 。サブフォルダーの既定の名前は任意の GUID です。サブフォルダーの名前を変更するには、新しい名前を指定してください。
          Visual Studio でデザイン時にコンポーネントのプロパティを設定します。実行時にプロパティの値を指定しようとしても、その値は無視されます。
        </p>

        <p>
          Visual Studio でデザイン時にコンポーネントをフォームに追加した場合、プロパティの値はデフォルト値として自動的に設定されるか、カスタム値として手動で設定されます。いずれの場合も、値はデザイン時に設定されます。何らかの理由でデザイン時にプロパティの値が設定されていない場合 (例：実行時にコンポーネントを動的に生成する場合) 、コンポーネントは初期化のたびに設定フォルダーを新規作成します。フォルダーが増え続けるのを防ぐには、コンポーネントの終了処理後に作成された設定フォルダーを削除してください。この場合、使用できるのはコンポーネントのデフォルト設定のみとなり、セッション間で設定を保存することはできません。
        </p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          現在の文字の Rectangle の座標をピクセル単位で格納します。座標はドキュメント画像を基準とした相対値です。
        </p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          現在の文字を黄色の Rectangle でマークするかどうかを指定します。
        </p>

        <p>デフォルト値は TRUE です。</p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          画像のスケールをパーセント単位で指定します。このプロパティは、{" "}

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

          {" "}

          定数のいずれかに設定することもできます。
        </p>

        <p>
          デフォルト値は ST\_PixelToPixel で、画像がピクセル等倍モードで表示されます。
        </p>
      </td>
    </tr>

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

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

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

          ,{" "}

          <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">
            読み取り専用
          </a>
        </p>
      </td>

      <td>
        <p>
          表示されているドキュメント領域の座標をピクセル単位で格納します。座標はドキュメント画像を基準とした相対値です。
        </p>
      </td>
    </tr>

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

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

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

          、読み取り専用
        </p>
      </td>

      <td>
        <p>クライアント領域のウィンドウハンドルを返します。</p>
      </td>
    </tr>
  </tbody>
</table>

<div id="methods">
  ## メソッド
</div>

| Name                                                                                                                      | Description                                                                                                                               |
| ------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| [CenterOnDocumentPoint](/ja/fine-reader/engine/visual-components-reference/zoomviewer/centerondocumentpoint-method)       | 指定した点がビューの中央に表示されるように、ズームビューをスクロールします。                                                                                                    |
| [DocumentToScreen](/ja/fine-reader/engine/visual-components-reference/zoomviewer/documenttoscreen-method)                 | 文書画像上の指定した点の座標を画面座標に変換します。                                                                                                                |
| [GetSelectedBlocksIndices](/ja/fine-reader/engine/visual-components-reference/zoomviewer/getselectedblocksindices-method) | 選択されているブロックのインデックスのコレクションを返します。                                                                                                           |
| [GetSelectedCells](/ja/fine-reader/engine/visual-components-reference/zoomviewer/getselectedcells-method)                 | 指定した表ブロック内で選択されているセルを囲む Rectangle を返します。                                                                                                  |
| [ScreenToDocument](/ja/fine-reader/engine/visual-components-reference/zoomviewer/screentodocument-method)                 | 指定した点の画面座標を文書画像上の座標に変換します。                                                                                                                |
| [SetSelectedBlocksIndices](/ja/fine-reader/engine/visual-components-reference/zoomviewer/setselectedblocksindices-method) | ブロックの選択状態を設定します。                                                                                                                          |
| [SetSelectedCells](/ja/fine-reader/engine/visual-components-reference/zoomviewer/setselectedcells-method)                 | 指定した表ブロックで選択するセルを設定します。                                                                                                                   |
| [ShowDocumentArea](/ja/fine-reader/engine/visual-components-reference/zoomviewer/showdocumentarea-method)                 | 指定した座標の文書領域が表示されるように、ズームビューをスクロールします (可能な範囲で) 。                                                                                           |
| [UpdateOptions](/ja/fine-reader/engine/visual-components-reference/zoomviewer/updateoptions-method)                       | Zoom Viewer の \[Options] ダイアログで指定した設定を更新します。別の Visual Component でオプションが変更された場合は、Zoom Viewer のオプションを現在の状態に更新するために、このメソッドを呼び出す必要があることがあります。 |

<div id="samples">
  ## サンプル
</div>

このコンポーネントは、以下のコードサンプルで使用されています：[VisualComponents](/ja/fine-reader/engine/guided-tour/samples#visualcomponents)。

<div id="see-also">
  ## 関連項目
</div>

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

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

[グラフィカル ユーザー インターフェイスを備えたアプリケーションの作成](/ja/fine-reader/engine/guided-tour/advanced-techniques/using-gui-elements/creating-an-application-with-gui)

[ビジュアル コンポーネントのコンテキスト メニューとツール バーのカスタマイズ](/ja/fine-reader/engine/guided-tour/advanced-techniques/using-gui-elements/customizing-the-context-menu-and-toolbar-of-a-visual-component)