跳轉到主要內容
視覺元件 僅在 Windows 版 FRE 中實作。
DocumentViewer 物件是一個 ActiveX 控制項,可讓您檢視文件中的頁面清單並監視其狀態。您也可以使用元件提供的命令,儲存已辨識的文件,或在選取的應用程式中將其開啟。文件會透過 FRDocument 屬性連接至此元件。 Document Viewer 元件的外觀會依 Mode 屬性的值而有所不同,如下所示:
  • 詳細資料檢視
提供每個文件頁面的詳細資訊。 DocumentViewer_Details
  • 縮圖檢視
以縮圖顯示文件頁面。 DocumentViewer_Thumbnails 您可以透過元件的屬性修改其外觀。例如,您可以使用 Toolbar 屬性在工具列中新增或移除按鈕,也可以使用 PopupMenu 屬性修改元件的快顯功能表。詳情請參閱Customizing the Context Menu and Toolbar of a Visual Component 與文件監視相關的資訊會透過特殊的輸出介面回報。這些介面包括 IDocumentViewerEvents (適用於 C++) 以及 dispinterface DIDocumentViewerEvents (適用於 Visual Basic) 。 請注意,Visual Basic 使用者無須在意事件介面實作的細節,因為這個開發平台提供了簡便的處理方式。此物件可在 Visual Basic 中宣告為 WithEvents。 對 C++ 使用者而言,這表示它支援 IConnectionPointContainer 介面。若要接收通知事件,C++ 使用者應建立一個衍生自 IDocumentViewerEvents 介面的物件,然後透過標準 COM 機制,在該物件與 DocumentViewer 物件中實作的事件來源之間建立連線。 Document Viewer 元件可連接至 Component Synchronizer 元件。在此情況下,Document Viewer 中的所有事件都會自動傳送至其他連接到 Synchronizer 的元件,整個應用程式也會同步運作。

屬性

指定 Document Viewer 中的作用中頁面。若無作用中頁面,此屬性的值為 0。

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

預設值為 TRUE。

指定 Document Viewer 的右鍵選單是否已啟用。若此屬性為 FALSE,則永遠不顯示右鍵選單。

預設值為 TRUE。

,唯讀的

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

指定連接至 Document Viewer 的文件。

指定 Document Viewer 的語言頁面是否已啟用。若此屬性為 FALSE,則不顯示語言頁面。

預設值為 TRUE。

指定 Document Viewer 是否已鎖定。

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

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

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

預設值為 FALSE。

指定 Document Viewer 的目前模式:詳細資料檢視或縮圖檢視。

預設模式為 DVM_Thumbnails。

,唯讀的

提供對右鍵選單設定的存取。

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

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

指定 Document Viewer 元件的標題。

預設值為 “Pages”。

,read-only

提供工具列設定的存取權限。

提供已選取頁面之索引集合的存取權限。

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

此屬性的值由兩部分組成:ABBYY FineReader Engine 儲存使用者特定資料的資料夾路徑,以及其子資料夾名稱。預設情況下,包含使用者特定資料的資料夾為FineReader Engine data folder。可在初始化 FineReader Engine 期間變更 (透過函式,或透過方法) 。子資料夾的預設名稱為隨機產生的 GUID。若要變更子資料夾名稱,請在設計階段於 Visual Studio 的元件屬性中指定新名稱。若嘗試在執行階段指定屬性值,該值將被忽略。

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

,唯讀的

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

方法

名稱說明
UpdateOptions更新 Document Viewer「選項」對話方塊中指定的設定。如果選項已在其他 視覺元件 中變更,您可能需要呼叫此方法,才能將 Document Viewer 的選項更新為目前狀態。

範例

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

另請參閱

IDocumentViewerEvents IComponentSynchronizer::DocumentViewer 建立具有圖形化使用者介面的應用程式 自訂視覺元件的快顯功能表與工具列