Interfaz ITfRange (msctf.h)

Artículo
03/08/2023

Los servicios de texto y las aplicaciones usan la interfaz ITfRange para hacer referencia y manipular texto dentro de un contexto determinado. El identificador de interfaz es IID_ITfRange.

Herencia

La interfaz ITfRange hereda de la interfaz IUnknown . ITfRange también tiene estos tipos de miembros:

Métodos

La interfaz ITfRange tiene estos métodos.


ITfRange::AdjustForInsert El método ITfRange::AdjustForInsert expande o contrae un intervalo de texto para ajustarse a la inserción de texto.
ITfRange::Clone El método ITfRange::Clone duplica este intervalo de texto.
ITfRange::Collapse El método ITfRange::Collapse borra el intervalo de texto moviendo su delimitador inicial y final a la misma posición.
ITfRange::CompareEnd El método ITfRange::CompareEnd compara la posición del delimitador final de este intervalo de texto con un delimitador en otro intervalo.
ITfRange::CompareStart El método ITfRange::CompareStart compara la posición del delimitador inicial de este intervalo de texto con un delimitador en otro intervalo.
ITfRange::GetContext Método ITfRange::GetContext
ITfRange::GetEmbedded El método ITfRange::GetEmbedded obtiene contenido que corresponde a un carácter de TS_CHAR_EMBEDDED en la secuencia de texto. El delimitador inicial del intervalo de texto se coloca justo antes del carácter de interés.
ITfRange::GetFormattedText El método ITfRange::GetFormattedText obtiene contenido con formato incluido en un intervalo de texto. El contenido se empaqueta en un objeto que admite la interfaz IDataObject.
ITfRange::GetGravity Método ITfRange::GetGravity
ITfRange::GetText El método ITfRange::GetText obtiene el contenido cubierto por este intervalo de texto.
ITfRange::InsertEmbedded El método ITfRange::InsertEmbedded inserta un objeto en la ubicación del delimitador inicial del intervalo de texto.
ITfRange::IsEmpty El método ITfRange::IsEmpty comprueba que el intervalo de texto está vacío porque los delimitadores inicial y final ocupan la misma posición.
ITfRange::IsEqualEnd El método ITfRange::IsEqualStart comprueba que el delimitador final de este intervalo de texto coincide con un delimitador de otro intervalo especificado.
ITfRange::IsEqualStart El método ITfRange::IsEqualStart comprueba que el delimitador inicial de este intervalo de texto coincide con un delimitador de otro intervalo especificado.
ITfRange::SetGravity Método ITfRange::SetGravity
ITfRange::SetText El método ITfRange::SetText reemplaza el contenido cubierto por el 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

Comentarios

El administrador de TSF implementa esta interfaz. Para obtener más información sobre los intervalos, delimitadores, objetos incrustados y otras propiedades de texto utilizadas por TSF, vea Rangos, objetos incrustados y otros temas dentro de Using Text Services Framework.

Ejemplos

Una vez que se crea una instancia de un objeto de composición ITfComposition , se puede obtener un puntero a un puntero de interfaz ITfRange llamando al método ITfComposition::GetRange , como se muestra en el ejemplo de código siguiente.


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

Se puede obtener un puntero a un objeto ITfRange actual del elemento range <> de la estructura TF_SELECTION.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	msctf.h
Redistribuible	TSF 1.0 en Windows 2000 Professional