Interfaz ITfRange (msctf.h)
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 |