Интерфейс ITfRange (msctf.h)

Статья
03/08/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, см. в разделе Диапазоны, внедренные объекты и другие разделы статьи Using Text Services Framework.

Примеры

После создания экземпляра объекта композиции ITfComposition указатель на указатель интерфейса ITfRange можно получить, вызвав метод ITfComposition::GetRange , как показано в следующем примере кода.


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 можно получить из <элемента range>структуры TF_SELECTION .

Требования


Минимальная версия клиента	Windows 2000 Профессиональная [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows 2000 Server [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	msctf.h
Распространяемые компоненты	TSF 1.0 в Windows 2000 Профессиональная