ITextRangeProvider::GetText, méthode (uiautomationcore.h)

Récupère le texte brut de la plage.

Syntaxe

HRESULT GetText(
  [in]          int  maxLength,
  [out, retval] BSTR *pRetVal
);

Paramètres

[in] maxLength

Type : int

Longueur maximale de la chaîne à retourner. Utilisez -1 si aucune limite n'est exigée.

[out, retval] pRetVal

Type : BSTR*

Reçoit le texte brut de la plage de texte, éventuellement tronqué à la longueur maximale spécifiée. Ce paramètre est passé sans être initialisé.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

ITextRangeProvider::GetText récupère le texte masqué et visible.

Si maxLength est supérieur à la longueur de l’étendue de texte de l’appelant, la chaîne retournée sera le texte brut de la plage de texte.

ITextRangeProvider::GetText ne sera pas affecté par l’ordre des points de terminaison dans le flux de texte ; il retourne toujours le texte entre les points de terminaison de début et de fin de la plage de texte dans l’ordre de flux de texte logique.

Configuration requise

Voir aussi

Conceptuel

ITextProvider

ITextRangeProvider

Référence

Vue d'ensemble des fournisseurs UI Automation