DockPattern.DockPatternInformation.DockPosition Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Recupera o DockPosition de um AutomationElement dentro de um contêiner de encaixe.
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 da propriedade
O DockPosition elemento, relativo aos limites do contêiner de encaixe e outros elementos dentro do contêiner.
Exemplos
No exemplo a seguir, um DockPosition valor é obtido representando a posição atual do dock para um controle compatível 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
Comentários
Um contêiner de encaixe é um controle que permite a disposição de elementos filho, horizontal e verticalmente, em relação aos limites do contêiner de encaixe e outros elementos dentro do contêiner.
O valor padrão é None.