PropertyCondition Konstruktoren

Definition

Namespace:

System.Windows.Automation

Assembly:

UIAutomationClient.dll

Initialisiert eine neue Instanz der PropertyCondition-Klasse.

Überlädt

PropertyCondition(AutomationProperty, Object)	Initialisiert eine neue Instanz der PropertyCondition-Klasse.
PropertyCondition(AutomationProperty, Object, PropertyConditionFlags)	Initialisiert eine neue Instanz der PropertyCondition-Klasse mit Flags.

PropertyCondition(AutomationProperty, Object)

Initialisiert eine neue Instanz der PropertyCondition-Klasse.

public:
 PropertyCondition(System::Windows::Automation::AutomationProperty ^ property, System::Object ^ value);

public PropertyCondition (System.Windows.Automation.AutomationProperty property, object value);

new System.Windows.Automation.PropertyCondition : System.Windows.Automation.AutomationProperty * obj -> System.Windows.Automation.PropertyCondition

Public Sub New (property As AutomationProperty, value As Object)

Parameter

property

AutomationProperty

Die zu überprüfende Eigenschaft.

value

Object

Der Wert, auf den die Eigenschaft überprüft werden soll.

Beispiele

Im folgenden Beispiel gibt an PropertyCondition , dass das zu findende UI Automation-Element über den Steuerelementtyp verfügt List. Wird PropertyCondition dann verwendet, um das list-Element aus einem Kombinationsfeld abzurufen.

Condition propCondition1 = new PropertyCondition(AutomationElement.ControlTypeProperty, ControlType.List);
AutomationElement listElement = elementCombo.FindFirst(TreeScope.Children, propCondition1);

Dim propCondition1 As New PropertyCondition(AutomationElement.ControlTypeProperty, ControlType.List)
Dim listElement As AutomationElement = elementCombo.FindFirst(TreeScope.Children, propCondition1)

Hinweise

Der property-Parameter darf nicht BoundingRectangleProperty sein.

PropertyCondition(AutomationProperty, Object, PropertyConditionFlags)

Initialisiert eine neue Instanz der PropertyCondition-Klasse mit Flags.

public:
 PropertyCondition(System::Windows::Automation::AutomationProperty ^ property, System::Object ^ value, System::Windows::Automation::PropertyConditionFlags flags);

public PropertyCondition (System.Windows.Automation.AutomationProperty property, object value, System.Windows.Automation.PropertyConditionFlags flags);

new System.Windows.Automation.PropertyCondition : System.Windows.Automation.AutomationProperty * obj * System.Windows.Automation.PropertyConditionFlags -> System.Windows.Automation.PropertyCondition

Public Sub New (property As AutomationProperty, value As Object, flags As PropertyConditionFlags)

Parameter

property

AutomationProperty

Die zu überprüfende Eigenschaft.

value

Object

Der Wert, auf den die Eigenschaft überprüft werden soll.

flags

PropertyConditionFlags

Flags, die den Vergleich beeinflussen.

Beispiele

Im folgenden Beispiel wird ein PropertyCondition verwendet, um das Microsoft UI Automation-Element abzurufen, das die Standard Form einer Anwendung darstellt. Das Formular wird durch eine Suche nach dem Zeichenfolgenbezeichner ohne Beachtung der Groß-/Kleinschreibung gefunden.

/// <summary>
/// Find a UI Automation child element by ID.
/// </summary>
/// <param name="controlName">Name of the control, such as "button1"</param>
/// <param name="parentElement">Parent element, such as an application window, or the 
/// AutomationElement.RootElement when searching for the application window.</param>
/// <returns>The UI Automation element.</returns>
private AutomationElement FindChildElement(String controlName, AutomationElement rootElement)
{
    if ((controlName == "") || (rootElement == null))
    {
        throw new ArgumentException("Argument cannot be null or empty.");
    }
    // Set a property condition that will be used to find the main form of the
    // target application. In the case of a WinForms control, the name of the control
    // is also the AutomationId of the element representing the control.
    Condition propCondition = new PropertyCondition(
        AutomationElement.AutomationIdProperty, controlName, PropertyConditionFlags.IgnoreCase);

    // Find the element.
    return rootElement.FindFirst(TreeScope.Element | TreeScope.Children, propCondition);
}

''' <summary>
''' Find a UI Automation child element by ID.
''' </summary>
''' <param name="controlName">Name of the control, such as "button1"</param>
''' <param name="rootElement">Parent element, such as an application window, or the 
''' AutomationElement.RootElement when searching for the application window.</param>
''' <returns>The UI Automation element.</returns>
Private Function FindChildElement(ByVal controlName As String, ByVal rootElement As AutomationElement) _
    As AutomationElement
    If controlName = "" OrElse rootElement Is Nothing Then
        Throw New ArgumentException("Argument cannot be null or empty.")
    End If
    ' Set a property condition that will be used to find the main form of the
    ' target application. In the case of a WinForms control, the name of the control
    ' is also the AutomationId of the element representing the control.
    Dim propCondition As New PropertyCondition(AutomationElement.AutomationIdProperty, _
        controlName, PropertyConditionFlags.IgnoreCase)

    ' Find the element.
    Return rootElement.FindFirst(TreeScope.Element Or TreeScope.Children, propCondition)

End Function 'FindChildElement

Weitere Informationen

• Benutzeroberflächenautomatisierungs-Eigenschaften für Clients
• Abrufen von Benutzeroberflächenautomatisierungs-Elementen