AutomationProperty Classe

Definizione

Spazio dei nomi:

System.Windows.Automation

Assembly:

UIAutomationTypes.dll

Identifica una proprietà di un oggetto AutomationElement.

public ref class AutomationProperty : System::Windows::Automation::AutomationIdentifier

public class AutomationProperty : System.Windows.Automation.AutomationIdentifier

type AutomationProperty = class
    inherit AutomationIdentifier

Public Class AutomationProperty
Inherits AutomationIdentifier

Ereditarietà

Object

AutomationIdentifier

AutomationProperty

Esempio

Nell'esempio seguente viene aggiunto un gestore eventi di modifica della proprietà e il gestore controlla il Property membro degli argomenti dell'evento per determinare la proprietà modificata.

AutomationPropertyChangedEventHandler propChangeHandler;
/// <summary>
/// Adds a handler for property-changed event; in particular, a change in the enabled state.
/// </summary>
/// <param name="element">The UI Automation element whose state is being monitored.</param>
public void SubscribePropertyChange(AutomationElement element)
{
    Automation.AddAutomationPropertyChangedEventHandler(element, 
        TreeScope.Element, 
        propChangeHandler = new AutomationPropertyChangedEventHandler(OnPropertyChange),
        AutomationElement.IsEnabledProperty);
}

/// <summary>
/// Handler for property changes.
/// </summary>
/// <param name="src">The source whose properties changed.</param>
/// <param name="e">Event arguments.</param>
private void OnPropertyChange(object src, AutomationPropertyChangedEventArgs e)
{
    AutomationElement sourceElement = src as AutomationElement;
    if (e.Property == AutomationElement.IsEnabledProperty)
    {
        bool enabled = (bool)e.NewValue;
        // TODO: Do something with the new value. 
        // The element that raised the event can be identified by its runtime ID property.
    }
    else
    { 
        // TODO: Handle other property-changed events.
    }
}

public void UnsubscribePropertyChange(AutomationElement element)
{
    if (propChangeHandler != null)
    {
        Automation.RemoveAutomationPropertyChangedEventHandler(element, propChangeHandler);
    }
}

Dim propChangeHandler As AutomationPropertyChangedEventHandler

''' <summary>
''' Adds a handler for property-changed event; in particular, a change in the enabled state.
''' </summary>
''' <param name="element">The UI Automation element whose state is being monitored.</param>
Public Sub SubscribePropertyChange(ByVal element As AutomationElement)
    propChangeHandler = _
        New AutomationPropertyChangedEventHandler(AddressOf OnPropertyChange)
    Automation.AddAutomationPropertyChangedEventHandler(element, TreeScope.Element, _
        propChangeHandler, AutomationElement.IsEnabledProperty)

End Sub



''' <summary>
''' Handler for property changes.
''' </summary>
''' <param name="src">The source whose properties changed.</param>
''' <param name="e">Event arguments.</param>
Private Sub OnPropertyChange(ByVal src As Object, ByVal e As AutomationPropertyChangedEventArgs) 
    Dim sourceElement As AutomationElement = DirectCast(src, AutomationElement)
    If e.Property Is AutomationElement.IsEnabledProperty Then
        Dim enabled As Boolean = CBool(e.NewValue)
        ' TODO: Do something with the new value. 
        ' The element that raised the event can be identified by its runtime ID property.
    Else
    End If
 ' TODO: Handle other property-changed events.
End Sub


Public Sub UnsubscribePropertyChange(ByVal element As AutomationElement)
    If (propChangeHandler IsNot Nothing) Then
        Automation.RemoveAutomationPropertyChangedEventHandler(element, propChangeHandler)
    End If

End Sub

Commenti

Questa classe identifica le proprietà, non i valori delle proprietà. Gli oggetti statici di questo tipo vengono trovati come campi delle classi di pattern di AutomationElement controllo e .

Proprietà

Id	Ottiene l'identificatore numerico sottostante. (Ereditato da AutomationIdentifier)
ProgrammaticName	Ottiene il nome registrato a livello di codice. (Ereditato da AutomationIdentifier)

Metodi

CompareTo(Object)	Confronta questo oggetto AutomationIdentifier con un altro AutomationIdentifier. (Ereditato da AutomationIdentifier)
Equals(Object)	Restituisce un valore che indica se l'oggetto AutomationIdentifier fornito è equivalente a questo AutomationIdentifier. (Ereditato da AutomationIdentifier)
GetHashCode()	Restituisce il codice hash per questo identificatore di Automazione interfaccia utente. (Ereditato da AutomationIdentifier)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
LookupById(Int32)	Recupera un oggetto AutomationProperty che incapsula un identificatore numerico specificato.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• Cenni preliminari sulle proprietà di automazione interfaccia utente