TextPatternRange.GetText(Int32) Método

Definición

Espacio de nombres:

System.Windows.Automation.Text

Ensamblado:

UIAutomationClient.dll

Devuelve el texto sin formato del intervalo de texto.

public:
 System::String ^ GetText(int maxLength);

public string GetText (int maxLength);

member this.GetText : int -> string

Public Function GetText (maxLength As Integer) As String

Parámetros

maxLength

Int32

Longitud máxima de la cadena que se debe devolver. Use -1 si no se requiere ningún límite.

Devoluciones

String

Texto sin formato del intervalo de texto, posiblemente truncado según el maxLength especificado.

Excepciones

ArgumentOutOfRangeException

Si maxLength es menor que 1.

Ejemplos

 private String TextFromSelection(AutomationElement target, Int32 length)
{
    // Specify the control type we're looking for, in this case 'Document'
    PropertyCondition cond = new PropertyCondition(AutomationElement.ControlTypeProperty, ControlType.Document);

    // target --> The root AutomationElement.
    AutomationElement textProvider = target.FindFirst(TreeScope.Descendants, cond);

    TextPattern textpatternPattern = textProvider.GetCurrentPattern(TextPattern.Pattern) as TextPattern;

    if (textpatternPattern == null)
    {
        Console.WriteLine("Root element does not contain a descendant that supports TextPattern.");
        return null;
    }
    TextPatternRange[] currentSelection = textpatternPattern.GetSelection();

    // GetText(-1) retrieves all characters but can be inefficient
    return currentSelection[0].GetText(length);
}

Private Function TextFromSelection(ByVal target As AutomationElement, ByVal length As Int32) As String
    ' Specify the control type we're looking for, in this case 'Document'
    Dim cond As PropertyCondition = New PropertyCondition(AutomationElement.ControlTypeProperty, ControlType.Document)

    ' target --> The root AutomationElement.
    Dim textProvider As AutomationElement = target.FindFirst(TreeScope.Descendants, cond)

    Dim textpatternPattern As TextPattern = CType(textProvider.GetCurrentPattern(TextPattern.Pattern), TextPattern)

    If (textpatternPattern Is Nothing) Then
        Console.WriteLine("Root element does not contain a descendant that supports TextPattern.")
        Return Nothing
    End If
    Dim currentSelection As TextPatternRange() = textpatternPattern.GetSelection()
    ' GetText(-1) retrieves all characters but can be inefficient
    Return currentSelection(0).GetText(length)
End Function

Comentarios

GetText respeta el texto oculto y visible. El cliente de Automatización de la interfaz de usuario puede comprobar si hay IsHiddenAttribute visibilidad de texto.

Si maxLength es mayor que la longitud del intervalo de texto del autor de la llamada, la cadena devuelta será el texto sin formato del intervalo de texto.

GetText no se verá afectado por el orden de los puntos de conexión en el flujo de texto; siempre devolverá el texto entre los extremos Inicio y Final del intervalo de texto en el orden de flujo de texto lógico.

Consulte también

• TextPatternRangeEndpoint