Partager via

IDWriteTextAnalysisSource::GetTextAtPosition, méthode (dwrite.h)

  • Article

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

Voir aussi

IDWriteTextAnalysisSource