Méthode IUIAutomationTextPattern ::GetSelection (uiautomationclient.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] IUIAutomationTextRangeArray **ranges
);

Paramètres

[out, retval] ranges

Type : IUIAutomationTextRangeArray**

Reçoit un pointeur vers la collection de plages de texte.

Valeur retournée

Type : HRESULT

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

Remarques

Si le contrôle prend en charge la sélection de plusieurs étendues de texte non contiguës, la collection plages reçoit une plage de texte pour chaque étendue sélectionnée.

Si le contrôle ne contient qu’une seule étendue de texte sélectionné, la collection plages reçoit une seule plage de texte.

Si le contrôle contient un point d’insertion de texte mais qu’aucun texte n’est sélectionné, la collection plages reçoit une plage de texte dégénérée (vide) à la position du point d’insertion de texte.

Si le contrôle ne contient pas de point d’insertion de texte ou ne prend pas en charge la sélection de texte, les plages sont définies sur NULL.

Utilisez la propriété IUIAutomationTextPattern ::SupportedTextSelection pour tester si un contrôle prend en charge la sélection de texte.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista, Windows XP avec SP3 et Mise à jour de plateforme pour Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2, Windows Server 2008 avec SP2 et Platform Update pour Windows Server 2008, Windows Server 2003 avec SP2 et Platform Update pour Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	uiautomationclient.h (incluez UIAutomation.h)

Voir aussi

IUIAutomationTextPattern

UI Automation prise en charge du contenu textuel