DockPattern.DockPositionProperty Fält
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Identifierar egenskapen DockPosition .
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
Fältvärde
Exempel
I följande exempel hämtas ett DockPosition värde som representerar den aktuella dockningspositionen för en kontroll som stöder 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
Kommentarer
Den här identifieraren används av UI Automation klientprogram. UI Automation providers bör använda motsvarande fält i DockPatternIdentifiers.
Den här egenskapen kan också hämtas från Current egenskaperna eller Cached .
Standardvärdet är None.