TextPatternRange.GetAttributeValue(AutomationTextAttribute) Método

Definición

Espacio de nombres:

System.Windows.Automation.Text

Ensamblado:

UIAutomationClient.dll

Devuelve el valor del atributo especificado en todo el intervalo de texto.

public:
 System::Object ^ GetAttributeValue(System::Windows::Automation::AutomationTextAttribute ^ attribute);

public object GetAttributeValue (System.Windows.Automation.AutomationTextAttribute attribute);

member this.GetAttributeValue : System.Windows.Automation.AutomationTextAttribute -> obj

Public Function GetAttributeValue (attribute As AutomationTextAttribute) As Object

Parámetros

attribute

AutomationTextAttribute

Atributo de texto.

Devoluciones

Object

Devuelve el valor del atributo especificado. Por ejemplo, GetAttributeValue (TextPattern.FontNameAttribute) devolvería una cadena que representa el nombre de la fuente, si es único, del intervalo de texto, mientras que GetAttributeValue (TextPattern.IsItalicAttribute) devolvería un valor booleano.

Devuelve MixedAttributeValue si el valor del atributo especificado varía respecto al intervalo de texto.

Devuelve NotSupported si el proveedor o el control no admiten el atributo especificado.

Excepciones

ArgumentException

Si el atributo especificado no es válido.

Ejemplos

 private Object AttributeValueFromSelection(AutomationElement target)
{
    // 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();
    // Is 'italic'?
    return currentSelection[0].GetAttributeValue(TextPattern.IsItalicAttribute);
}

Private Function AttributeValueFromSelection(ByVal target As AutomationElement) As Object
    ' 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()
    ' Is 'italic'?
    Return currentSelection(0).GetAttributeValue(TextPattern.IsItalicAttribute)
End Function

Comentarios

No hay diferenciación entre texto oculto y visible. Los clientes de automatización de la interfaz de usuario pueden usar IsHiddenAttribute para comprobar la visibilidad del texto.