PropertyCondition Construtores

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

Exemplos

No exemplo seguinte, um PropertyCondition especifica que o elemento Automatização da Interface de Utilizador a ser encontrado tem um tipo de controlo List. O PropertyCondition é então usado para obter o elemento da lista a partir de uma caixa combinada.

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)

Observações

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

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

Exemplos

O exemplo seguinte utiliza um PropertyCondition para recuperar o elemento Microsoft Automatização da Interface de Utilizador que representa a forma principal de uma aplicação. O formulário é localizado por uma pesquisa insensível a maiúsculas e maiúsculas pelo seu identificador de cadeia.

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

Consulte também

• Propriedades de automação da interface do usuário para clientes
• Obtenção Automatização da Interface de Utilizador Elementos