跳轉到主要內容
Visual Components 在 Windows 版 FRE 中實作。
ZoomViewer 物件是一個 ActiveX 控制項,可讓您檢視目前正在編輯的行或已處理影像區域的放大影像。Image Viewer 顯示整體頁面檢視,而 Zoom Viewer 則提供便捷的方式,讓您更詳細地檢視影像、調整區域位置,或將不確定的字元與放大影像進行比對。影像透過 FRPage 屬性連接至 Zoom Viewer。 Zoom Viewer 元件外觀如下: ZoomViewer 您可以透過元件的屬性修改其外觀。例如,您可以透過 Commands 屬性修改元件的快顯功能表。詳情請參閱自訂 Visual Component 的快顯功能表與工具列 檢視影像的相關資訊會透過特殊的傳出介面回報。這些介面分別為 IZoomViewerEvents (適用於 C++) 以及分派介面 DIZoomViewerEvents (適用於 Visual Basic) 。 值得注意的是,Visual Basic 使用者無需關注事件介面實作的細節,因為該開發平台已提供簡便的事件處理機制。此物件可在 Visual Basic 中以 WithEvents 宣告。 對於 C++ 使用者而言,這表示它支援 IConnectionPointContainer 介面。若要接收通知事件,C++ 使用者需建立一個衍生自 IZoomViewerEvents 介面的物件,再透過標準 COM 方式,在該物件與 ZoomViewer 物件中實作的事件來源之間建立連接。 Zoom Viewer 元件可連接至 Component Synchronizer 元件。連接後,Zoom Viewer 中的所有事件將自動傳送至連接至 Synchronizer 的其他元件,整個應用程式將同步運作。

屬性

指定用於區塊和影像編輯的使用中工具。

指定是否啟用 Zoom Viewer 的底部窗格。若此屬性為 FALSE,則不顯示底部窗格。

預設值為 TRUE。

指定是否啟用 Zoom Viewer 的快顯功能表。若此屬性為 FALSE,則一律不顯示快顯功能表。

預設值為 TRUE。

,read-only

提供對 Zoom Viewer 中可用命令的存取。請參閱Zoom Viewer 中可用命令的清單

代表連接至 Zoom Viewer 的文件頁面。

指定 Zoom Viewer 是否已鎖定。

此屬性在下列情況下非常有用:

  • 從 FineReader Engine API (而非從 Visual Components) 呼叫分析、識別、synthesis 或匯出作業,或
  • 您的應用程式收到特定事件的通知 (例如,來自物件) ,並在這些事件處理常式中處理來自 Visual Components 的 Windows 訊息。

在此情況下,建議您在分析、識別、synthesis 或匯出之前將此屬性設為 TRUE,並在作業結束後將其設為 FALSE。如此一來,文件便不會從 Zoom Viewer 遭到損毀。

預設值為 FALSE。

指定文件的預設處理參數。若分析和識別程序直接從 Zoom Viewer 呼叫,則會使用這些參數。

若 Zoom Viewer 已連接至 Component Synchronizer,請使用IComponentSynchronizer::ProcessingParams屬性來變更用於處理的參數。若透過 Zoom Viewer 的屬性變更處理參數,可能會發生錯誤。

指定包含 Zoom Viewer 設定檔案之資料夾的路徑。其他 Visual Components 也具有相同的屬性。每個 Visual Component 應使用各自專屬的設定資料夾。

此屬性的值由 ABBYY FineReader Engine 儲存使用者特定資料的資料夾路徑及其子資料夾名稱所組成。預設情況下,包含使用者特定資料的資料夾為FineReader Engine 資料資料夾。可在初始化 FineReader Engine 期間變更此設定 (透過函式,或透過方法) 。子資料夾的預設名稱為任意 GUID。若要變更子資料夾的名稱,您應在 元件在 Visual Studio 設計階段的屬性。若您嘗試在執行階段指定屬性值,該值將被忽略。

若您在設計時將元件加入 Visual Studio 的表單中,屬性值將以預設值自動定義,或以自訂值手動定義。兩種情況下,值均在設計階段確定。若因某些原因屬性值未在設計階段定義 (例如,在執行階段動態產生元件) ,則元件每次初始化時都會建立一個新的設定資料夾。為避免資料夾持續增加,您應在元件反初始化後刪除所建立的設定資料夾。在此情況下,您只能使用元件的預設設定,且無法在工作階段之間儲存設定。

儲存目前字元矩形的像素座標。座標相對於文件影像。

指定目前字元是否應以黃色矩形標記。

預設值為 TRUE。

以百分比指定影像的縮放比例。此屬性也可設定為常數之一。

預設值為 ST_PixelToPixel,表示影像以像素對像素模式顯示。

,唯讀

儲存可見文件區域的像素座標。座標相對於文件影像。

,唯讀

回傳客戶端區域的視窗 handle。

方法

名稱描述
CenterOnDocumentPoint捲動縮放檢視,使指定的點置於檢視中央。
DocumentToScreen將文件影像上指定點的座標轉換為 screen coordinates。
GetSelectedBlocksIndices回傳已選取區塊的索引集合。
GetSelectedCells回傳指定 table block 中已選取儲存格的 surrounding rectangle。
ScreenToDocument將指定點的 screen coordinates 轉換為文件影像上的座標。
SetSelectedBlocksIndices設定區塊的選取狀態。
SetSelectedCells設定指定 table block 中的已選取儲存格。
ShowDocumentArea捲動縮放檢視,使具有指定座標的 document area 盡可能顯示於可見範圍內。
UpdateOptions更新 Zoom Viewer 的 Options dialog box 中所指定的設定。若已在其他 Visual Component 中變更了選項,您可能需要呼叫此方法,以將 Zoom Viewer 的選項更新至目前狀態。

範例

此元件會在下列程式碼範例中使用:VisualComponents

另請參閱

IZoomViewerEvents IComponentSynchronizer::ZoomViewer 建立含圖形使用者介面的應用程式 自訂 Visual Component 的快顯功能表與工具列