跳轉到主要內容
Visual Components 是在 Windows 版 FRE 中實作的。
TextEditor 物件是一個 ActiveX 控制項,可讓您檢視並編輯文件頁面上的辨識文字。頁面會透過 FRPage 屬性與該元件連結。 Text Editor 元件外觀如下: TextEditor 您可以透過其屬性修改元件的外觀。例如,您可以透過 Toolbar 屬性在工具列中新增或移除按鈕,或者透過 Commands 屬性修改元件的快顯功能表。詳情請參閱 自訂視覺元件的快顯功能表和工具列 有關編輯辨識文字的資訊會透過特殊的傳出介面回報。這些介面為 ITextEditorEvents (適用於 C++) 以及 dispinterface DITextEditorEvents (適用於 Visual Basic) 。 值得注意的是,Visual Basic 使用者不必理會事件介面實作的細節,因為此開發平台提供了簡便的處理方式。此物件可在 Visual Basic 中宣告為 WithEvents。 對 C++ 使用者而言,這表示該物件支援 IConnectionPointContainer 介面。若要接收通知事件,C++ 使用者應建立一個衍生自 ITextEditorEvents 介面的物件,然後透過標準 COM 機制,在該物件與 TextEditor 物件中實作的事件來源之間建立連線。 Text Editor 元件可連接到 Component Synchronizer 元件;在這種情況下,Text Editor 中的所有事件都會自動傳送至其他連接到 Synchronizer 的元件,整個應用程式將同步運作。

屬性

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

預設值為 TRUE。

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

預設值為 TRUE。

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

預設值為 TRUE。

,唯讀的

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

指定游標在頁面上的位置。

代表連接至 Text Editor 的文件頁面。

指定是否應在 Text Editor 中保留文字和背景顏色。

此屬性的預設值為 TRUE。

指定 Text Editor 是否已鎖定。

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

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

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

預設值為 FALSE。

指定其中一種文件檢視模式。

預設值為 TEM_ExactCopy。

,唯讀的

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

指定包含 Text Editor 設定檔案之資料夾的路徑。其他視覺元件具有相同的屬性。每個視覺元件應使用各自獨立的設定資料夾。

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

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

指定是否在 Text Editor 中顯示圖片。

預設情況下,此屬性的值為 TRUE。

指定是否在 Text Editor 中顯示頁首/頁尾標題。

預設情況下,此屬性的值為 TRUE。

指定文件的預設合成參數。若 Text Editor 需要執行文件合成,將使用這些參數 (當文件的邏輯結構因某些編輯操作而變得不正確時,即可能觸發此情況) 。

若 Text Editor 已連接至 Component Synchronizer,請使用IComponentSynchronizer::ProcessingParams屬性來變更文件合成所用的參數。若透過 Text Editor 的屬性變更這些參數,可能會發生錯誤。

,read-only

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

指定 Text Editor 元件的標題。

預設值為 “Text”。

,read-only

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

以百分比指定文字頁面的縮放比例。此屬性也可設定為常數之一。

預設值為 ST_BestFit,表示系統將自動選擇最佳配適方式。

,唯讀的

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

,唯讀的

傳回用戶端區域的視窗控制代碼。

方法

名稱描述
ActivateOn啟用指定區塊中的指定位置,並將其移至可視範圍內。
CenterOnDocumentPoint捲動文字視圖,讓文件上的指定點位於視圖中央。
DocumentToScreen將文件影像上指定點的座標轉換為螢幕座標。
GetSelection傳回選取範圍的起始與結束游標位置。
Print列印辨識文字。
SetSelection在頁面上設定文字選取範圍。
ScreenToDocument將指定點的螢幕座標轉換為文件影像上的座標。
ShowBlock將指定區塊移至可視範圍內 (在可能的情況下) 。只有在 Text Editor 使用 TEM_ExactCopy 模式時,此方法才有意義。
ShowDocumentArea捲動文字視圖,讓具有指定座標的文件區域顯示在可視範圍內 (在可能的情況下) 。
UpdateOptions更新 Text Editor 的 Options 對話方塊中指定的設定。如果選項已在其他 Visual Component 中變更,您可能需要呼叫此方法,才能將 Text Editor 的選項更新為目前狀態。

範例

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

另請參閱

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