共用方式為


(msctf.h) ITfRange 介面

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

另請參閱

成分

内嵌物件

ITfComposition

ITfComposition::GetRange

IUnknown

範圍

TF_SELECTION

使用文字服務架構