TextRange_ExpandToEnclosingUnit, fonction (uiautomationcoreapi.h)

Article
08/26/2023

Note Cette fonction est déconseillée. Les applications clientes doivent utiliser les interfaces COM (Component Object Model) Microsoft UI Automation à la place.

Étend la plage de texte à une unité plus ou moins grande, telle que Caractère, Word, Ligne ou Page.

Syntaxe

HRESULT TextRange_ExpandToEnclosingUnit(
  [in] HUIATEXTRANGE hobj,
  [in] TextUnit      unit
);

Paramètres

[in] hobj

Type : HUIATEXTRANGE

Objet de plage de texte.

[in] unit

Type : TextUnit

Unité vers laquelle le fournisseur doit développer la plage de texte.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite ou une valeur d’erreur dans le cas contraire.

Remarques

Si la plage est déjà un nombre intégral des unités spécifiées, elle reste inchangée.

Si le point de terminaison de départ n’est pas à une limite TextUnit , il est déplacé vers l’arrière jusqu’à ce qu’il soit à une limite. Par la suite, si le point de terminaison de fin n’est pas à une limite, ou s’il se trouve à la même limite que le point de terminaison de départ, le point de terminaison de fin est déplacé vers l’avant jusqu’à ce qu’il se trouve à une limite.

Note Il est courant pour un lecteur d’écran de lire un mot entier, un paragraphe entier, etc., au point d’insertion ou à n’importe quelle position de curseur virtuel.

TextRange_ExpandToEnclosingUnit respecte à la fois le texte masqué et le texte visible. Le client UI Automation peut case activée l’attribut is-hidden (Text_IsHidden_Attribute_GUID) pour la visibilité du texte.

TextRange_ExpandToEnclosingUnit valeurs par défaut jusqu’à la suivante TextUnit prise en charge si l’objet TextUnit donné n’est pas pris en charge par le contrôle.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	uiautomationcoreapi.h
Bibliothèque	Uiautomationcore.lib
DLL	Uiautomationcore.dll

Share via