跳轉到主要內容
視覺元件是以適用於 Windows 的 FRE 實作。
TextValidator 物件是一個 ActiveX 控制項,可讓您驗證文件中辨識結果不確定的字元。文件會透過 FRDocument 屬性連接至此元件。 Text Validator 元件可能如下所示: TextValidator 對於採用垂直書寫方向的文字:
TextValidator_CJK
若要開始拼字檢查,您應呼叫 TextValidator 物件的 SpellSpellBlock 方法。如果拼字檢查已在進行中,您必須先將其停止,否則對這些方法的新呼叫將會被忽略。
  • 您也可以使用 Text Editor 中的 Check Spelling 按鈕來開始拼字檢查。
  • 複雜文字語言 (例如中文、泰文、亞美尼亞文) 的某些字元可能無法在 Text Validator 中顯示,原因是 Text Validator 所使用的字型未包含對應字元。在此情況下,您可以在 Options 對話方塊中指定其他字型 (在 Text Validator 中按一下 Settings > Options,移至 View 索引標籤,然後在 Font used to display plain text 下拉式清單中選取字型) 。
有關拼字檢查的資訊會透過特殊的輸出介面回報。這些介面為 ITextValidatorEvents (適用於 C++) 以及 dispinterface DITextValidatorEvents (適用於 Visual Basic) 。 值得注意的是,Visual Basic 使用者無須在意事件介面實作的細節,因為此開發平台提供了簡便的處理方式。此物件可在 Visual Basic 中宣告為 WithEvents。 對 C++ 使用者而言,這表示它支援 IConnectionPointContainer 介面。若要接收通知事件,C++ 使用者應建立一個衍生自 ITextValidatorEvents 介面的物件,然後透過標準 COM 方法,在該物件與 TextValidator 物件中實作的事件來源之間建立連線。 Text Validator 元件可連接到 Component Synchronizer 元件;在此情況下,Text Validator 中的所有事件都會自動傳送至其他連接到 Synchronizer 的元件,整個應用程式也會同步運作。

屬性

,唯讀

代表使用者在拼字檢查期間新增至字典的單字集合。

若在拼字檢查期間將單字新增至字典,使用者字典將建立於下列屬性所指定的資料夾中:ILanguageDatabase::DictionaryExtensionsPathproperty.

代表單字配對的集合。配對中的第一個單字是拼字檢查期間自動被取代的來源單字,第二個則是替換詞。

指定 Text Validator 是否應在拼字檢查期間修正空格。若將此屬性的值設為 TRUE,Text Validator 將修正標點符號前後的空格。

預設值為 FALSE。

代表拼字檢查期間應略過的單字集合。

, 唯讀

指定拼字檢查是否正在進行中。

代表與 Text Validator 連接的文件。

指定 Text Validator 是否已鎖定。

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

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

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

預設值為 FALSE。

代表單字配對的集合。配對中的第一個單字是拼字檢查期間被取代的來源單字,第二個則是替換詞。

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

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

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

指定 Text Validator 在拼字檢查期間是否應於複合詞處停止。

預設值為 FALSE。

指定 Text Validator 在拼字檢查期間是否應於亂碼處停止。亂碼是指無意義的字元組合。

預設值為 FALSE。

指定 Text Validator 在拼字檢查期間是否應於字典中找不到的詞語處停止。此屬性與 StopAtUncertain 屬性不能同時設為 FALSE。

預設值為 TRUE。

指定 Text Validator 在拼字檢查期間是否應於辨識結果不確定的字元處停止。此屬性與 StopAtNonDictionary 屬性不能同時設為 FALSE。

預設值為 TRUE。

,唯讀的

代表在拼字檢查期間,為修正辨識結果不確定之詞語的拼字所建議的詞語集合。

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

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

,唯讀的

代表辨識結果不確定之字元或詞語的位置。

,唯讀的

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

方法

名稱說明
EndSpelling停止拼字檢查。
Spell從指定位置開始進行拼字檢查。
SpellBlock檢查指定區塊中的拼字。
UpdateOptions更新 Text Validator 的 Options 對話方塊中指定的設定。如果選項已在其他 視覺元件 中變更,您可能需要呼叫此方法,將選項更新為目前狀態。

範例

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

另請參閱

ITextValidatorEvents IComponentSynchronizer::TextValidator 建立圖形使用者介面應用程式