DockPattern.DockPositionProperty フィールド

定義

名前空間:

System.Windows.Automation

アセンブリ:

UIAutomationClient.dll

DockPosition プロパティを識別します。

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

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

 staticval mutable DockPositionProperty : System.Windows.Automation.AutomationProperty

Public Shared ReadOnly DockPositionProperty As AutomationProperty 

フィールド値

AutomationProperty

例

次の例では、 DockPosition サポートするコントロールの現在のドック位置を表す値が取得されます DockPattern。

///--------------------------------------------------------------------
/// <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 conditionSupportsDock =
        new PropertyCondition(
        AutomationElement.IsDockPatternAvailableProperty, true);

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

'''--------------------------------------------------------------------
''' <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 conditionSupportsDock As New PropertyCondition( _
    AutomationElement.IsDockPatternAvailableProperty, True)

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

End Function 'FindAutomationElement

///--------------------------------------------------------------------
/// <summary>
/// Gets the current DockPosition of a target.
/// </summary>
/// <param name="dockControl">
/// The automation element of interest.
/// </param>
/// <returns>
/// The current dock position.
/// </returns>
///--------------------------------------------------------------------
private DockPosition GetCurrentDockPosition(
    AutomationElement dockControl)
{
    if (dockControl == null)
    {
        throw new ArgumentNullException(
            "AutomationElement parameter must not be null.");
    }

    return (DockPosition)dockControl.GetCurrentPropertyValue(
        DockPattern.DockPositionProperty);
}

'''--------------------------------------------------------------------
''' <summary>
''' Gets the current DockPosition of a target.
''' </summary>
''' <param name="dockControl">
''' The automation element of interest.
''' </param>
''' <returns>
''' The current dock position.
''' </returns>
'''--------------------------------------------------------------------
Private Overloads Function GetCurrentDockPosition( _
ByVal dockControl As AutomationElement) As DockPosition
    If dockControl Is Nothing Then
        Throw New ArgumentNullException( _
        "AutomationElement parameter must not be null.")
    End If

    Return CType(dockControl.GetCurrentPropertyValue( _
    DockPattern.DockPositionProperty), DockPosition)

End Function 'GetCurrentDockPosition

注釈

この識別子は、クライアント アプリケーションUI オートメーション使用されます。 UI オートメーションプロバイダーでは、同等のフィールドDockPatternIdentifiersを使用する必要があります。

このプロパティは、プロパティCachedからCurrent取得することもできます。

既定値は None です。