DockPattern.DockPositionProperty Campo

Definizione

Spazio dei nomi:

System.Windows.Automation

Assembly:

UIAutomationClient.dll

Identifica la proprietà 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 

Valore del campo

AutomationProperty

Esempio

Nell'esempio seguente viene ottenuto un DockPosition valore che rappresenta la posizione di ancoraggio corrente per un controllo che supporta 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

Commenti

Questo identificatore viene usato da Automazione interfaccia utente applicazioni client. Automazione interfaccia utente provider devono usare il campo equivalente in DockPatternIdentifiers.

Questa proprietà può essere recuperata anche dalle Current proprietà o Cached .

Il valore predefinito è None.