AutomationProperty Classe

Definizione

Identifica una proprietà di un oggetto AutomationElement.Identifies a property of an 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à
AutomationProperty

Esempi

Nell'esempio seguente viene aggiunto un gestore eventi di modifica della proprietà e il gestore verifica Property il membro degli argomenti dell'evento per determinare la proprietà che è stata modificata.The following example adds a property-changed event handler, and the handler checks the Property member of the event arguments to determine the property that has been changed.


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à.This class identifies properties, not the values of properties. Gli oggetti statici di questo tipo sono disponibili come campi AutomationElement delle classi e del pattern di controllo.Static objects of this type are found as fields of AutomationElement and control pattern classes.

Proprietà

Id

Ottiene l'identificatore numerico sottostante.Gets the underlying numerical identifier.

(Ereditato da AutomationIdentifier)
ProgrammaticName

Ottiene il nome registrato a livello di codice.Gets the registered programmatic name.

(Ereditato da AutomationIdentifier)

Metodi

CompareTo(Object)

Confronta questo oggetto AutomationIdentifier con un altro AutomationIdentifier.Compares this AutomationIdentifier with another AutomationIdentifier.

(Ereditato da AutomationIdentifier)
Equals(Object)

Restituisce un valore che indica se l'oggetto AutomationIdentifier fornito è equivalente a questo AutomationIdentifier.Returns a value indicating whether the supplied AutomationIdentifier is equivalent to this AutomationIdentifier.

(Ereditato da AutomationIdentifier)
GetHashCode()

Restituisce il codice hash per questo identificatore di Automazione interfaccia utenteUI Automation.Returns the hash code for this Automazione interfaccia utenteUI Automation identifier.

(Ereditato da AutomationIdentifier)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
LookupById(Int32)

Recupera un oggetto AutomationProperty che incapsula un identificatore numerico specificato.Retrieves an AutomationProperty that encapsulates a specified numerical identifier.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Si applica a

Vedi anche