iTfRange 接口 (msctf.h)

项目
08/24/2023

文本服务和应用程序使用 ITfRange 接口在给定上下文中引用和操作文本。接口 ID 是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();
}

可以从 TF_SELECTION 结构的 range> 元素获取<指向当前 ITfRange 对象的指针。

要求


最低受支持的客户端	Windows 2000 专业版 [桌面应用 \|UWP 应用]
最低受支持的服务器	Windows 2000 Server [桌面应用 \|UWP 应用]
目标平台	Windows
标头	msctf.h
可再发行组件	Windows 2000 专业版上的 TSF 1.0