AutomationProperty Classe

Définition

Espace de noms:

System.Windows.Automation

Assembly:

UIAutomationTypes.dll

Identifie une propriété d'un 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

Héritage

Object

AutomationIdentifier

AutomationProperty

Exemples

L’exemple suivant ajoute un gestionnaire d’événements modifié par la propriété et le gestionnaire vérifie le Property membre des arguments d’événement pour déterminer la propriété qui a été modifiée.

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

Remarques

Cette classe identifie les propriétés, et non les valeurs des propriétés. Les objets statiques de ce type sont trouvés sous forme de champs et de classes de AutomationElement modèles de contrôle.

Propriétés

Id	Obtient l'identificateur numérique sous-jacent. (Hérité de AutomationIdentifier)
ProgrammaticName	Obtient le nom de programmation enregistré. (Hérité de AutomationIdentifier)

Méthodes

CompareTo(Object)	Compare ce AutomationIdentifier avec un autre AutomationIdentifier. (Hérité de AutomationIdentifier)
Equals(Object)	Retourne une valeur indiquant si le AutomationIdentifier fourni est équivalent à ce AutomationIdentifier. (Hérité de AutomationIdentifier)
GetHashCode()	Retourne le code de hachage de cet identificateur UI Automation. (Hérité de AutomationIdentifier)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
LookupById(Int32)	Récupère un AutomationProperty qui encapsule un identificateur numérique spécifié.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Voir aussi

• Vue d'ensemble des propriétés UI Automation