AutomationProperty Clase

  • Referencia

Definición

Espacio de nombres:
System.Windows.Automation
Ensamblado:
UIAutomationTypes.dll

Identifica una propiedad de 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
Herencia
Object
AutomationIdentifier
AutomationProperty

Ejemplos

En el ejemplo siguiente se agrega un controlador de eventos modificados por la propiedad y el controlador comprueba el Property miembro de los argumentos de evento para determinar la propiedad que se ha cambiado.


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

Comentarios

Esta clase identifica las propiedades, no los valores de las propiedades. Los objetos estáticos de este tipo se encuentran como campos de clases de patrones de AutomationElement control y .

Propiedades

Id

Obtiene el identificador numérico subyacente.

(Heredado de AutomationIdentifier)
ProgrammaticName

Obtiene el nombre de programación registrado.

(Heredado de AutomationIdentifier)

Métodos

CompareTo(Object)

Compara este AutomationIdentifier con otro AutomationIdentifier.

(Heredado de AutomationIdentifier)
Equals(Object)

Devuelve un valor que indica si el AutomationIdentifier proporcionado es equivalente a este AutomationIdentifier.

(Heredado de AutomationIdentifier)
GetHashCode()

Devuelve el código hash de este identificador de Automatización de la interfaz de usuario.

(Heredado de AutomationIdentifier)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
LookupById(Int32)

Recupera un objeto AutomationProperty que encapsula un identificador numérico especificado.
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Se aplica a

Consulte también