Interface ITfRange (msctf.h)

Artigo
03/08/2023

A interface ITfRange é usada por serviços de texto e aplicativos para referenciar e manipular texto dentro de um determinado contexto. A ID da interface é IID_ITfRange.

Herança

A interface ITfRange herda da interface IUnknown . O ITfRange também tem estes tipos de membros:

Métodos

A interface ITfRange tem esses métodos.


ITfRange::AdjustForInsert O método ITfRange::AdjustForInsert expande ou contrai um intervalo de texto para ajustar para inserção de texto.
ITfRange::Clone O método ITfRange::Clone duplica esse intervalo de texto.
ITfRange::Collapse O método ITfRange::Collapse limpa o intervalo de texto movendo a âncora inicial e a âncora final para a mesma posição.
ITfRange::CompareEnd O método ITfRange::CompareEnd compara a posição da âncora final desse intervalo de texto com uma âncora em outro intervalo.
ITfRange::CompareStart O método ITfRange::CompareStart compara a posição da âncora inicial desse intervalo de texto com uma âncora em outro intervalo.
ITfRange::GetContext Método ITfRange::GetContext
ITfRange::GetEmbedded O método ITfRange::GetEmbedded obtém conteúdo que corresponde a um caractere TS_CHAR_EMBEDDED no fluxo de texto. A âncora inicial do intervalo de texto é posicionada pouco antes do caractere de interesse.
ITfRange::GetFormattedText O método ITfRange::GetFormattedText obtém conteúdo formatado contido em um intervalo de texto. O conteúdo é empacotado em um objeto que dá suporte à interface IDataObject.
ITfRange::GetGravity Método ITfRange::GetGravity
ITfRange::GetText O método ITfRange::GetText obtém o conteúdo coberto por esse intervalo de texto.
ITfRange::InsertEmbedded O método ITfRange::InsertEmbedded insere um objeto no local da âncora inicial do intervalo de texto.
ITfRange::IsEmpty O método ITfRange::IsEmpty verifica se o intervalo de texto está vazio porque as âncoras inicial e final ocupam a mesma posição.
ITfRange::IsEqualEnd O método ITfRange::IsEqualStart verifica se a âncora final desse intervalo de texto corresponde a uma âncora de outro intervalo especificado.
ITfRange::IsEqualStart O método ITfRange::IsEqualStart verifica se a âncora inicial desse intervalo de texto corresponde a uma âncora de outro intervalo especificado.
ITfRange::SetGravity Método ITfRange::SetGravity
ITfRange::SetText O método ITfRange::SetText substitui o conteúdo coberto pelo intervalo de texto.
ITfRange::ShiftEnd Método ITfRange::ShiftEnd
ITfRange::ShiftEndRegion Método ITfRange::ShiftEndRegion
ITfRange::ShiftEndToRange Método ITfRange::ShiftEndToRange
ITfRange::ShiftStart Método ITfRange::ShiftStart
ITfRange::ShiftStartRegion Método ITfRange::ShiftStartRegion
ITfRange::ShiftStartToRange Método ITfRange::ShiftStartToRange

Comentários

O gerenciador do TSF implementa essa interface. Para obter mais informações sobre intervalos, âncoras, objetos inseridos e outras propriedades de texto usadas pelo TSF, consulte Intervalos, objetos inseridos e outros tópicos no Using Text Services Framework.

Exemplos

Depois que um objeto de composição ITfComposition é instanciado, um ponteiro para um ponteiro de interface ITfRange pode ser obtido chamando o método ITfComposition::GetRange , conforme mostrado no exemplo de código a seguir.


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();
}

Um ponteiro para um objeto ITfRange atual pode ser obtido do <elemento range> da estrutura TF_SELECTION .

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	msctf.h
Redistribuível	TSF 1.0 no Windows 2000 Professional