跳轉到主要內容
Visual Components 在 Windows 版 FRE 中實作。
ImageViewer 物件是一個 ActiveX 控制項,可讓您檢視及編輯影像,以及該影像上的區塊。影像會透過 FRPage 屬性連接至 Image Viewer。 Image Viewer 元件如下所示: ImageViewer 您可以透過其屬性修改元件的外觀。例如,您可以透過 Toolbar 屬性在工具列中新增按鈕或移除按鈕,也可以透過 PopupMenu 屬性修改元件的快顯功能表。詳情請參閱自訂 Visual Component 的快顯功能表和工具列 關於影像檢視和編輯的資訊會透過專用的輸出介面提供。這些介面包括 IImageViewerEvents (適用於 C++) 以及 dispinterface DIImageViewerEvents (適用於 Visual Basic) 。 值得注意的是,Visual Basic 使用者無需在意事件介面實作的細節,因為此開發平台提供了簡便的處理方式。此物件可在 Visual Basic 中宣告為 WithEvents。 對 C++ 使用者而言,這表示它支援 IConnectionPointContainer 介面。若要接收通知事件,C++ 使用者應建立一個衍生自 IImageViewerEvents 介面的物件,然後透過標準 COM 方法,在該物件與由 ImageViewer 物件實作的事件來源之間建立連線。 Image Viewer 元件可以連接到 Component Synchronizer 元件;在此情況下,Image Viewer 中的所有事件都會自動傳送到其他連接至 Synchronizer 的元件,整個應用程式也會同步運作。

屬性

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

指定 Image Viewer 是否應捲動顯示文件的所有頁面。若此屬性為 FALSE,Image Viewer 僅捲動顯示所選頁面。

預設值為 TRUE。

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

預設值為 TRUE。

指定 Image Viewer 的標題窗格是否已啟用。若此屬性為 FALSE,則不顯示標題窗格。

預設值為 TRUE。

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

預設值為 TRUE。

,唯讀

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

指定連接至 Image Viewer 的文件頁面。

指定在辨識過程中是否應在影像上醒目標示已辨識的片段。此屬性可讓您追蹤辨識進度。

預設值為 TRUE。

指定 Image Viewer 是否已鎖定。

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

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

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

預設值為 FALSE。

,read-only

提供對快顯功能表設定的存取。

指定文件的預設處理參數。若分析、辨識及合成程序直接從 Image Viewer 呼叫,則會使用這些參數。

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

提供對 Image Editor 對話方塊中所選頁面索引集合的存取。

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

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

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

指定 Image Viewer 元件的標題。

預設值為 “Image”。

,read-only

提供對工具列設定的存取。

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

預設值為 ST_BestFit,表示自動選取最佳縮放比例。

,read-only

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

, read-only

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

以像素為單位儲存縮放區域矩形的座標。座標相對於文件影像。

指定是否應在影像上以虛線矩形標記縮放區域。

預設值為 TRUE。

方法

名稱說明
CenterOnDocumentPoint捲動影像檢視,讓指定點顯示在檢視中央。
DocumentToScreen將文件影像上指定點的座標轉換為螢幕座標。
GetSelectedBlocksIndices回傳已選取區塊的索引集合。
GetSelectedCells回傳指定表格區塊中已選取儲存格的外接矩形。
Print列印影像。
ScreenToDocument將指定點的螢幕座標轉換為文件影像上的座標。
SetSelectedBlocksIndices設定區塊的選取內容。
SetSelectedCells設定指定表格區塊中選取的儲存格。
ShowDocumentArea捲動影像檢視,讓具有指定座標的文件區域顯示出來 (在可行範圍內) 。
UpdateOptions更新 Image Viewer 的 Options dialog box 中指定的設定。如果選項已在其他 Visual Component 中變更,您可能需要呼叫此方法,將 Image Viewer 的選項更新為目前狀態。

範例

此元件用於下列程式碼範例:VisualComponents

另請參閱

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