Método IDWriteTextAnalysisSource::GetTextAtPosition (dwrite.h)
Obtém um bloco de texto começando na posição de texto especificada.
Sintaxe
HRESULT GetTextAtPosition(
UINT32 textPosition,
[out] WCHAR const **textString,
[out] UINT32 *textLength
);
Parâmetros
textPosition
Tipo: UINT32
A primeira posição da peça a ser obtida. Todas as posições estão em unidades de código UTF16 , não caracteres inteiros, o que importa quando caracteres suplementares são usados.
[out] textString
Tipo: const WCHAR**
Quando esse método retorna, contém um endereço do bloco de texto como uma matriz de caracteres a serem recuperados da análise de texto.
[out] textLength
Tipo: UINT32*
Quando esse método retorna, contém o número de unidades UTF16 da parte recuperada. O comprimento retornado não é o comprimento do bloco, mas o comprimento restante no bloco, da posição especificada até o final. Por exemplo, consultar uma posição de 75 posições em um bloco de 100 posições retornaria 25.
Valor retornado
Tipo: HRESULT
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Retornar NULL indica o final do texto, que é a posição após o último caractere. Essa função é chamada iterativamente para cada bloco consecutivo, unindo vários blocos fragmentados no repositório de backup em uma cadeia de caracteres contígua virtual.
Embora os aplicativos possam implementar conteúdo textual esparso que mapeia apenas parte do repositório de backup, o aplicativo deve mapear qualquer texto que esteja no intervalo passado para qualquer função de análise.
Requisitos
| Cliente mínimo com suporte | Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | dwrite.h |
| Biblioteca | Dwrite.lib |
| DLL | Dwrite.dll |