CharParams 物件 (ICharParams 介面)

此物件可讓您存取已辨識文字中單一字元的各種參數：包括其格式設定、在影像上的 Rectangle、識別語言，以及識別的 hypotheses。此型別新建物件的所有布林屬性均設為 FALSE。

若您希望使用已辨識文字中特定字元的參數，必須先呼叫任何執行 synthesis 的函式 (例如 FRDocument 物件的 Process 或 Synthesize 方法) ，因為這些參數僅在 synthesis 完成後才具有實際意義。

若字元取自名片的文字內容，則該物件僅會設定下列屬性：

BaseLine
Bottom
Left
Right
Top
IsSuspicious
ErrorProbability
CharacterRegion
CharacterRecognitionVariantIndex
CharacterRecognitionVariants
SelectedCharacterRecognitionVariant
WordRecognitionVariants
IsFromSourceContent
IsWordFirst
IsWordLeftmost

屬性


	,唯讀	回傳 Engine 物件。

		指定字元的語言 ID。若要將其轉換為 Win32 LCID，請使用方法。預設情況下，此屬性會以系統預設語言 ID 初始化。
		儲存字元的語言內部名稱，並允許您加以設定。若一個基礎識別語言對應一個已識別單字，則識別完成後，該單字中每個字元的 LanguageName 屬性將設為基礎語言的內部名稱。若多個基礎識別語言對應同一個單字 (例如雙語複合詞) ，則該單字中各字元的 LanguageName 屬性為空。而 LanguageId 屬性無論已識別單字為何，均包含基礎語言的識別碼。預設情況下，此屬性的值為空字串。

		指定字元的精確 Region。該 Region 不一定為矩形，初始時包含於由 Left、Top、Right 及 Bottom 屬性所定義的矩形內。若您變更字元的精確 Region，Left、Top、Right 及 Bottom 屬性不會隨之變更。此屬性僅在將屬性設為 TRUE 後執行識別時才可使用。此屬性回傳一個常數物件。若要變更字元的精確 Region，必須先使用IEngine::CreateRegion方法取得一個中間 Region 物件，修改所需的參數，再將取得的物件指派給此屬性。
	, 唯讀	儲存字元矩形底部邊界的座標。此矩形定義於影像上，不考慮文字方向。其值可能未定義，此時四個座標均為零。此屬性無法直接變更，須透過 SetRect 方法修改。此屬性的預設值為 0。
	, 唯讀	儲存字元矩形左側邊界的座標。此矩形定義於影像上，不考慮文字方向。其值可能未定義，此時四個座標均為零。此屬性無法直接變更，須透過 SetRect 方法修改。此屬性的預設值為 0。
	, 唯讀	儲存字元矩形右側邊界的座標。此矩形定義於影像上，不考慮文字方向。其值可能未定義，此時四個座標均為零。此屬性無法直接變更，須透過 SetRect 方法修改。 The default value of this property is 0.
	, read-only	Stores the coordinate of the top border of the character rectangle. This rectangle is defined on image, not accounting for the text orientation. It may be undefined, in which case all four of its coordinate are zeros. This property cannot be changed directly but through the SetRect method. The default value of this property is 0.

		Specifies whether the character is the leftmost character in a word. In complicated situations (such as two words not separated by a space or one word containing a punctuation mark without the spaces) this property may not work correctly. The recognizer may change the hypothesis about the number of words after the flags for characters were set. This property is set during synthesis. If the property is called before the synthesis is completed it is FALSE by default. ForChinese, Japanese, or Koreanthis property is unreliable, as the words are not detected.
		Specifies whether the character is the first character in a word. This property is set during synthesis. If the property is called before the synthesis is completed it is FALSE by default. Notes: For languages with right-to-left writing direction (e.g., Hebrew), this property will indicate the rightmost character in the word. ForChinese, Japanese, or Koreanthis property is unreliable, as the words are not detected.
		Sets the shift of a character from the base line of the string in pixels. The base line of the string is defined by theproperty. This property is mainly used for the pictures embedded in text. By default, the value of this property is 0.
		Specifies additional spacing between characters in twips. Twip is 1/20 of point, and point is 1/72”. Default value of this property is 0.
		Stores horizontal scaling for a character in 1/1000. If the character is obtained from the text of a business card, this property has default value. Default for this property is 1000, which corresponds to no scaling.

		設定符號的 RGB 色彩值。整個段落的背景顏色由屬性定義。此屬性的值可以為 -1，表示顏色為透明。 int 值由 RGB 三元組依下列公式計算： (紅色值) + (256 × 綠色值) + (65536 × 藍色值) ，其中紅色值為第一個三元組分量，綠色值為第二個三元組分量，藍色值為第三個三元組分量。例如，白色的 int 值為 16777215。預設情況下，文字顏色為黑色，即 RGB(0,0,0)。
		指定字元是否為粗體。若字元取自名片文字，此屬性將使用預設值。此屬性預設為 FALSE。
		指定字元是否為斜體。若字元取自名片文字，此屬性將使用預設值。此屬性預設為 FALSE。
		指定字元是否有底線。此屬性預設為 FALSE。
		指定字元是否有刪除線。若字元取自名片文字，此屬性將使用預設值。此屬性預設為 FALSE。
		指定字元是否為下標。此屬性不可與 IsSuperscript 屬性同時設為 TRUE，否則在匯出已辨識文字時將產生錯誤。若字元取自名片文字，此屬性將使用預設值。此屬性預設為 FALSE。
		指定字元是否為上標。此屬性不可與 IsSubscript 屬性同時設為 TRUE，否則在匯出已辨識文字時將產生錯誤。若字元取自名片文字，此屬性將使用預設值。此屬性預設為 FALSE。
		指定字元是否套用「小型大寫字母」樣式。套用此樣式後，小寫字元將以小型大寫字母顯示。此屬性預設為 FALSE。

	, read-only	儲存字元的字型名稱。此屬性無法直接變更，須透過 SetFont 方法修改。此值預設為「Times New Roman」。
		指定字元字型的高度，單位為 twip。1 twip 等於 1/20 點，1 點等於 1/72 英寸。此屬性的預設值為 10 點 (即 200 twip) 。
		提供字元字型樣式的存取。
	, read-only	儲存字元的字型型別。此屬性無法直接變更，而須透過 SetFont 方法進行變更。預設情況下，此值為 FT_Unknown。

		若字元的識別結果不可靠，則回傳 TRUE。使用此屬性可判斷是否需要進行驗證。此屬性根據 ErrorProbability 值及識別設定計算得出。若需要針對驗證實作更精細的區分，請改用 ErrorProbability。此屬性預設為 FALSE。
	，唯讀的	回傳字元識別錯誤的估計機率 (範圍為 0 至 100) 。錯誤機率會考量整體上下文，因此僅適用於識別結果，而非每個字元識別變體。若要比較各識別變體，請使用。對於未經識別而取得的符號 (例如直接從來源 PDF 檔案中擷取的符號) ，不會計算錯誤機率。
	,read-only	回傳字元識別變體的集合。對於不可列印字元 (空格、換行符號等) 以及未經識別但在明確編輯過程中加入文字的字元，此屬性包含零值。若文字是由舊版 ABBYY FineReader Engine 識別，也會回傳零值。若屬性設為 FALSE，則回傳的集合包含一個元素；否則，集合至少包含一個元素，且變體依從最佳到最差的順序排列。
	, read-only	儲存所選字元識別變體在 CharacterRecognitionVariants 集合中的索引。
	,read-only	儲存所選的字元識別變體，即字元識別變體集合 (CharacterRecognitionVariants 屬性) 中索引為 CharacterRecognitionVariantIndex 的元素。
	,read-only	回傳該字元所屬單字的識別變體集合。對於不可列印字元 (空格、換行符號等) 以及未經識別但在明確編輯過程中加入文字的字元，此屬性包含零值。若文字是由舊版 ABBYY FineReader Engine 識別，也會回傳零值。若屬性設為 FALSE，則回傳的集合包含一個元素；否則，集合至少包含一個元素，且變體依內部估算機制從最佳到最差的順序排列。
	, read-only	指定字元是否在未經識別的情況下直接從輸入檔案的文字內容中擷取。例如，可從含有文字層的 PDF 檔案中擷取。
		指定是否已對此字元執行拼字檢查。 ABBYY FineReader Engine 不會在內部使用或設定此屬性，僅提供拼字功能的架構供您使用。

