Partager via


Méthode ITextProvider::GetSelection (uiautomationcore.h)

Récupère une collection de plages de texte qui représente le texte actuellement sélectionné dans un contrôle textuel.

Syntaxe

HRESULT GetSelection(
  [out, retval] SAFEARRAY **pRetVal
);

Paramètres

[out, retval] pRetVal

Type : SAFEARRAY**

Reçoit l’adresse d’un tableau de pointeurs vers les interfaces ITextRangeProvider des plages de texte, une pour chaque étendue de texte sélectionné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

Pour les fournisseurs UI Automation qui prennent en charge la sélection de texte, le fournisseur doit implémenter cette méthode et retourner également une valeur ITextProvider::SupportedTextSelection .

Si le contrôle ne contient qu’une seule étendue de texte sélectionné, le tableau pRetVal doit contenir une seule plage de texte.

Si le contrôle contient un point d’insertion de texte mais qu’aucun texte n’est sélectionné, le tableau pRetVal doit contenir une plage de texte dégénérée (vide) à la position du point d’insertion de texte.

Si le contrôle ne contient aucun texte sélectionné ou s’il ne contient pas de point d’insertion de texte, définissez pRetVal sur NULL.

Configuration requise

   
Client minimal pris en charge Windows XP [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête uiautomationcore.h (incluez UIAutomation.h)

Voir aussi

Meilleures pratiques pour l’utilisation de tableaux sécurisés

Conceptuel

ITextProvider

ITextRangeProvider

Référence

Vue d'ensemble des fournisseurs UI Automation