IDWriteTextAnalysisSource::GetTextAtPosition, méthode (dwrite.h)
Obtient un bloc de texte commençant à la position de texte spécifiée.
Syntaxe
HRESULT GetTextAtPosition(
UINT32 textPosition,
[out] WCHAR const **textString,
[out] UINT32 *textLength
);
Paramètres
textPosition
Type : UINT32
Première position de la pièce à obtenir. Toutes les positions sont en unités de code UTF16 , et non en caractères entiers, ce qui est important lorsque des caractères supplémentaires sont utilisés.
[out] textString
Type : const WCHAR**
Lorsque cette méthode retourne, contient une adresse du bloc de texte sous la forme d’un tableau de caractères à récupérer à partir de l’analyse de texte.
[out] textLength
Type : UINT32*
Lorsque cette méthode retourne, contient le nombre d’unités UTF16 du segment récupéré. La longueur retournée n’est pas la longueur du bloc, mais la longueur restante dans le bloc, de la position spécifiée jusqu’à sa fin. Par exemple, l’interrogation d’une position de 75 positions dans un bloc de 100 positions renvoie 25.
Valeur retournée
Type : HRESULT
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Notes
Le retour de la valeur NULL indique la fin du texte, qui correspond à la position après le dernier caractère. Cette fonction est appelée de manière itérative pour chaque bloc consécutif, liant plusieurs blocs fragmentés dans le magasin de stockage en une chaîne contiguë virtuelle.
Bien que les applications puissent implémenter du contenu textuel épars qui mappe uniquement une partie du magasin de stockage, l’application doit mapper tout texte qui se trouve dans la plage passée à n’importe quelle fonction d’analyse.
Spécifications
| Client minimal pris en charge | Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Windows Server 2008 R2, Windows Server 2008 avec SP2 et Mise à jour de plateforme pour Windows Server 2008 [applications de bureau | Applications UWP] |
| Plateforme cible | Windows |
| En-tête | dwrite.h |
| Bibliothèque | Dwrite.lib |
| DLL | Dwrite.dll |