DockPattern.DockPositionProperty Veld

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 

Waarde van veld

Voorbeelden

In het volgende voorbeeld wordt een DockPosition waarde verkregen die de huidige dockpositie vertegenwoordigt voor een besturingselement dat ondersteuning biedt 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

Opmerkingen

Deze id wordt gebruikt door UI Automation clienttoepassingen. UI Automation providers moeten het equivalente veld in DockPatternIdentifiers gebruiken.

Deze eigenschap kan ook worden opgehaald uit de Current of Cached eigenschappen.

De standaardwaarde is None.