TextPatternRange.GetAttributeValue(AutomationTextAttribute) Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Automation.Text

Assembly:: UIAutomationClient.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Restituisce il valore dell'attributo specificato nell'intero intervallo di testo.

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

Parametri

attribute: AutomationTextAttribute

Attributo di testo.

Restituisce

Object

Restituisce il valore dell'attributo specificato. Ad esempio, GetAttributeValue (TextPattern.FontNameAttribute) restituirebbe una stringa che rappresenta il nome del tipo di carattere, se univoco, dell'intervallo di testo, mentre GetAttributeValue (TextPattern.IsItalicAttribute) restituirebbe un valore booleano.

Restituisce MixedAttributeValue se il valore dell'attributo specificato varia nell'intervallo di testo.

Restituisce NotSupported se l'attributo specificato non è supportato dal provider o dal controllo.

Eccezioni

ArgumentException

Se l'attributo specificato non è valido.

Esempio

 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

Commenti

Non esiste alcuna differenziazione tra testo nascosto e visibile. Automazione interfaccia utente client possono usare IsHiddenAttribute per controllare la visibilità del testo.

Si applica a

Condividi tramite