MultipleViewPattern.SupportedViewsProperty 字段

定义

命名空间:

System.Windows.Automation

程序集:

UIAutomationClient.dll

标识用于获取视图的控件特定集合的属性。

public: static initonly System::Windows::Automation::AutomationProperty ^ SupportedViewsProperty;

public static readonly System.Windows.Automation.AutomationProperty SupportedViewsProperty;

 staticval mutable SupportedViewsProperty : System.Windows.Automation.AutomationProperty

Public Shared ReadOnly SupportedViewsProperty As AutomationProperty 

字段值

AutomationProperty

示例

在以下示例中，获取整数标识符的集合，该集合表示可用于支持 MultipleViewPattern的控件的当前视图。

///--------------------------------------------------------------------
/// <summary>
/// Finds all automation elements that satisfy 
/// the specified condition(s).
/// </summary>
/// <param name="targetApp">
/// The automation element from which to start searching.
/// </param>
/// <returns>
/// A collection of automation elements satisfying 
/// the specified condition(s).
/// </returns>
///--------------------------------------------------------------------
private AutomationElementCollection FindAutomationElement(
    AutomationElement targetApp)
{
    if (targetApp == null)
    {
        throw new ArgumentException("Root element cannot be null.");
    }

    PropertyCondition conditionSupportsMultipleView =
        new PropertyCondition(
        AutomationElement.IsMultipleViewPatternAvailableProperty, true);

    return targetApp.FindAll(
        TreeScope.Descendants, conditionSupportsMultipleView);
}

'/--------------------------------------------------------------------
'/ <summary>
'/ Finds all automation elements that satisfy 
'/ the specified condition(s).
'/ </summary>
'/ <param name="targetApp">
'/ The automation element from which to start searching.
'/ </param>
'/ <returns>
'/ A collection of automation elements satisfying 
'/ the specified condition(s).
'/ </returns>
'/--------------------------------------------------------------------
Private Function FindAutomationElement( _
ByVal targetApp As AutomationElement) As AutomationElementCollection
    If targetApp Is Nothing Then
        Throw New ArgumentException("Root element cannot be null.")
    End If

    Dim conditionSupportsMultipleView As New PropertyCondition( _
    AutomationElement.IsMultipleViewPatternAvailableProperty, True)

    Return targetApp.FindAll( _
    TreeScope.Descendants, conditionSupportsMultipleView)

End Function 'FindAutomationElement

///--------------------------------------------------------------------
/// <summary>
/// Gets the collection of currently supported views from a target.
/// </summary>
/// <param name="multipleViewControl">
/// The current multiple view control.
/// </param>
/// <returns>
/// A collection of identifiers representing the supported views.
/// </returns>
///--------------------------------------------------------------------
private int[] GetSupportedViewsFromPattern(
    AutomationElement multipleViewControl)
{
    if (multipleViewControl == null)
    {
        throw new ArgumentNullException(
            "AutomationElement parameter must not be null.");
    }

    return multipleViewControl.GetCurrentPropertyValue(
        MultipleViewPattern.SupportedViewsProperty) as int[];
}

'/--------------------------------------------------------------------
'/ <summary>
'/ Gets the collection of currently supported views from a target.
'/ </summary>
'/ <param name="multipleViewControl">
'/ The current multiple view control.
'/ </param>
'/ <returns>
'/ A collection of identifiers representing the supported views.
'/ </returns>
'/--------------------------------------------------------------------
Private Function GetSupportedViewsFromPattern( _
ByVal multipleViewControl As AutomationElement) As Integer()
    If multipleViewControl Is Nothing Then
        Throw New ArgumentNullException( _
        "AutomationElement parameter must not be null.")
    End If

    Return DirectCast(multipleViewControl.GetCurrentPropertyValue( _
    MultipleViewPattern.SupportedViewsProperty), Integer())
End Function 'GetSupportedViewsProperty

注解

此标识符由 UI 自动化客户端应用程序使用。 UI 自动化提供程序应使用 中的MultipleViewPatternIdentifiers等效字段。

此属性不存在于 中MultipleViewPattern.MultipleViewPatternInformation，必须使用 或 GetCachedPropertyValue检索GetCurrentPropertyValue。