DockPattern.DockPositionProperty DockPattern.DockPositionProperty DockPattern.DockPositionProperty DockPattern.DockPositionProperty Field

Définition

Identifie la propriété DockPosition.Identifies the DockPosition property.

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 

Valeur de champ

Exemples

Dans l’exemple suivant, un DockPosition valeur est obtenue, représentant la position d’ancrage actuelle pour un contrôle qui prend en charge DockPattern.In the following example, a DockPosition value is obtained representing the current dock position for a control that supports 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

Remarques

Cet identificateur est utilisé par les applications clientes UI Automation.This identifier is used by UI Automation client applications. Fournisseurs UI Automation doivent utiliser le champ équivalent dans DockPatternIdentifiers.UI Automation providers should use the equivalent field in DockPatternIdentifiers.

Cette propriété peut également être récupérée à partir de la Current ou Cached propriétés.This property can also be retrieved from the Current or Cached properties.

La valeur par défaut est None.The default value is None.

S’applique à