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