DockPattern.DockPositionProperty Campo
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í.
Identifica la propiedad DockPosition.
public: static initonly System::Windows::Automation::AutomationProperty ^ DockPositionProperty;public static readonly System.Windows.Automation.AutomationProperty DockPositionProperty; staticval mutable DockPositionProperty : System.Windows.Automation.AutomationPropertyPublic Shared ReadOnly DockPositionProperty As AutomationProperty Valor de campo
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>
/// 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
Comentarios
Este identificador lo usan las aplicaciones cliente de Automatización de la interfaz de usuario. Automatización de la interfaz de usuario proveedores deben usar el campo equivalente en DockPatternIdentifiers.
Esta propiedad también se puede recuperar de las Current propiedades o Cached .
El valor predeterminado es None.