ITextRange：：SetChar 方法 (tom.h)

  • 發行項

設定範圍起始位置的字元。

語法

HRESULT SetChar(
  long Char
);

參數

Char

類型： long

起始位置字元的新值。

傳回值

類型： HRESULT

方法會傳回 HRESULT 值。 如果方法成功，它會 傳回S_OK。 如果方法失敗，它會傳回下列其中一個錯誤碼。 如需 COM 錯誤碼的詳細資訊，請參閱 COM 中的錯誤處理。

傳回碼 Description
E_ACCESSDENIED
 文字受到寫入保護。
E_OUTOFMEMORY
 記憶體不足。

備註

ITextRange：：SetChar 可讓您指定要使用的精確字元碼。 不過，具有類似圖像的字串常值可能會產生誤導。

這個方法所設定的字元是 LONG ，而不是 BSTR。 這會隱藏儲存在備份儲存區的方式， (為位元組、單字、可變長度等) 。

通常，在沒有自動自動換行的系統上，檔會只插入換行符的硬式歸位字元。 下列程式代碼顯示簡單但不是完美的方法，可將這類硬式歸位字元轉換回與範圍 r 相關聯之本文的空白。

    Sub EnableWrap(r As ITextRange)   // Convert false hard CRs to soft
        r.SetRange 0, 0               // r is set at start of story
        While r.Move(tomParagraph)    // Go to start of next paragraph
            If r.MoveWhile(C1_WHITE, 1) = 0 Then    // Next char isn't white space
                r.Move tomCharacter, -1
                r.SetChar = Asc(" ")    // Replace CR by blank
            End If
        Wend        // Loop till no more CRs in story
    End Sub

或者，您可以在 IF 循環內使用下列專案。

r.MoveStart tomCharacter, -1        // Select previous char (the CR)
r = " "        // Replace it with a blank

此方法可讓您將文字換行至其他寬度。 不過，演算法不是完美的：它會假設後面接著空格符的硬式歸位字元，後面接著空格符 (空白、製表符、換行字元、歸位字元等) 應以空白取代。 演算法也假設歸位字元是單一字元，例如歸位字元或 Unicode 段落結尾 (EOP) 0x2029 字元。 而且，組合歸位字元和換行字元不相符，而且需要撰寫和執行更多程式碼 (或使用 FindText(^p)) 。 另一個警告是有其他情況，例如混合程式代碼和檔，其中演算法無法正常運作。

不過， ITextRange：：SetChar 比由刪除完成的取代作業更有效率，後面接著插入。 因此，在不使用 ITextRange：：SetChar 的情況下重寫程式代碼可能會比較慢。

Char 屬性可以執行字元集合所能執行的大部分工作，有兩大優點：它可以參考父本文中的任何字元，而不是受限於父範圍，而且會大幅加快速度，因為 LONG而不是涉及範圍物件。 由於這些優點，TEXT 物件模型 (TOM) 不支援字元集合。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 tom.h
Dll Msftedit.dll

另請參閱

概念

ITextRange

參考

文字物件模型