ITextRangeProvider.ExpandToEnclosingUnit(TextUnit) Méthode

Définition

Espace de noms:

System.Windows.Automation.Provider

Assembly:

UIAutomationTypes.dll

Développe la plage de texte jusqu’à l’unité de texte spécifiée.

public:
 void ExpandToEnclosingUnit(System::Windows::Automation::Text::TextUnit unit);

public void ExpandToEnclosingUnit (System.Windows.Automation.Text.TextUnit unit);

abstract member ExpandToEnclosingUnit : System.Windows.Automation.Text.TextUnit -> unit

Public Sub ExpandToEnclosingUnit (unit As TextUnit)

Paramètres

unit

TextUnit

Unité de texte.

Remarques

Si la plage est déjà une quantité exacte des unités spécifiées, elle reste inchangée.

Une série d’étapes sont impliquées en arrière-plan pour que la Move méthode s’exécute correctement.

1. La plage de texte est normalisée : elle est réduite en une plage dégénérée au niveau du point de terminaison Start , rendant le point de terminaison End superflu. Cette étape est nécessaire pour supprimer l’ambiguïté dans les situations où une plage de texte dépasse les unit limites ; par exemple, « {L’U}RL https://www.microsoft.com/ est incorporée dans le texte » où « { » et « } » sont les points de terminaison de la plage de texte.

2. La plage obtenue est déplacée vers l'arrière dans DocumentRange au début de la limite unit demandée.

3. La plage est avancée ou reculée dans DocumentRange du nombre demandé de limites unit .

4. La plage est ensuite étendue à partir d'un état de plage dégénérée en déplaçant le point de terminaison End d'une limite unit demandée.

Exemples de la façon dont une plage de texte est ajustée pour Move() et ExpandToEnclosingUnit()

Notes

Ces étapes sont nécessaires, car il est courant pour un lecteur d’écran de lire un mot, une phrase ou un paragraphe entier au point d’insertion ou à toute position de curseur virtuel.

ExpandToEnclosingUnit respecte à la fois le texte masqué et visible.

ExpandToEnclosingUnit passe au plus grand TextUnit suivant pris en charge si le donné TextUnit n’est pas pris en charge par le contrôle.

L’ordre, de la plus petite à la plus grande, est répertorié ci-dessous.

• Character

• Format

• Word

• Line

• Paragraph

• Page

• Document