PropertyCondition Construtores

Definição

Namespace:

System.Windows.Automation

Assembly:

UIAutomationClient.dll

Inicializa uma nova instância da classe PropertyCondition.

Sobrecargas

PropertyCondition(AutomationProperty, Object)	Inicializa uma nova instância da classe PropertyCondition.
PropertyCondition(AutomationProperty, Object, PropertyConditionFlags)	Inicializa uma nova instância da classe PropertyCondition, com sinalizadores.

PropertyCondition(AutomationProperty, Object)

Inicializa uma nova instância da classe PropertyCondition.

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)

Parâmetros

property

AutomationProperty

A propriedade a ser testada.

value

Object

O valor para o teste da propriedade.

Exemplos

No exemplo a seguir, um PropertyCondition especifica que o elemento de Automação da Interface do Usuário a ser encontrado tem um tipo de controle de List. Em PropertyCondition seguida, o é usado para obter o elemento list de uma caixa de combinação.

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)

Comentários

O parâmetro property não pode ser BoundingRectangleProperty.

PropertyCondition(AutomationProperty, Object, PropertyConditionFlags)

Inicializa uma nova instância da classe PropertyCondition, com sinalizadores.

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)

Parâmetros

property

AutomationProperty

A propriedade a ser testada.

value

Object

O valor para o teste da propriedade.

flags

PropertyConditionFlags

Sinalizadores que afetam a comparação.

Exemplos

O exemplo a seguir usa um PropertyCondition para recuperar o elemento de Automação da Interface do Usuário da Microsoft que representa a forma main de um aplicativo. O formulário está localizado por uma pesquisa que não diferencia maiúsculas de minúsculas para seu identificador de cadeia de caracteres.

/// <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

Confira também

• Automação de Propriedades de Interface de Usuário para Clientes.
• Obtendo elementos da automação interface do usuário