DockPattern.DockPatternInformation.DockPosition Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.DockPositionPublic ReadOnly Property DockPosition As DockPositionValor de propiedad
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.