DockPattern.DockPositionProperty Pole
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Identifikuje DockPosition vlastnost.
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
Hodnota pole
Příklady
V následujícím příkladu DockPosition se získá hodnota představující aktuální pozici docku pro ovládací prvek, který podporuje 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
Poznámky
Tento identifikátor používá model UI Automation klientských aplikací. model UI Automation poskytovatelé by měli použít ekvivalentní pole v DockPatternIdentifierssouboru .
Tuto vlastnost lze také načíst z Current vlastností nebo Cached vlastností.
Výchozí hodnota je None.