(msctf.h) ITfRange 介面

發行項
08/24/2023

ITfRange介面是由文字服務和應用程式用來參考及操作指定內容內的文字。介面識別碼IID_ITfRange。

繼承

ITfRange介面繼承自IUnknown介面。 ITfRange 也有下列類型的成員：

方法

ITfRange介面具有這些方法。


ITfRange：：AdjustForInsert ITfRange：：AdjustForInsert 方法會展開或合約一系列文字，以調整文字插入。
ITfRange：：Clone ITfRange：：Clone 方法會複製此文字範圍。
ITfRange：：Collapse ITfRange：：Collapse 方法會將其開始錨點和結束錨點移至相同的位置，以清除文字範圍。
ITfRange：：CompareEnd ITfRange：：CompareEnd 方法會將這個範圍的文字結束錨點位置與另一個範圍內的錨點進行比較。
ITfRange：：CompareStart ITfRange：：CompareStart 方法會將此文字範圍的開始錨點位置與另一個範圍內的錨點進行比較。
ITfRange：：GetCoNtext ITfRange：：GetCoNtext 方法
ITfRange：：GetEmbedded ITfRange：：GetEmbedded 方法會取得對應至文字資料流程中TS_CHAR_EMBEDDED字元的內容。文字範圍的開始錨點位於感興趣的字元之前。
ITfRange：：GetFormattedText ITfRange：：GetFormattedText 方法會取得包含在文字範圍內的格式化內容。內容會封裝在支援 IDataObject 介面的物件中。
ITfRange：：GetGravity ITfRange：：GetGravity 方法
ITfRange：：GetText ITfRange：：GetText 方法會取得此文字範圍涵蓋的內容。
ITfRange：：InsertEmbedded ITfRange：：InsertEmbedded 方法會在文字範圍的起始錨點位置插入物件。
ITfRange：：IsEmpty ITfRange：：IsEmpty 方法會驗證文字範圍是空的，因為開始和結束錨點佔用相同的位置。
ITfRange：：IsEqualEnd ITfRange：：IsEqualStart 方法會確認此範圍文字的結尾錨點符合另一個指定範圍的錨點。
ITfRange：：IsEqualStart ITfRange：：IsEqualStart 方法會確認此範圍的開始錨點符合另一個指定範圍的錨點。
ITfRange：：SetGravity ITfRange：：SetGravity 方法
ITfRange：：SetText ITfRange：：SetText 方法會取代文字範圍所涵蓋的內容。
ITfRange：：ShiftEnd ITfRange：：ShiftEnd 方法
ITfRange：：ShiftEndRegion ITfRange：：ShiftEndRegion 方法
ITfRange：：ShiftEndToRange ITfRange：：ShiftEndToRange 方法
ITfRange：：ShiftStart ITfRange：：ShiftStart 方法
ITfRange：：ShiftStartRegion ITfRange：：ShiftStartRegion 方法
ITfRange：：ShiftStartToRange ITfRange：：ShiftStartToRange 方法

備註

TSF 管理員會實作此介面。如需 TSF 所使用的範圍、錨點、内嵌物件和其他文字屬性的詳細資訊，請參閱使用文字服務架構中的範圍、内嵌物件和其他主題。

範例

一旦具現化ITfComposition組合物件，就可以呼叫ITfComposition：：GetRange方法來取得ITfRange介面指標的指標，如下列程式碼範例所示。


HRESULT         hr;
ITfComposition  *pComposition;
ITfRange        *pRange;
WCHAR           *achBuffer[64];  // Buffer to receive text. 
ULONG           cch;

hr = pComposition->GetRange(&pRange);
if(SUCCEEDED(hr))
{
    // Loop to scan text: 

    do
    {
        cch = ARRAYSIZE(achBuffer);
        hr = pRange->GetText(ec, TF_TF_MOVESTART | TF_TF_IGNOREEND, achBuffer, cch, &cch);
        if(SUCCEEDED(hr))
        {
            // Do something with the text. 

            pRange->Release();
        }
    }
    while (cch == ARRAYSIZE(achBuffer));

    pComposition->Release();
}

目前ITfRange物件的指標可以從TF_SELECTION結構的 range > 元素取得 < 。

需求


最低支援的用戶端	Windows 2000 專業版 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows 2000 Server [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	msctf.h
可轉散發套件	Windows 2000 專業版上的 TSF 1.0