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

# ImageViewer オブジェクト（IImageViewer インターフェイス）

> Windows 上の ABBYY FineReader Engine ビジュアルコンポーネントにおける ImageViewer オブジェクト（IImageViewer インターフェイス）— ImageViewer オブジェクトは、画像およびその画像上のブロックを表示および編集できる ActiveX コントロールです。

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

ImageViewer オブジェクトは ActiveX コントロールで、画像およびその画像上のブロックを表示・編集できます。画像は、FRPage プロパティを介して Image Viewer に関連付けられます。

Image Viewer コンポーネントは次のように表示されます。

<img src="https://mintcdn.com/abbyy/lsETHFYUFiongXSm/images/fine-reader/engine/imageviewer.gif?s=0d5ce6ef4bfe778c2c0b224a73b839e0" alt="ImageViewer" width="529" height="279" data-path="images/fine-reader/engine/imageviewer.gif" />

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

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

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

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

Image Viewer コンポーネントは、[Component Synchronizer](/ja/fine-reader/engine/visual-components-reference/supplementary-objects/componentsynchronizer) コンポーネントに接続できます。この場合、Image 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="allpagesscrollenabled" />

          <strong>AllPagesScrollEnabled</strong>
        </p>
      </td>

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

      <td>
        <p>
          Image Viewer がドキュメントのすべてのページをスクロールするかどうかを指定します。このプロパティが FALSE の場合、Image Viewer は選択したページのみをスクロールします。
        </p>

        <p>デフォルト値は TRUE です。</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>
          Image Viewer の下部ペインが有効かどうかを指定します。このプロパティが FALSE の場合、下部ペインは表示されません。
        </p>

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

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

          <strong>CaptionPaneEnabled</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>
          Image 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>
          Image 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">
            read-only
          </a>
        </p>
      </td>

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

          <a href="/ja/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands">
            Image 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>Image Viewer に接続されているドキュメントページを指定します。</p>
      </td>
    </tr>

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

          <strong>HighlightRecognizedArea</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>
          認識処理中に認識済みフラグメントを画像上でハイライト表示するかどうかを指定します。このプロパティを使用すると、認識の進行状況を確認できます。
        </p>

        <p>デフォルト値は TRUE です。</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>Image Viewer がロックされているかどうかを指定します。</p>
        <p>このプロパティは、次の状況で役立ちます。</p>

        <ul>
          <li>
            解析、認識、合成、またはエクスポート操作が FineReader Engine API から呼び出される場合 (ビジュアルコンポーネントからではなく)
          </li>

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

            <strong>
              {" "}

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

              {" "}
            </strong>

            オブジェクトからの通知) を受け取り、これらのイベントハンドラー内でビジュアルコンポーネントからの Windows メッセージを処理する場合
          </li>
        </ul>

        <p>
          このような場合は、解析、認識、合成、またはエクスポートの実行前にこのプロパティを TRUE に設定し、操作完了後に FALSE に設定することを推奨します。これにより、Image Viewer からドキュメントが破損するのを防ぐことができます。
        </p>

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

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

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

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

          ,{" "}

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

      <td>
        <p>コンテキストメニューの設定へのアクセスを提供します。</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>
          ドキュメントのデフォルト処理パラメーターを指定します。これらのパラメーターは、解析、認識、および合成プロセスが Image Viewer から直接呼び出された場合に使用されます。
        </p>

        <Note>
          Image Viewer が Component Synchronizer に接続されている場合は、{" "}

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

          {" "}

          プロパティを使用して処理パラメーターを変更してください。Image Viewer のプロパティから処理パラメーターを変更すると、エラーが発生する場合があります。
        </Note>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          <strong>Image Editor</strong> ダイアログで選択されたページのインデックスコレクションへのアクセスを提供します。
        </p>
      </td>
    </tr>

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

          <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>
          Image Viewer の設定ファイルが格納されているフォルダーへのパスを指定します。他のビジュアルコンポーネントも同じプロパティを持ちます。各ビジュアルコンポーネントは、それぞれ専用の設定フォルダーを使用してください。
        </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 の初期化時に変更できます。サブフォルダーのデフォルト名は任意の GUID です。サブフォルダー名を変更するには、デザイン時に Visual Studio のコンポーネントのプロパティで新しい名前を指定してください。実行時にプロパティの値を指定しようとしても、その値は無視されます。
        </p>

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

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

          <strong>Title</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>Image Viewer コンポーネントのタイトルを指定します。</p>
        <p>デフォルト値は "Image" です。</p>
      </td>
    </tr>

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

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

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

          ,{" "}

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

      <td>
        <p>ツールバーの設定へのアクセスを提供します。</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\_BestFit で、最適なサイズが自動的に選択されます。
        </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">
            read-only
          </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>

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

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

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

          <strong>ZoomRect</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>
          ズーム領域の矩形座標をピクセル単位で格納します。座標はドキュメント画像を基準とした相対値です。
        </p>
      </td>
    </tr>

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

          <strong>ZoomRectEnabled</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>
          ズーム領域を点線の矩形で画像上にマークするかどうかを指定します。
        </p>

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

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

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

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

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

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

[IImageViewerEvents](/ja/fine-reader/engine/visual-components-reference/iimageviewerevents)

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

[GUI を備えたアプリケーションの作成](/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)

[プロパティの操作](/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)