方法

名稱	描述
CopyFrom	使用另一個物件的相似屬性值，初始化目前物件的屬性。
SetFont	為該 symbol 設定新的字型。
SetRect	為該 symbol 設定新的 Rectangle。

物件圖

輸出參數

此物件是以下方法的輸出參數：

Engine 物件的 CreateCharParams 方法
Paragraph 物件的 GetDropCapCharParams 方法
BusinessCardField 物件的 GetCharParams 方法
BusinessCardFieldComponent 物件的 GetCharParams 方法
MrzField 物件的 GetCharParams 方法

輸入參數

此物件作為輸入參數傳遞至以下方法：

Paragraph 物件的 GetCharParams、SetCharParams、Insert、InsertParagraphBreak 方法
WordRecognitionVariant 物件的 GetCharParams 方法
MrzField 物件的 Insert 方法

範例

C# 程式碼

int suspiciousCharsCount = 0;
// 計算文字 Block 中可疑字元的數量
void computeStatisticsForBlock(FREngine.IBlock block)
{
 if (block.Type == FREngine.BlockTypeEnum.BT_Text)
 {
  FREngine.ITextBlock textBlock = block.GetAsTextBlock();
  int paragraphsCount = textBlock.Text.Paragraphs.Count;
  for (int iPar = 0; iPar < paragraphsCount; iPar++)
  {
   FREngine.IParagraph par = textBlock.Text.Paragraphs[iPar];
   string text = par.Text;
   FREngine.ICharParams charParams = engine.CreateCharParams();
   for (int iChar = 0; iChar < text.Length; iChar++)
   {
    par.GetCharParams(iChar, charParams);
    if (charParams.IsSuspicious)
    {
     suspiciousCharsCount++;
    }
   }
  }
 }
}

此物件用於以下程式碼範例：RecognizedTextProcessing (Win) ；以及 Windows 示範工具：Engine Predefined Processing Profiles。

另請參閱

Paragraph CharConfidence、ErrorProbability 與 IsSuspicious 之間有何差異？使用 Text 使用屬性

總覽

函數

Engine 物件（IEngine 介面）

Engine 載入器

影像相關物件

Layout 相關物件

語言相關物件

文字相關物件

文件相關物件

批次處理器

機制相關物件

Parameter 物件

分類相關物件

授權相關物件

文件比較相關物件

補充物件與方法

列舉

CharParams 物件 (ICharParams 介面)

屬性

方法

輸出參數

輸入參數

範例

另請參閱

總覽

函數

Engine 物件（IEngine 介面）

Engine 載入器

影像相關物件

Layout 相關物件

語言相關物件

文字相關物件

文件相關物件

批次處理器

機制相關物件

Parameter 物件

分類相關物件

授權相關物件

文件比較相關物件

補充物件與方法

列舉

​屬性

​方法

​相關物件

​輸出參數

​輸入參數

​範例

​另請參閱

屬性

方法

相關物件

輸出參數

輸入參數

範例

另請參閱