PropertyCondition 建構函式

定義

命名空間:

System.Windows.Automation

組件:

UIAutomationClient.dll

初始化 PropertyCondition 類別的新執行個體。

多載

PropertyCondition(AutomationProperty, Object)	初始化 PropertyCondition 類別的新執行個體。
PropertyCondition(AutomationProperty, Object, PropertyConditionFlags)	使用旗標來初始化 PropertyCondition 類別的新執行個體。

PropertyCondition(AutomationProperty, Object)

初始化 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)

參數

property

AutomationProperty

要測試的屬性。

value

Object

以此值來測試屬性。

範例

在下列範例中，指定 PropertyCondition 要找到的 UI 自動化專案具有 的 List 控制項類型。 接著會使用 從 PropertyCondition 下拉式方塊取得清單專案。

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)

備註

property 參數不可為 BoundingRectangleProperty。

PropertyCondition(AutomationProperty, Object, PropertyConditionFlags)

使用旗標來初始化 PropertyCondition 類別的新執行個體。

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)

參數

property

AutomationProperty

要測試的屬性。

value

Object

以此值來測試屬性。

flags

PropertyConditionFlags

影響比較的旗標。

範例

下列範例會使用 PropertyCondition 來擷取代表應用程式主要表單的 Microsoft UI Automation 元素。 表單是由不區分大小寫的搜尋來尋找其字串識別碼。

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

另請參閱

• 用戶端的 UI 自動化屬性
• 取得 UI 自動化項目