ITextRangeProvider.ExpandToEnclosingUnit(TextUnit) Método

Definición

Espacio de nombres:

System.Windows.Automation.Provider

Ensamblado:

UIAutomationTypes.dll

Expande el intervalo de texto a la unidad de texto especificada.

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)

Parámetros

unit

TextUnit

Unidad textual.

Comentarios

Si el intervalo ya es una cantidad exacta de las unidades especificadas, no se modifica.

Hay una serie de pasos implicados en segundo plano para que el Move método se ejecute correctamente.

1. El intervalo de texto se normaliza, es decir, se contrae, en un intervalo degenerado en el extremo Start , y el extremo End queda superfluo. Este paso es necesario para quitar la ambigüedad en situaciones en las que un intervalo de texto abarca los límites unit ; por ejemplo, "{El RL https://www.microsoft.com/ U}está incrustado en texto", donde "{" y "}" son los puntos de conexión del intervalo de texto.

2. El intervalo resultante se mueve hacia atrás en DocumentRange , al principio del límite unit solicitado.

3. El intervalo resultante se mueve hacia delante o hacia atrás en DocumentRange , en función del número solicitado de límites unit .

4. A continuación, el intervalo se expande desde un estado de intervalo degenerado moviendo el extremo End en función de un límite unit solicitado.

Ejemplos de cómo se ajusta un intervalo de texto para Move() y ExpandToEnclosingUnit()

Nota:

Estos pasos son necesarios, ya que es habitual que un lector de pantalla lea una palabra, frase o párrafo completo en el punto de inserción o cualquier posición del cursor virtual.

ExpandToEnclosingUnit respeta el texto oculto y visible.

ExpandToEnclosingUnit se aplaza al siguiente mayor TextUnit admitido si el control especificado TextUnit no es compatible con el control .

El pedido, de la unidad más pequeña al más grande, se muestra a continuación.

• Character

• Format

• Word

• Line

• Paragraph

• Page

• Document