DockPattern.DockPatternInformation.DockPosition Propiedad

Definición

Espacio de nombres:

System.Windows.Automation

Ensamblado:

UIAutomationClient.dll

Recupera la enumeración DockPosition de AutomationElement dentro de un contenedor de acoplamiento.

public:
 property System::Windows::Automation::DockPosition DockPosition { System::Windows::Automation::DockPosition get(); };

public System.Windows.Automation.DockPosition DockPosition { get; }

member this.DockPosition : System.Windows.Automation.DockPosition

Public ReadOnly Property DockPosition As DockPosition

Valor de propiedad

DockPosition

DockPosition del elemento, respecto a los límites del contenedor de acoplamiento y otros elementos del contenedor.

Ejemplos

En el ejemplo siguiente, se obtiene un DockPosition valor que representa la posición de acoplamiento actual de un control que admite DockPattern.

///--------------------------------------------------------------------
/// <summary>
/// Obtains a DockPattern control pattern from an 
/// automation element.
/// </summary>
/// <param name="targetControl">
/// The automation element of interest.
/// </param>
/// <returns>
/// A DockPattern object.
/// </returns>
///--------------------------------------------------------------------
private DockPattern GetDockPattern(
    AutomationElement targetControl)
{
    DockPattern dockPattern = null;

    try
    {
        dockPattern =
            targetControl.GetCurrentPattern(
            DockPattern.Pattern)
            as DockPattern;
    }
    // Object doesn't support the DockPattern control pattern
    catch (InvalidOperationException)
    {
        return null;
    }

    return dockPattern;
}

'''--------------------------------------------------------------------
''' <summary>
''' Obtains a DockPattern control pattern from an 
''' automation element.
''' </summary>
''' <param name="targetControl">
''' The automation element of interest.
''' </param>
''' <returns>
''' A DockPattern object.
''' </returns>
'''--------------------------------------------------------------------
Private Function GetDockPattern( _
ByVal targetControl As AutomationElement) As DockPattern
    Dim dockPattern As DockPattern = Nothing

    Try
        dockPattern = DirectCast( _
        targetControl.GetCurrentPattern(dockPattern.Pattern), _
        DockPattern)
    Catch exc As InvalidOperationException
        ' Object doesn't support the DockPattern control pattern
        Return Nothing
    End Try

    Return dockPattern

End Function 'GetDockPattern

///--------------------------------------------------------------------
/// <summary>
/// Gets the current view identifier from a target.
/// </summary>
/// <param name="dockPattern">
/// The control pattern of interest.
/// </param>
/// <returns>
/// The current dock position.
/// </returns>
///--------------------------------------------------------------------
private DockPosition GetCurrentDockPosition(
    DockPattern dockPattern)
{
    if (dockPattern == null)
    {
        throw new ArgumentNullException(
            "DockPattern parameter must not be null.");
    }

    return dockPattern.Current.DockPosition;
}

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

    Return dockPattern.Current.DockPosition

End Function 'GetCurrentDockPosition

Comentarios

Un contenedor de acoplamiento es un control que permite la disposición de elementos secundarios, tanto horizontal como verticalmente, en relación con los límites del contenedor de acoplamiento y otros elementos dentro del contenedor.

El valor predeterminado es None.