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 オートメーション要素を取得します。 フォームは、大文字と小文字を区別しない文字列識別子の検索によって配置されます。

/// <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 オートメーション要素の取り込み