AutomationPeer AutomationPeer AutomationPeer Class

Provides a base class that exposes the automation peer for an associated owner class to Microsoft UI Automation.

Syntax

Declaration

public class AutomationPeerpublic class AutomationPeerPublic Class AutomationPeer

Inheritance Hierarchy

Remarks

AutomationPeer is the class that provides almost all of the API that eventually forwards the Microsoft UI Automation information for a Windows Store app using C++, C#, or Visual Basic to a Microsoft UI Automation client. Typical Microsoft UI Automation clients aren't calling AutomationPeer methods directly. These clients are often assistive technology that are using other programming models and operating as services, and are not likely to be calling Windows Runtime methods. But the general Microsoft UI Automation support in the Windows Runtime forwards all this information using the provider side of the Microsoft UI Automation framework. Any clients to Microsoft UI Automation can interact with the representative automation trees of a Windows Store app using C++, C#, or Visual Basic.

Firing automation events

The AutomationPeer class is relevant to Windows Runtime control authors because you will have a peer instance available at run time, after the runtime invokes the OnCreateAutomationPeer() method. Using this peer, you can fire automation events by calling RaiseAutomationEvent(Windows.UI.Xaml.Automation.Peers.AutomationEvents) and RaisePropertyChangedEvent(Windows.UI.Xaml.Automation.AutomationProperty,System.Object,System.Object). You would do this whenever a related property in the peer's owner (your class) changes, or when firing an event is needed for correct automation support.

The automation support design doesn't retain a handle to your own peer as part of how you implement OnCreateAutomationPeer(), because there aren't any guarantees of when the peer is actually created. Instead, you can check for run-time automation event listeners inside your control class definitions just-in-time, using code like this:```csharp if (AutomationPeer.ListenerExists(AutomationEvents.PropertyChanged)) { MyAutomationPeer peer = FrameworkElementAutomationPeer.FromElement(myCtrl) as MyAutomationPeer;

if (peer != null)
{
    peer.RaisePropertyChangedEvent(
        RangeValuePatternIdentifiers.ValueProperty,
        (double)oldValue,
        (double)newValue);
}

}


```vbnet
If AutomationPeer.ListenerExists(AutomationEvents.PropertyChanged) Then
    Dim peer As MyAutomationPeer = _
    TryCast(FrameworkElementAutomationPeer.FromElement(myCtrl), MyAutomationPeer)
    If peer IsNot Nothing Then
        peer.RaisePropertyChangedEvent(RangeValuePatternIdentifiers.ValueProperty, CDbl(oldValue), CDbl(newValue))
    End If
End If

AutomationPeer derived classes

AutomationPeer is in the hierarchy for all the existing peers for the Windows Runtime controls and related UI classes.

Classes that directly derive from AutomationPeer are:

Core methods

The "Core" methods are the standard implementations that perform the default action of an associated Microsoft UI Automation client-callable method. You can override any of the "Core" methods to return alternative values in a custom automation peer. For example, GetAcceleratorKeyCore() is invoked any time that GetAcceleratorKey() is called, GetAccessKeyCore() is invoked any time that GetAccessKey() is called, and so on.

The base implementation for AutomationPeer returns null. Peers that represent items may defer the result to their container.

Constructors summary

Provides base class initialization behavior for AutomationPeer derived classes.

Properties summary

Gets or sets an AutomationPeer that is reported to the automation client as the source for all the events that come from this AutomationPeer. See Remarks.

Methods summary

Generates a runtime identifier for the element that is associated with the automation peer.

Gets the accelerator key combinations for the object that is associated with the UI Automation peer.

Gets the access key for the element that is associated with the automation peer.

Gets a reference to the list of UI automation annotations for the current automation peer.

Gets the control type for the element that is associated with the UI Automation peer.

Gets the AutomationId of the element that is associated with the automation peer.

Gets the Rect object that represents the screen coordinates of the element that is associated with the automation peer.

Gets the collection of child elements that are represented in the UI Automation tree as immediate child elements of the automation peer.

Gets a name that is used with AutomationControlType, to differentiate the control that is represented by this AutomationPeer.

Gets a point on the element that is associated with the automation peer that responds to a mouse click.

Provides the peer's behavior when a Microsoft UI Automation client calls GetControlledPeers() or an equivalent Microsoft UI Automation client API such as getting a property value as identified by UIA_ControllerForPropertyId.

Prerelease. Calls GetCultureCore() to get the culture value for the element that is associated with the automation peer.

Gets an element from the specified point.

Gets the element that currently has the focus.

Gets a localized string that describes the actual visual appearance or contents of something such as an image or image control.

Gets text that describes the functionality of the control that is associated with the automation peer.

Gets text that conveys the visual status of the element that is associated with this automation peer.

Gets a string that describes what kind of item an element represents.

Gets the AutomationPeer for the UIElement that is targeted to the element.

Gets the landmark type for this automation peer.

Returns the 1-based integer for the level (hierarchy) of the element that is associated with the automation peer.

Gets the live setting notification behavior information for the object that is associated with the UI Automation peer.

Gets a localized string that represents the AutomationControlType value for the control that is associated with this automation peer.

Gets a localized string that represents the AutomationLandmarkType value for the element that is associated with this automation peer.

Gets text that describes the element that is associated with this automation peer. The Microsoft UI Automation Name value is the primary identifier used by most assistive technology when they represent your app's UI by interacting with the Microsoft UI Automation framework.

Gets a value that indicates the explicit control orientation, if any.

Gets the AutomationPeer that is the parent of this AutomationPeer.

Gets the control pattern that is associated with the specified PatternInterface.

Gets an AutomationPeer from the specified point.

Returns the 1-based integer for the ordinal position in the set for the element that is associated with the automation peer.

Returns the 1-based integer for the size of the set where the element that is associated with the automation peer is located.

Gets a value that indicates whether the element that is associated with this automation peer currently has keyboard focus.

Triggers recalculation of the main properties of the AutomationPeer and raises the RaisePropertyChangedEvent(Windows.UI.Xaml.Automation.AutomationProperty,System.Object,System.Object) notification to the automation client if the properties have changed.

Gets a value that indicates whether the element that is associated with this automation peer contains data that is presented to the user.

Gets a value that indicates whether the element is understood by the user as interactive or as contributing to the logical structure of the control in the GUI.

Gets a Boolean value that indicates whether the entered or selected value is valid for the form rule associated with the automation element.

Gets a value that indicates whether the element associated with this automation peer supports interaction.

Gets a value that indicates whether the element can accept keyboard focus.

Gets a value that indicates whether an element is off the screen.

Gets a value that indicates whether the element contains sensitive content.

Gets a Boolean value that indicates whether the automation element represents peripheral UI.

Gets a value that indicates whether the element that is associated with this peer must be completed on a form.

Gets a value that indicates whether Microsoft UI Automation reports that a client is listening for the specified event.

Gets the element in the specified direction within the UI automation tree.

Raises an automation event.

Raises an event to notify the automation client of a changed property value.

Raises an event to notify the Microsoft UI Automation core that the tree structure has changed.

Raises an event to notify the Microsoft UI Automation core that a text control has programmatically changed text.

Sets the keyboard focus on the element that is associated with this automation peer.

Sets the AutomationPeer that is the parent of this AutomationPeer.

Shows the available context menu for the owner element.

Provides the peer's behavior when a Microsoft UI Automation client calls GetAcceleratorKey() or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls GetAccessKey() or an equivalent Microsoft UI Automation client API.

Provides the behavior of the peer when a Microsoft UI Automation client calls GetAnnotations() or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls GetAutomationControlType() or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls GetAutomationId() or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls GetBoundingRectangle() or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls GetChildren() or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls GetClassName() or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls GetClickablePoint() or an equivalent Microsoft UI Automation client API.

Gets a list of the controlled peers for the current automation peer.

Provides the behavior of the peer when a Microsoft UI Automation client calls GetElementFromPoint(Windows.Foundation.Point) or an equivalent Microsoft UI Automation client API.

Provides the behavior of the peer when a Microsoft UI Automation client calls GetFocusedElement() or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls GetHelpText() or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls GetItemStatus() or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls GetItemType() or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls GetLabeledBy() or an equivalent Microsoft UI Automation client API.

Provides the behavior of the peer when a Microsoft UI Automation client calls GetLevel() or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls GetLiveSetting() or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls GetLocalizedControlType() or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls GetName() or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls GetOrientation() or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls GetPattern(Windows.UI.Xaml.Automation.Peers.PatternInterface) or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls GetPeerFromPoint(Windows.Foundation.Point) or an equivalent Microsoft UI Automation client API.

Provides the peer’s behavior when a Microsoft UI Automation client calls GetPositionInSet() or an equivalent Microsoft UI Automation client API.

Provides the peer’s behavior when a Microsoft UI Automation client calls GetSizeOfSet() or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls HasKeyboardFocus() or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls IsContentElement() or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls IsControlElement() or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls IsEnabled() or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls IsKeyboardFocusable() or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls IsOffscreen() or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls IsPassword() or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls IsRequiredForForm() or an equivalent Microsoft UI Automation client API.

Provides the peer’s behavior when a Microsoft UI Automation client calls Navigate(Windows.UI.Xaml.Automation.Peers.AutomationNavigationDirection) or an equivalent Microsoft UI Automation client API.

Gets an AutomationPeer for the specified IRawElementProviderSimple proxy.

Gets the IRawElementProviderSimple proxy for the specified AutomationPeer.

Provides the peer's behavior when a Microsoft UI Automation client calls SetFocus() or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls ShowContextMenu() or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls GetLandmarkType() or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls GetLocalizedLandmarkType() or an equivalent Microsoft UI Automation client API.

Gets a collection of elements that provide more information about the automation element.

Provides the peer's behavior when a Microsoft UI Automation client calls GetFlowsFrom(Windows.UI.Xaml.DependencyObject) or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls GetFlowsTo(Windows.UI.Xaml.DependencyObject) or an equivalent Microsoft UI Automation client API.

Provides the peer's behavior when a Microsoft UI Automation client calls GetFullDescription() or an equivalent Microsoft UI Automation client API.

Provides the peer’s behavior when a Microsoft UI Automation client accesses IsDataValidForForm() or an equivalent Microsoft UI Automation client API.

Provides the peer’s behavior when a Microsoft UI Automation client accesses IsPeripheral() or an equivalent Microsoft UI Automation client API.

Gets the culture value for the element that is associated with the automation peer.

Constructors

  • AutomationPeer()
    AutomationPeer()
    AutomationPeer()
    AutomationPeer()

    Provides base class initialization behavior for AutomationPeer derived classes.

    protected AutomationPeer()protected AutomationPeer()Protected Function AutomationPeer() As

Properties

  • EventsSource
    EventsSource
    EventsSource
    EventsSource

    Gets or sets an AutomationPeer that is reported to the automation client as the source for all the events that come from this AutomationPeer. See Remarks.

    public AutomationPeer EventsSource { get; set; }public AutomationPeer EventsSource { get; set; }Public ReadWrite Property EventsSource As AutomationPeer

    Property Value

    Remarks

    EventsSource is typically set by AutomationPeer implementations in cases where the automation provider element is a child element of another element that also has a peer, and the best automation experience for clients is to treat the parent as the source for automation events. In such cases, the child element's peer implementation sets EventsSource to return the AutomationPeer of the parent element.

Methods

  • GenerateRawElementProviderRuntimeId()
    GenerateRawElementProviderRuntimeId()
    GenerateRawElementProviderRuntimeId()
    GenerateRawElementProviderRuntimeId()

    Generates a runtime identifier for the element that is associated with the automation peer.

    public static RawElementProviderRuntimeId GenerateRawElementProviderRuntimeId()public static RawElementProviderRuntimeId GenerateRawElementProviderRuntimeId()Public Static Function GenerateRawElementProviderRuntimeId() As RawElementProviderRuntimeId

    Returns

  • GetAcceleratorKey()
    GetAcceleratorKey()
    GetAcceleratorKey()
    GetAcceleratorKey()

    Gets the accelerator key combinations for the object that is associated with the UI Automation peer.

    public string GetAcceleratorKey()public string GetAcceleratorKey()Public Function GetAcceleratorKey() As string

    Returns

    • string
      string
      string

      The accelerator key.

  • GetAccessKey()
    GetAccessKey()
    GetAccessKey()
    GetAccessKey()

    Gets the access key for the element that is associated with the automation peer.

    public string GetAccessKey()public string GetAccessKey()Public Function GetAccessKey() As string

    Returns

    • string
      string
      string

      The access key.

  • GetAnnotations()
    GetAnnotations()
    GetAnnotations()
    GetAnnotations()

    Gets a reference to the list of UI automation annotations for the current automation peer.

    public IVector<AutomationPeerAnnotation> GetAnnotations()public IVector<AutomationPeerAnnotation> GetAnnotations()Public Function GetAnnotations() As IVector( Of AutomationPeerAnnotation )

    Returns

    • The list of UI automation annotations.

  • GetAutomationControlType()
    GetAutomationControlType()
    GetAutomationControlType()
    GetAutomationControlType()

    Gets the control type for the element that is associated with the UI Automation peer.

    public AutomationControlType GetAutomationControlType()public AutomationControlType GetAutomationControlType()Public Function GetAutomationControlType() As AutomationControlType

    Returns

  • GetAutomationId()
    GetAutomationId()
    GetAutomationId()
    GetAutomationId()

    Gets the AutomationId of the element that is associated with the automation peer.

    public string GetAutomationId()public string GetAutomationId()Public Function GetAutomationId() As string

    Returns

    • string
      string
      string

      The automation identifier.

  • GetBoundingRectangle()
    GetBoundingRectangle()
    GetBoundingRectangle()
    GetBoundingRectangle()

    Gets the Rect object that represents the screen coordinates of the element that is associated with the automation peer.

    public Rect GetBoundingRectangle()public Rect GetBoundingRectangle()Public Function GetBoundingRectangle() As Rect

    Returns

  • GetChildren()
    GetChildren()
    GetChildren()
    GetChildren()

    Gets the collection of child elements that are represented in the UI Automation tree as immediate child elements of the automation peer.

    public IVector<AutomationPeer> GetChildren()public IVector<AutomationPeer> GetChildren()Public Function GetChildren() As IVector( Of AutomationPeer )

    Returns

  • GetClassName()
    GetClassName()
    GetClassName()
    GetClassName()

    Gets a name that is used with AutomationControlType, to differentiate the control that is represented by this AutomationPeer.

    public string GetClassName()public string GetClassName()Public Function GetClassName() As string

    Returns

    • string
      string
      string

      The class name.

  • GetClickablePoint()
    GetClickablePoint()
    GetClickablePoint()
    GetClickablePoint()

    Gets a point on the element that is associated with the automation peer that responds to a mouse click.

    public Point GetClickablePoint()public Point GetClickablePoint()Public Function GetClickablePoint() As Point

    Returns

  • GetControlledPeers()
    GetControlledPeers()
    GetControlledPeers()
    GetControlledPeers()

    Provides the peer's behavior when a Microsoft UI Automation client calls GetControlledPeers() or an equivalent Microsoft UI Automation client API such as getting a property value as identified by UIA_ControllerForPropertyId.

    public IVectorView<AutomationPeer> GetControlledPeers()public IVectorView<AutomationPeer> GetControlledPeers()Public Function GetControlledPeers() As IVectorView( Of AutomationPeer )

    Returns

    • A list of the controlled peers for the current automation peer.

    Remarks

    Examining controlled peers is an advanced scenario that most peer implementations won't need to use.

    The naming of the framework implementation and the Microsoft UI Automation property that clients can use to access this info are slightly different. Microsoft UI Automation clients should use the identifier UIA_ControllerForPropertyId to request the value of this property when using the Microsoft UI Automation client interfaces such as IUIAutomation.

  • GetCulture()
    GetCulture()
    GetCulture()
    GetCulture()

    Prerelease. Calls GetCultureCore() to get the culture value for the element that is associated with the automation peer.

    public int GetCulture()public int GetCulture()Public Function GetCulture() As int

    Returns

    • int
      int
      int

      The value of the culture property for the element that is associated with the automation peer.

  • GetElementFromPoint(Windows.Foundation.Point)
    GetElementFromPoint(Windows.Foundation.Point)
    GetElementFromPoint(Windows.Foundation.Point)
    GetElementFromPoint(Windows.Foundation.Point)

    Gets an element from the specified point.

    public object GetElementFromPoint(Windows.Foundation.Point pointInWindowCoordinates)public object GetElementFromPoint(Windows.Foundation.Point pointInWindowCoordinates)Public Function GetElementFromPoint(pointInWindowCoordinates As Windows.Foundation.Point) As object

    Parameters

    Returns

    • object
      object
      object

      The element at the specified point.

  • GetFocusedElement()
    GetFocusedElement()
    GetFocusedElement()
    GetFocusedElement()

    Gets the element that currently has the focus.

    public object GetFocusedElement()public object GetFocusedElement()Public Function GetFocusedElement() As object

    Returns

    • object
      object
      object

      The element that currently has the focus.

  • GetFullDescription()
    GetFullDescription()
    GetFullDescription()
    GetFullDescription()

    Gets a localized string that describes the actual visual appearance or contents of something such as an image or image control.

    public string GetFullDescription()public string GetFullDescription()Public Function GetFullDescription() As string

    Returns

    • string
      string
      string

      A localized string that describes the actual visual appearance or contents of something such as an image or image control.

  • GetHelpText()
    GetHelpText()
    GetHelpText()
    GetHelpText()

    Gets text that describes the functionality of the control that is associated with the automation peer.

    public string GetHelpText()public string GetHelpText()Public Function GetHelpText() As string

    Returns

    • string
      string
      string

      The help text.

  • GetItemStatus()
    GetItemStatus()
    GetItemStatus()
    GetItemStatus()

    Gets text that conveys the visual status of the element that is associated with this automation peer.

    public string GetItemStatus()public string GetItemStatus()Public Function GetItemStatus() As string

    Returns

    • string
      string
      string

      The item status.

  • GetItemType()
    GetItemType()
    GetItemType()
    GetItemType()

    Gets a string that describes what kind of item an element represents.

    public string GetItemType()public string GetItemType()Public Function GetItemType() As string

    Returns

    • string
      string
      string

      The kind of item.

  • GetLabeledBy()
    GetLabeledBy()
    GetLabeledBy()
    GetLabeledBy()

    Gets the AutomationPeer for the UIElement that is targeted to the element.

    public AutomationPeer GetLabeledBy()public AutomationPeer GetLabeledBy()Public Function GetLabeledBy() As AutomationPeer

    Returns

  • GetLandmarkType()
    GetLandmarkType()
    GetLandmarkType()
    GetLandmarkType()

    Gets the landmark type for this automation peer.

    public AutomationLandmarkType GetLandmarkType()public AutomationLandmarkType GetLandmarkType()Public Function GetLandmarkType() As AutomationLandmarkType

    Returns

  • GetLevel()
    GetLevel()
    GetLevel()
    GetLevel()

    Returns the 1-based integer for the level (hierarchy) of the element that is associated with the automation peer.

    public int GetLevel()public int GetLevel()Public Function GetLevel() As int

    Returns

    • int
      int
      int

      The 1-based integer for the level of the element.

  • GetLiveSetting()
    GetLiveSetting()
    GetLiveSetting()
    GetLiveSetting()

    Gets the live setting notification behavior information for the object that is associated with the UI Automation peer.

    public AutomationLiveSetting GetLiveSetting()public AutomationLiveSetting GetLiveSetting()Public Function GetLiveSetting() As AutomationLiveSetting

    Returns

  • GetLocalizedControlType()
    GetLocalizedControlType()
    GetLocalizedControlType()
    GetLocalizedControlType()

    Gets a localized string that represents the AutomationControlType value for the control that is associated with this automation peer.

    public string GetLocalizedControlType()public string GetLocalizedControlType()Public Function GetLocalizedControlType() As string

    Returns

    • string
      string
      string

      The type of the control.

  • GetLocalizedLandmarkType()
    GetLocalizedLandmarkType()
    GetLocalizedLandmarkType()
    GetLocalizedLandmarkType()

    Gets a localized string that represents the AutomationLandmarkType value for the element that is associated with this automation peer.

    public string GetLocalizedLandmarkType()public string GetLocalizedLandmarkType()Public Function GetLocalizedLandmarkType() As string

    Returns

    • string
      string
      string

      The landmark type of the element.

  • GetName()
    GetName()
    GetName()
    GetName()

    Gets text that describes the element that is associated with this automation peer. The Microsoft UI Automation Name value is the primary identifier used by most assistive technology when they represent your app's UI by interacting with the Microsoft UI Automation framework.

    public string GetName()public string GetName()Public Function GetName() As string

    Returns

    • string
      string
      string

      The name of the element that is the peer's owner, as used by assistive technology and other Microsoft UI Automation clients.

    Remarks

    FrameworkElementAutomationPeer introduces behavior to GetName() by providing an intermediate GetNameCore() implementation. If an element has a value for the LabeledByMicrosoft UI Automation property, the labeling element's Name value is used as the Name.

    FrameworkElementAutomationPeer also introduces behavior through an internal GetPlainText method that other default peer classes may override in order to access the content model of that control and return a useful default for Name. For example, any ContentControl derived class will use a string representation of its Content value as the default Name. This is enabled because internally ContentControl implements GetPlainText and imparts that behavior to all ContentControl derived classes. This is how you get a useful Name default from the string value of a Button, for example.

    Other specific peers also may have an intermediate GetNameCore() implementation that provides a useful way for that particular Windows Runtime control to provide built-in values for Name. The source of these values comes from other UI properties that are typically set in XAML or as app user code. For example, TextBoxAutomationPeer implements behavior that uses the value of the Text property from the owner TextBox as the default Name. From the user code perspective, the default behavior can be overridden by applying a different NameProperty value. From the peer implementer / provider perspective, the default behavior of the peer can be changed by deriving a new peer class from the existing peer, overriding GetNameCore(), and giving it a new implementation that wouldn't call the base implementation in at least some cases.

    To learn more about the possible default behavior of specific peer classes for default Windows Runtime controls, see the reference topic for that particular peer class and look for implementation notes in the Remarks section.

  • GetOrientation()
    GetOrientation()
    GetOrientation()
    GetOrientation()

    Gets a value that indicates the explicit control orientation, if any.

    public AutomationOrientation GetOrientation()public AutomationOrientation GetOrientation()Public Function GetOrientation() As AutomationOrientation

    Returns

  • GetParent()
    GetParent()
    GetParent()
    GetParent()

    Gets the AutomationPeer that is the parent of this AutomationPeer.

    public AutomationPeer GetParent()public AutomationPeer GetParent()Public Function GetParent() As AutomationPeer

    Returns

  • GetPattern(Windows.UI.Xaml.Automation.Peers.PatternInterface)
    GetPattern(Windows.UI.Xaml.Automation.Peers.PatternInterface)
    GetPattern(Windows.UI.Xaml.Automation.Peers.PatternInterface)
    GetPattern(Windows.UI.Xaml.Automation.Peers.PatternInterface)

    Gets the control pattern that is associated with the specified PatternInterface.

    public object GetPattern(Windows.UI.Xaml.Automation.Peers.PatternInterface patternInterface)public object GetPattern(Windows.UI.Xaml.Automation.Peers.PatternInterface patternInterface)Public Function GetPattern(patternInterface As Windows.UI.Xaml.Automation.Peers.PatternInterface) As object

    Parameters

    Returns

    • object
      object
      object

      The object that implements the pattern interface; null if the peer does not support this interface.

  • GetPeerFromPoint(Windows.Foundation.Point)
    GetPeerFromPoint(Windows.Foundation.Point)
    GetPeerFromPoint(Windows.Foundation.Point)
    GetPeerFromPoint(Windows.Foundation.Point)

    Gets an AutomationPeer from the specified point.

    public AutomationPeer GetPeerFromPoint(Windows.Foundation.Point point)public AutomationPeer GetPeerFromPoint(Windows.Foundation.Point point)Public Function GetPeerFromPoint(point As Windows.Foundation.Point) As AutomationPeer

    Parameters

    • point

      The relative position of the target UI element in the UI.

    Returns

    Remarks

    This method is a utility for hit testing practical UI coordinates, evaluating the corresponding UI element, and returning the peer that corresponds to the hit-tested UI element.

  • GetPositionInSet()
    GetPositionInSet()
    GetPositionInSet()
    GetPositionInSet()

    Returns the 1-based integer for the ordinal position in the set for the element that is associated with the automation peer.

    public int GetPositionInSet()public int GetPositionInSet()Public Function GetPositionInSet() As int

    Returns

    • int
      int
      int

      The 1-based integer for the ordinal position in the set.

  • GetSizeOfSet()
    GetSizeOfSet()
    GetSizeOfSet()
    GetSizeOfSet()

    Returns the 1-based integer for the size of the set where the element that is associated with the automation peer is located.

    public int GetSizeOfSet()public int GetSizeOfSet()Public Function GetSizeOfSet() As int

    Returns

    • int
      int
      int

      The 1-based integer for the size of the set.

  • HasKeyboardFocus()
    HasKeyboardFocus()
    HasKeyboardFocus()
    HasKeyboardFocus()

    Gets a value that indicates whether the element that is associated with this automation peer currently has keyboard focus.

    public bool HasKeyboardFocus()public bool HasKeyboardFocus()Public Function HasKeyboardFocus() As bool

    Returns

    • bool
      bool
      bool

      true if the element has keyboard focus; otherwise, false.

  • InvalidatePeer()
    InvalidatePeer()
    InvalidatePeer()
    InvalidatePeer()

    Triggers recalculation of the main properties of the AutomationPeer and raises the RaisePropertyChangedEvent(Windows.UI.Xaml.Automation.AutomationProperty,System.Object,System.Object) notification to the automation client if the properties have changed.

    public void InvalidatePeer()public void InvalidatePeer()Public Function InvalidatePeer() As void
  • IsContentElement()
    IsContentElement()
    IsContentElement()
    IsContentElement()

    Gets a value that indicates whether the element that is associated with this automation peer contains data that is presented to the user.

    public bool IsContentElement()public bool IsContentElement()Public Function IsContentElement() As bool

    Returns

    • bool
      bool
      bool

      true if the element is a content element; otherwise, false.

  • IsControlElement()
    IsControlElement()
    IsControlElement()
    IsControlElement()

    Gets a value that indicates whether the element is understood by the user as interactive or as contributing to the logical structure of the control in the GUI.

    public bool IsControlElement()public bool IsControlElement()Public Function IsControlElement() As bool

    Returns

    • bool
      bool
      bool

      true if the element is a control; otherwise, false.

  • IsDataValidForForm()
    IsDataValidForForm()
    IsDataValidForForm()
    IsDataValidForForm()

    Gets a Boolean value that indicates whether the entered or selected value is valid for the form rule associated with the automation element.

    public bool IsDataValidForForm()public bool IsDataValidForForm()Public Function IsDataValidForForm() As bool

    Returns

    • bool
      bool
      bool

      A Boolean value that indicates whether the entered or selected value is valid for the form rule associated with the automation element. The default return value is true.

    Remarks

    As an example, if the user entered "425-555-5555" for a zip code field that requires 5 or 9 digits, the IsDataValidForForm() property can be set to false to indicate that the data is not valid.

  • IsEnabled()
    IsEnabled()
    IsEnabled()
    IsEnabled()

    Gets a value that indicates whether the element associated with this automation peer supports interaction.

    public bool IsEnabled()public bool IsEnabled()Public Function IsEnabled() As bool

    Returns

    • bool
      bool
      bool

      true if the element supports interaction; otherwise, false.

  • IsKeyboardFocusable()
    IsKeyboardFocusable()
    IsKeyboardFocusable()
    IsKeyboardFocusable()

    Gets a value that indicates whether the element can accept keyboard focus.

    public bool IsKeyboardFocusable()public bool IsKeyboardFocusable()Public Function IsKeyboardFocusable() As bool

    Returns

    • bool
      bool
      bool

      true if the element can accept keyboard focus; otherwise, false.

  • IsOffscreen()
    IsOffscreen()
    IsOffscreen()
    IsOffscreen()

    Gets a value that indicates whether an element is off the screen.

    public bool IsOffscreen()public bool IsOffscreen()Public Function IsOffscreen() As bool

    Returns

    • bool
      bool
      bool

      true if the element is not on the screen; otherwise, false.

  • IsPassword()
    IsPassword()
    IsPassword()
    IsPassword()

    Gets a value that indicates whether the element contains sensitive content.

    public bool IsPassword()public bool IsPassword()Public Function IsPassword() As bool

    Returns

    • bool
      bool
      bool

      true if the element contains sensitive content such as a password; otherwise, false.

    Remarks

    This property enables applications such as screen readers to determine whether the text content of a control should be read aloud.

  • IsPeripheral()
    IsPeripheral()
    IsPeripheral()
    IsPeripheral()

    Gets a Boolean value that indicates whether the automation element represents peripheral UI.

    public bool IsPeripheral()public bool IsPeripheral()Public Function IsPeripheral() As bool

    Returns

    • bool
      bool
      bool

      A Boolean value that indicates whether the automation element represents peripheral UI.

    Remarks

    Peripheral UI appears and supports user interaction, but does not take keyboard focus when it appears. Examples of peripheral UI include popups, flyouts, context menus, or floating notifications.

  • IsRequiredForForm()
    IsRequiredForForm()
    IsRequiredForForm()
    IsRequiredForForm()

    Gets a value that indicates whether the element that is associated with this peer must be completed on a form.

    public bool IsRequiredForForm()public bool IsRequiredForForm()Public Function IsRequiredForForm() As bool

    Returns

    • bool
      bool
      bool

      true if the element must be completed; otherwise, false.

  • ListenerExists(Windows.UI.Xaml.Automation.Peers.AutomationEvents)
    ListenerExists(Windows.UI.Xaml.Automation.Peers.AutomationEvents)
    ListenerExists(Windows.UI.Xaml.Automation.Peers.AutomationEvents)
    ListenerExists(Windows.UI.Xaml.Automation.Peers.AutomationEvents)

    Gets a value that indicates whether Microsoft UI Automation reports that a client is listening for the specified event.

    public static bool ListenerExists(Windows.UI.Xaml.Automation.Peers.AutomationEvents eventId)public static bool ListenerExists(Windows.UI.Xaml.Automation.Peers.AutomationEvents eventId)Public Static Function ListenerExists(eventId As Windows.UI.Xaml.Automation.Peers.AutomationEvents) As bool

    Parameters

    Returns

    • bool
      bool
      bool

      true if Microsoft UI Automation reports a client is listening for the specified event; otherwise, false.

  • Navigate(Windows.UI.Xaml.Automation.Peers.AutomationNavigationDirection)
    Navigate(Windows.UI.Xaml.Automation.Peers.AutomationNavigationDirection)
    Navigate(Windows.UI.Xaml.Automation.Peers.AutomationNavigationDirection)
    Navigate(Windows.UI.Xaml.Automation.Peers.AutomationNavigationDirection)

    Gets the element in the specified direction within the UI automation tree.

    public object Navigate(Windows.UI.Xaml.Automation.Peers.AutomationNavigationDirection direction)public object Navigate(Windows.UI.Xaml.Automation.Peers.AutomationNavigationDirection direction)Public Function Navigate(direction As Windows.UI.Xaml.Automation.Peers.AutomationNavigationDirection) As object

    Parameters

    Returns

    • object
      object
      object

      The element in the specified direction within the UI automation tree.

  • RaiseAutomationEvent(Windows.UI.Xaml.Automation.Peers.AutomationEvents)
    RaiseAutomationEvent(Windows.UI.Xaml.Automation.Peers.AutomationEvents)
    RaiseAutomationEvent(Windows.UI.Xaml.Automation.Peers.AutomationEvents)
    RaiseAutomationEvent(Windows.UI.Xaml.Automation.Peers.AutomationEvents)

    Raises an automation event.

    public void RaiseAutomationEvent(Windows.UI.Xaml.Automation.Peers.AutomationEvents eventId)public void RaiseAutomationEvent(Windows.UI.Xaml.Automation.Peers.AutomationEvents eventId)Public Function RaiseAutomationEvent(eventId As Windows.UI.Xaml.Automation.Peers.AutomationEvents) As void

    Parameters

  • RaisePropertyChangedEvent(Windows.UI.Xaml.Automation.AutomationProperty,System.Object,System.Object)
    RaisePropertyChangedEvent(Windows.UI.Xaml.Automation.AutomationProperty,System.Object,System.Object)
    RaisePropertyChangedEvent(Windows.UI.Xaml.Automation.AutomationProperty,System.Object,System.Object)
    RaisePropertyChangedEvent(Windows.UI.Xaml.Automation.AutomationProperty,System.Object,System.Object)

    Raises an event to notify the automation client of a changed property value.

    public void RaisePropertyChangedEvent(Windows.UI.Xaml.Automation.AutomationProperty automationProperty,System.Object oldValue,System.Object newValue)public void RaisePropertyChangedEvent(Windows.UI.Xaml.Automation.AutomationProperty automationProperty,System.Object oldValue,System.Object newValue)Public Function RaisePropertyChangedEvent(automationProperty As Windows.UI.Xaml.Automation.AutomationProperty,oldValue As System.Object,newValue As System.Object) As void

    Parameters

    • automationProperty

      The property that changed.

    • oldValue
      System.Object
      System.Object
      System.Object

      The previous value of the property.

    • newValue
      System.Object
      System.Object
      System.Object

      The new value of the property.

  • RaiseStructureChangedEvent(Windows.UI.Xaml.Automation.Peers.AutomationStructureChangeType,Windows.UI.Xaml.Automation.Peers.AutomationPeer)
    RaiseStructureChangedEvent(Windows.UI.Xaml.Automation.Peers.AutomationStructureChangeType,Windows.UI.Xaml.Automation.Peers.AutomationPeer)
    RaiseStructureChangedEvent(Windows.UI.Xaml.Automation.Peers.AutomationStructureChangeType,Windows.UI.Xaml.Automation.Peers.AutomationPeer)
    RaiseStructureChangedEvent(Windows.UI.Xaml.Automation.Peers.AutomationStructureChangeType,Windows.UI.Xaml.Automation.Peers.AutomationPeer)

    Raises an event to notify the Microsoft UI Automation core that the tree structure has changed.

    public void RaiseStructureChangedEvent(Windows.UI.Xaml.Automation.Peers.AutomationStructureChangeType structureChangeType,Windows.UI.Xaml.Automation.Peers.AutomationPeer child)public void RaiseStructureChangedEvent(Windows.UI.Xaml.Automation.Peers.AutomationStructureChangeType structureChangeType,Windows.UI.Xaml.Automation.Peers.AutomationPeer child)Public Function RaiseStructureChangedEvent(structureChangeType As Windows.UI.Xaml.Automation.Peers.AutomationStructureChangeType,child As Windows.UI.Xaml.Automation.Peers.AutomationPeer) As void

    Parameters

  • RaiseTextEditTextChangedEvent(Windows.UI.Xaml.Automation.AutomationTextEditChangeType,Windows.Foundation.Collections.IVectorView{System.String})
    RaiseTextEditTextChangedEvent(Windows.UI.Xaml.Automation.AutomationTextEditChangeType,Windows.Foundation.Collections.IVectorView{System.String})
    RaiseTextEditTextChangedEvent(Windows.UI.Xaml.Automation.AutomationTextEditChangeType,Windows.Foundation.Collections.IVectorView{System.String})
    RaiseTextEditTextChangedEvent(Windows.UI.Xaml.Automation.AutomationTextEditChangeType,Windows.Foundation.Collections.IVectorView{System.String})

    Raises an event to notify the Microsoft UI Automation core that a text control has programmatically changed text.

    public void RaiseTextEditTextChangedEvent(Windows.UI.Xaml.Automation.AutomationTextEditChangeType automationTextEditChangeType,Windows.Foundation.Collections.IVectorView{System.String} changedData)public void RaiseTextEditTextChangedEvent(Windows.UI.Xaml.Automation.AutomationTextEditChangeType automationTextEditChangeType,Windows.Foundation.Collections.IVectorView{System.String} changedData)Public Function RaiseTextEditTextChangedEvent(automationTextEditChangeType As Windows.UI.Xaml.Automation.AutomationTextEditChangeType,changedData As Windows.Foundation.Collections.IVectorView{System.String}) As void

    Parameters

  • SetFocus()
    SetFocus()
    SetFocus()
    SetFocus()

    Sets the keyboard focus on the element that is associated with this automation peer.

    public void SetFocus()public void SetFocus()Public Function SetFocus() As void
  • SetParent(Windows.UI.Xaml.Automation.Peers.AutomationPeer)
    SetParent(Windows.UI.Xaml.Automation.Peers.AutomationPeer)
    SetParent(Windows.UI.Xaml.Automation.Peers.AutomationPeer)
    SetParent(Windows.UI.Xaml.Automation.Peers.AutomationPeer)

    Sets the AutomationPeer that is the parent of this AutomationPeer.

    public void SetParent(Windows.UI.Xaml.Automation.Peers.AutomationPeer peer)public void SetParent(Windows.UI.Xaml.Automation.Peers.AutomationPeer peer)Public Function SetParent(peer As Windows.UI.Xaml.Automation.Peers.AutomationPeer) As void

    Parameters

    Remarks

    You can't re-parent an AutomationPeer for a Windows Store app. This functionality is only available for a Windows Phone Store app.

  • ShowContextMenu()
    ShowContextMenu()
    ShowContextMenu()
    ShowContextMenu()

    Shows the available context menu for the owner element.

    public void ShowContextMenu()public void ShowContextMenu()Public Function ShowContextMenu() As void

    Remarks

    Calling ShowContextMenu() throws an error if a context menu cannot be shown. If no context menu is available directly on the element on which it was invoked, the Microsoft UI Automation logic implemented by a provider should attempt to show a context menu for the Microsoft UI Automation tree parent of the element.

    Scenarios for invoking a context menu from an element include auto-correction and spelling alternatives for text input. The UI elements that display these are not part of the default tab sequence and are not part of an initial Microsoft UI Automation tree until the context that requires them is detected.

  • GetAcceleratorKeyCore()
    GetAcceleratorKeyCore()
    GetAcceleratorKeyCore()
    GetAcceleratorKeyCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls GetAcceleratorKey() or an equivalent Microsoft UI Automation client API.

    protected virtual string GetAcceleratorKeyCore()protected virtual string GetAcceleratorKeyCore()Protected Overridable Function GetAcceleratorKeyCore() As string

    Returns

    • string
      string
      string

      The accelerator key.

  • GetAccessKeyCore()
    GetAccessKeyCore()
    GetAccessKeyCore()
    GetAccessKeyCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls GetAccessKey() or an equivalent Microsoft UI Automation client API.

    protected virtual string GetAccessKeyCore()protected virtual string GetAccessKeyCore()Protected Overridable Function GetAccessKeyCore() As string

    Returns

    • string
      string
      string

      The access key.

  • GetAnnotationsCore()
    GetAnnotationsCore()
    GetAnnotationsCore()
    GetAnnotationsCore()

    Provides the behavior of the peer when a Microsoft UI Automation client calls GetAnnotations() or an equivalent Microsoft UI Automation client API.

    protected virtual IVector<AutomationPeerAnnotation> GetAnnotationsCore()protected virtual IVector<AutomationPeerAnnotation> GetAnnotationsCore()Protected Overridable Function GetAnnotationsCore() As IVector( Of AutomationPeerAnnotation )

    Returns

    • The behavior of the peer.

  • GetAutomationControlTypeCore()
    GetAutomationControlTypeCore()
    GetAutomationControlTypeCore()
    GetAutomationControlTypeCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls GetAutomationControlType() or an equivalent Microsoft UI Automation client API.

    protected virtual AutomationControlType GetAutomationControlTypeCore()protected virtual AutomationControlType GetAutomationControlTypeCore()Protected Overridable Function GetAutomationControlTypeCore() As AutomationControlType

    Returns

    Remarks

    The base implementation for AutomationPeer and FrameworkElementAutomationPeer return Custom. If you keep this behavior, you must override GetLocalizedControlTypeCore().

    The more common scenario for defining an automation peer is overriding one of the existing peer classes that pairs with the control class you are overriding. In this case each such peer class reports a practical value of AutomationControlType that makes sense for the original owner control that the peer was implemented for. Often you can leave this behavior alone. It isn't typical to derive from a control-specific peer and use its behavior but then change the AutomationControlType, which is probably the most basic information that a peer reports. Check the existing behavior of the peer class you are overriding, and verify that you're reporting the correct control type. Also, double-check that there isn't a more specific peer class available that could already be reporting the correct control type as well as providing other behavior that's more appropriate for your peer. For more info, see Custom automation peers.

  • GetAutomationIdCore()
    GetAutomationIdCore()
    GetAutomationIdCore()
    GetAutomationIdCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls GetAutomationId() or an equivalent Microsoft UI Automation client API.

    protected virtual string GetAutomationIdCore()protected virtual string GetAutomationIdCore()Protected Overridable Function GetAutomationIdCore() As string

    Returns

    • string
      string
      string

      The automation identifier.

    Remarks

    Providing a class-based behavior for AutomationId is uncommon. Typically, app authors set values for elements in the app by setting the AutomationIdProperty attached property in the XAML UI definition.

  • GetBoundingRectangleCore()
    GetBoundingRectangleCore()
    GetBoundingRectangleCore()
    GetBoundingRectangleCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls GetBoundingRectangle() or an equivalent Microsoft UI Automation client API.

    protected virtual Rect GetBoundingRectangleCore()protected virtual Rect GetBoundingRectangleCore()Protected Overridable Function GetBoundingRectangleCore() As Rect

    Returns

  • GetChildrenCore()
    GetChildrenCore()
    GetChildrenCore()
    GetChildrenCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls GetChildren() or an equivalent Microsoft UI Automation client API.

    protected virtual IVector<AutomationPeer> GetChildrenCore()protected virtual IVector<AutomationPeer> GetChildrenCore()Protected Overridable Function GetChildrenCore() As IVector( Of AutomationPeer )

    Returns

    Remarks

    The base implementation returns null. Peers that represent controls with item collections may override this result. Test the behavior of the peer you are using or overriding and override GetChildrenCore() if you want to change that behavior.

  • GetClassNameCore()
    GetClassNameCore()
    GetClassNameCore()
    GetClassNameCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls GetClassName() or an equivalent Microsoft UI Automation client API.

    protected virtual string GetClassNameCore()protected virtual string GetClassNameCore()Protected Overridable Function GetClassNameCore() As string

    Returns

    • string
      string
      string

      The class name.

    Remarks

    You should never invoke the base behavior, and all custom peers should override GetClassNameCore() to report the class name that is unique to that peer class. For more info, see Custom automation peers.

  • GetClickablePointCore()
    GetClickablePointCore()
    GetClickablePointCore()
    GetClickablePointCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls GetClickablePoint() or an equivalent Microsoft UI Automation client API.

    protected virtual Point GetClickablePointCore()protected virtual Point GetClickablePointCore()Protected Overridable Function GetClickablePointCore() As Point

    Returns

    Remarks

    The base implementation returns a default Point (coordinates 0,0). Peers that represent items defer to the container. ScrollBarAutomationPeer and SliderAutomationPeer both have behavior that can't adequately express one point for the purposes of GetClickablePoint() scenarios, so these return a Point where the coordinate values are Double.NaN.

    Note

    Visual C++ component extensions (C++/CX) doesn't have a constant for NaN, it uses a value, which appears as "-1.#IND" followed by zeros. Automation clients using languages other than C# or Visual C++ component extensions (C++/CX) may see NaN represented in a different form.

  • GetControlledPeersCore()
    GetControlledPeersCore()
    GetControlledPeersCore()
    GetControlledPeersCore()

    Gets a list of the controlled peers for the current automation peer.

    protected virtual IVectorView<AutomationPeer> GetControlledPeersCore()protected virtual IVectorView<AutomationPeer> GetControlledPeersCore()Protected Overridable Function GetControlledPeersCore() As IVectorView( Of AutomationPeer )

    Returns

    • A list of the controlled peers for the current automation peer.

    Remarks

    Examining controlled peers is an advanced scenario that most peer implementations won't need to use.

  • GetElementFromPointCore(Windows.Foundation.Point)
    GetElementFromPointCore(Windows.Foundation.Point)
    GetElementFromPointCore(Windows.Foundation.Point)
    GetElementFromPointCore(Windows.Foundation.Point)

    Provides the behavior of the peer when a Microsoft UI Automation client calls GetElementFromPoint(Windows.Foundation.Point) or an equivalent Microsoft UI Automation client API.

    protected virtual object GetElementFromPointCore(Windows.Foundation.Point pointInWindowCoordinates)protected virtual object GetElementFromPointCore(Windows.Foundation.Point pointInWindowCoordinates)Protected Overridable Function GetElementFromPointCore(pointInWindowCoordinates As Windows.Foundation.Point) As object

    Parameters

    Returns

    • object
      object
      object

      The behavior of the peer.

  • GetFocusedElementCore()
    GetFocusedElementCore()
    GetFocusedElementCore()
    GetFocusedElementCore()

    Provides the behavior of the peer when a Microsoft UI Automation client calls GetFocusedElement() or an equivalent Microsoft UI Automation client API.

    protected virtual object GetFocusedElementCore()protected virtual object GetFocusedElementCore()Protected Overridable Function GetFocusedElementCore() As object

    Returns

    • object
      object
      object

      The behavior of the peer.

  • GetHelpTextCore()
    GetHelpTextCore()
    GetHelpTextCore()
    GetHelpTextCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls GetHelpText() or an equivalent Microsoft UI Automation client API.

    protected virtual string GetHelpTextCore()protected virtual string GetHelpTextCore()Protected Overridable Function GetHelpTextCore() As string

    Returns

    • string
      string
      string

      The help text.

    Remarks

    Specifying a control behavior for help text is uncommon. In most cases, apps that need it will establish help text information in the UI by applying the HelpTextProperty attached property to the UI definition XAML.

  • GetItemStatusCore()
    GetItemStatusCore()
    GetItemStatusCore()
    GetItemStatusCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls GetItemStatus() or an equivalent Microsoft UI Automation client API.

    protected virtual string GetItemStatusCore()protected virtual string GetItemStatusCore()Protected Overridable Function GetItemStatusCore() As string

    Returns

    • string
      string
      string

      The item status.

  • GetItemTypeCore()
    GetItemTypeCore()
    GetItemTypeCore()
    GetItemTypeCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls GetItemType() or an equivalent Microsoft UI Automation client API.

    protected virtual string GetItemTypeCore()protected virtual string GetItemTypeCore()Protected Overridable Function GetItemTypeCore() As string

    Returns

    • string
      string
      string

      The kind of item.

  • GetLabeledByCore()
    GetLabeledByCore()
    GetLabeledByCore()
    GetLabeledByCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls GetLabeledBy() or an equivalent Microsoft UI Automation client API.

    protected virtual AutomationPeer GetLabeledByCore()protected virtual AutomationPeer GetLabeledByCore()Protected Overridable Function GetLabeledByCore() As AutomationPeer

    Returns

    Remarks

    Specifying a control behavior for labeling is uncommon except for composite data presentation controls that use headers or similar metaphors. In most cases apps establish labeling information between the elements in an app-specific UI by applying the LabeledByProperty attached property to the UI definition XAML.

  • GetLevelCore()
    GetLevelCore()
    GetLevelCore()
    GetLevelCore()

    Provides the behavior of the peer when a Microsoft UI Automation client calls GetLevel() or an equivalent Microsoft UI Automation client API.

    protected virtual int GetLevelCore()protected virtual int GetLevelCore()Protected Overridable Function GetLevelCore() As int

    Returns

    • int
      int
      int

      The behavior of the peer.

  • GetLiveSettingCore()
    GetLiveSettingCore()
    GetLiveSettingCore()
    GetLiveSettingCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls GetLiveSetting() or an equivalent Microsoft UI Automation client API.

    protected virtual AutomationLiveSetting GetLiveSettingCore()protected virtual AutomationLiveSetting GetLiveSettingCore()Protected Overridable Function GetLiveSettingCore() As AutomationLiveSetting

    Returns

  • GetLocalizedControlTypeCore()
    GetLocalizedControlTypeCore()
    GetLocalizedControlTypeCore()
    GetLocalizedControlTypeCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls GetLocalizedControlType() or an equivalent Microsoft UI Automation client API.

    protected virtual string GetLocalizedControlTypeCore()protected virtual string GetLocalizedControlTypeCore()Protected Overridable Function GetLocalizedControlTypeCore() As string

    Returns

    • string
      string
      string

      The type of the control, as a string that is localized to be suitable for direct presentation to users by assistive technology.

    Remarks

    This method is very rarely overridden by peers. So long as you provide a value for GetAutomationControlTypeCore(), all the enumerated constant names from AutomationControlType are already available in localized form to Microsoft UI Automation clients. The necessary translated strings are part of the Microsoft UI Automation support in every Microsoft Windows client. However, if you specify AutomationControlType as the control type, you must support a localized control type string that represents the role of the element (for example, "color picker" for a custom control that enables users to choose and specify colors).

  • GetNameCore()
    GetNameCore()
    GetNameCore()
    GetNameCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls GetName() or an equivalent Microsoft UI Automation client API.

    protected virtual string GetNameCore()protected virtual string GetNameCore()Protected Overridable Function GetNameCore() As string

    Returns

    • string
      string
      string

      The name as used by assistive technology and other Microsoft UI Automation clients.

    Remarks

    FrameworkElementAutomationPeer introduces behavior to GetName() by providing an intermediate GetNameCore() implementation. If an element has a value for the LabeledByMicrosoft UI Automation property, the labeling element's Name value is used as the Name.

    FrameworkElementAutomationPeer also introduces behavior through an internal GetPlainText method that other default peer classes may override in order to access the content model of that control and return a useful default for Name. For example, any ContentControl derived class will use a string representation of its Content value as the default Name. This is enabled because internally ContentControl implements GetPlainText and imparts that behavior to all ContentControl derived classes. This is how you get a useful Name default from the string value of a Button, for example.

    Other specific peers also may have an intermediate GetNameCore() implementation that provides a useful way for that particular Windows Runtime control to provide built-in values for Name. The source of these values comes from other UI properties that are typically set in XAML or as app user code. For example, TextBoxAutomationPeer implements behavior that uses the value of the Text property from the owner TextBox as the default Name. From the user code perspective, the default behavior can be overridden by applying a different NameProperty value. From the peer implementer / provider perspective, the default behavior of the peer can be changed by deriving a new peer class from the existing peer, overriding GetNameCore(), and giving it a new implementation that wouldn't call the base implementation in at least some cases.

    To learn more about the possible default behavior of specific peer classes for default Windows Runtime controls, see the reference topic for that particular peer class and look for implementation notes in the Remarks section.

  • GetOrientationCore()
    GetOrientationCore()
    GetOrientationCore()
    GetOrientationCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls GetOrientation() or an equivalent Microsoft UI Automation client API.

    protected virtual AutomationOrientation GetOrientationCore()protected virtual AutomationOrientation GetOrientationCore()Protected Overridable Function GetOrientationCore() As AutomationOrientation

    Returns

    Remarks

    The base AutomationPeer implementation returns None. Peers that represent items may modify this to report information from their container. ScrollBarAutomationPeer and SliderAutomationPeer both have a pattern they can access that knows about orientation, so these peers can return a determined value. Test the existing return value in the peer that you are using or overriding and then override that behavior if necessary.

  • GetPatternCore(Windows.UI.Xaml.Automation.Peers.PatternInterface)
    GetPatternCore(Windows.UI.Xaml.Automation.Peers.PatternInterface)
    GetPatternCore(Windows.UI.Xaml.Automation.Peers.PatternInterface)
    GetPatternCore(Windows.UI.Xaml.Automation.Peers.PatternInterface)

    Provides the peer's behavior when a Microsoft UI Automation client calls GetPattern(Windows.UI.Xaml.Automation.Peers.PatternInterface) or an equivalent Microsoft UI Automation client API.

    protected virtual object GetPatternCore(Windows.UI.Xaml.Automation.Peers.PatternInterface patternInterface)protected virtual object GetPatternCore(Windows.UI.Xaml.Automation.Peers.PatternInterface patternInterface)Protected Overridable Function GetPatternCore(patternInterface As Windows.UI.Xaml.Automation.Peers.PatternInterface) As object

    Parameters

    Returns

    • object
      object
      object

      The object that implements the pattern interface; null if the peer does not support this interface.

    Remarks

    The standard implementation at the AutomationPeer level returns null, because the basic peer class doesn't support any patterns. The majority of existing Windows Runtime peer classes override this method to report the patterns that a particular peer supports.

    Overriding this method to return the implementation of patterns that your peer class supports is one of the most common scenarios for implementing an automation peer. You can see sample code for this in the XAML accessibility sample (Scenario 3). You should also read the Custom automation peers topic.

    Windows 8 behavior

    Windows 8 peer-selection behavior is potentially impacted by whether the control is intended to display data as items. The automation logic for Windows 8 might select a dedicated data peer and use its patterns, even if there is a peer indicated for the overall control and that peer overrides GetPatternCore(Windows.UI.Xaml.Automation.Peers.PatternInterface). For example, you might have the ListViewAutomationPeer override for patterns, but in Windows 8 the acting patterns for data items might take precedence, for example the default implementation of ListViewItemDataAutomationPeer might be used and will handle the scrolling pattern when UI Automation looks for patterns in items. This is different starting with Windows 8.1; if there is pattern support indicated in a GetPatternCore(Windows.UI.Xaml.Automation.Peers.PatternInterface) implementation for the overall control, that implementation is used instead of internal item data peers.

    If you migrate your app code from Windows 8 to Windows 8.1 you may want to account for this behavior change, because it means that your items control pattern support may be used for data items too, and you might have to add behavior for item scrolling, for instance.

    Apps that were compiled for Windows 8 but running on Windows 8.1 continue to use the Windows 8 behavior.

  • GetPeerFromPointCore(Windows.Foundation.Point)
    GetPeerFromPointCore(Windows.Foundation.Point)
    GetPeerFromPointCore(Windows.Foundation.Point)
    GetPeerFromPointCore(Windows.Foundation.Point)

    Provides the peer's behavior when a Microsoft UI Automation client calls GetPeerFromPoint(Windows.Foundation.Point) or an equivalent Microsoft UI Automation client API.

    protected virtual AutomationPeer GetPeerFromPointCore(Windows.Foundation.Point point)protected virtual AutomationPeer GetPeerFromPointCore(Windows.Foundation.Point point)Protected Overridable Function GetPeerFromPointCore(point As Windows.Foundation.Point) As AutomationPeer

    Parameters

    • point

      The relative position of the target UI element in the UI.

    Returns

    Remarks

    Test the existing return value in the peer that you are using or overriding and then override that behavior if necessary.

  • GetPositionInSetCore()
    GetPositionInSetCore()
    GetPositionInSetCore()
    GetPositionInSetCore()

    Provides the peer’s behavior when a Microsoft UI Automation client calls GetPositionInSet() or an equivalent Microsoft UI Automation client API.

    protected virtual int GetPositionInSetCore()protected virtual int GetPositionInSetCore()Protected Overridable Function GetPositionInSetCore() As int

    Returns

    • int
      int
      int

      The peer’s behavior.

  • GetSizeOfSetCore()
    GetSizeOfSetCore()
    GetSizeOfSetCore()
    GetSizeOfSetCore()

    Provides the peer’s behavior when a Microsoft UI Automation client calls GetSizeOfSet() or an equivalent Microsoft UI Automation client API.

    protected virtual int GetSizeOfSetCore()protected virtual int GetSizeOfSetCore()Protected Overridable Function GetSizeOfSetCore() As int

    Returns

    • int
      int
      int

      The peer’s behavior.

  • HasKeyboardFocusCore()
    HasKeyboardFocusCore()
    HasKeyboardFocusCore()
    HasKeyboardFocusCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls HasKeyboardFocus() or an equivalent Microsoft UI Automation client API.

    protected virtual bool HasKeyboardFocusCore()protected virtual bool HasKeyboardFocusCore()Protected Overridable Function HasKeyboardFocusCore() As bool

    Returns

    • bool
      bool
      bool

      true if the element has keyboard focus; otherwise, false.

    Remarks

    The standard implementation at the AutomationPeer level checks whether the owner has focus, and always returns false if the owner isn't focusable. FrameworkElementAutomationPeer expands this behavior somewhat because it adds awareness of owner characteristics that rely on the owner being a Control subclass. Test the existing return value in the peer that you are using or overriding and then override that behavior if necessary.

  • IsContentElementCore()
    IsContentElementCore()
    IsContentElementCore()
    IsContentElementCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls IsContentElement() or an equivalent Microsoft UI Automation client API.

    protected virtual bool IsContentElementCore()protected virtual bool IsContentElementCore()Protected Overridable Function IsContentElementCore() As bool

    Returns

    • bool
      bool
      bool

      true if the element is a content element; otherwise, false.

    Remarks

    The standard implementation at the AutomationPeer level returns false. However, FrameworkElementAutomationPeer adds behavior that changes the default to true. Other specific peers also may affect this behavior; for example ItemAutomationPeer defers to its container. Test the existing return value in the peer that you are using or overriding and then override that behavior if necessary.

  • IsControlElementCore()
    IsControlElementCore()
    IsControlElementCore()
    IsControlElementCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls IsControlElement() or an equivalent Microsoft UI Automation client API.

    protected virtual bool IsControlElementCore()protected virtual bool IsControlElementCore()Protected Overridable Function IsControlElementCore() As bool

    Returns

    • bool
      bool
      bool

      true if the element is a control; otherwise, false.

    Remarks

    The standard implementation at the AutomationPeer level returns false. However, FrameworkElementAutomationPeer adds behavior that changes the default to true. Other specific peers also may affect this behavior; for example many peers return different values depending on whether the owner is created from a control template. Test the existing return value in the peer that you are using or overriding and then override that behavior if necessary.

  • IsEnabledCore()
    IsEnabledCore()
    IsEnabledCore()
    IsEnabledCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls IsEnabled() or an equivalent Microsoft UI Automation client API.

    protected virtual bool IsEnabledCore()protected virtual bool IsEnabledCore()Protected Overridable Function IsEnabledCore() As bool

    Returns

    • bool
      bool
      bool

      true if the element can be interacted with; otherwise, false.

    Remarks

    The standard implementation at the AutomationPeer level returns true. However, FrameworkElementAutomationPeer adds behavior that checks whether the owner is a Control and forwards owner information from IsEnabled. For cases where the owner is not a control but does have a peer, such as for a TextBlock, the FrameworkElementAutomationPeer implementation returns true.

  • IsKeyboardFocusableCore()
    IsKeyboardFocusableCore()
    IsKeyboardFocusableCore()
    IsKeyboardFocusableCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls IsKeyboardFocusable() or an equivalent Microsoft UI Automation client API.

    protected virtual bool IsKeyboardFocusableCore()protected virtual bool IsKeyboardFocusableCore()Protected Overridable Function IsKeyboardFocusableCore() As bool

    Returns

    • bool
      bool
      bool

      true if the element can accept keyboard focus; otherwise, false.

    Remarks

    The standard implementation at the AutomationPeer level returns false. However, FrameworkElementAutomationPeer adds behavior that checks whether the owner is a Control or otherwise focusable, and whether the owner is enabled.

  • IsOffscreenCore()
    IsOffscreenCore()
    IsOffscreenCore()
    IsOffscreenCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls IsOffscreen() or an equivalent Microsoft UI Automation client API.

    protected virtual bool IsOffscreenCore()protected virtual bool IsOffscreenCore()Protected Overridable Function IsOffscreenCore() As bool

    Returns

    • bool
      bool
      bool

      true if the element is not on the screen; otherwise, false.

    Remarks

    The standard implementation returns a result that is based on the owner's Visibility value.

  • IsPasswordCore()
    IsPasswordCore()
    IsPasswordCore()
    IsPasswordCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls IsPassword() or an equivalent Microsoft UI Automation client API.

    protected virtual bool IsPasswordCore()protected virtual bool IsPasswordCore()Protected Overridable Function IsPasswordCore() As bool

    Returns

    • bool
      bool
      bool

      true if the element contains sensitive content; otherwise, false.

    Remarks

    The standard implementation returns false. PasswordBoxAutomationPeer provides an implementation that returns true. If the peer being returned by your control is PasswordBoxAutomationPeer or derived from it, you will inherit that behavior.

  • IsRequiredForFormCore()
    IsRequiredForFormCore()
    IsRequiredForFormCore()
    IsRequiredForFormCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls IsRequiredForForm() or an equivalent Microsoft UI Automation client API.

    protected virtual bool IsRequiredForFormCore()protected virtual bool IsRequiredForFormCore()Protected Overridable Function IsRequiredForFormCore() As bool

    Returns

    • bool
      bool
      bool

      true if the element must be completed; otherwise, false.

    Remarks

    The standard implementation returns false. Overriding this value at the peer level to return true is probably an uncommon scenario, because you are implying that every instance of your control has a required-for-form behavior no matter what app or UI situation it is used for. It's more typical for apps to specify a required-for-form behavior that is declared in the app's XAML UI definitions, by setting IsRequiredForFormProperty.

  • NavigateCore(Windows.UI.Xaml.Automation.Peers.AutomationNavigationDirection)
    NavigateCore(Windows.UI.Xaml.Automation.Peers.AutomationNavigationDirection)
    NavigateCore(Windows.UI.Xaml.Automation.Peers.AutomationNavigationDirection)
    NavigateCore(Windows.UI.Xaml.Automation.Peers.AutomationNavigationDirection)

    Provides the peer’s behavior when a Microsoft UI Automation client calls Navigate(Windows.UI.Xaml.Automation.Peers.AutomationNavigationDirection) or an equivalent Microsoft UI Automation client API.

    protected virtual object NavigateCore(Windows.UI.Xaml.Automation.Peers.AutomationNavigationDirection direction)protected virtual object NavigateCore(Windows.UI.Xaml.Automation.Peers.AutomationNavigationDirection direction)Protected Overridable Function NavigateCore(direction As Windows.UI.Xaml.Automation.Peers.AutomationNavigationDirection) As object

    Parameters

    Returns

    • object
      object
      object

      The element in the specified direction within the UI automation tree.

  • PeerFromProvider(Windows.UI.Xaml.Automation.Provider.IRawElementProviderSimple)
    PeerFromProvider(Windows.UI.Xaml.Automation.Provider.IRawElementProviderSimple)
    PeerFromProvider(Windows.UI.Xaml.Automation.Provider.IRawElementProviderSimple)
    PeerFromProvider(Windows.UI.Xaml.Automation.Provider.IRawElementProviderSimple)

    Gets an AutomationPeer for the specified IRawElementProviderSimple proxy.

    protected AutomationPeer PeerFromProvider(Windows.UI.Xaml.Automation.Provider.IRawElementProviderSimple provider)protected AutomationPeer PeerFromProvider(Windows.UI.Xaml.Automation.Provider.IRawElementProviderSimple provider)Protected Function PeerFromProvider(provider As Windows.UI.Xaml.Automation.Provider.IRawElementProviderSimple) As AutomationPeer

    Parameters

    Returns

  • ProviderFromPeer(Windows.UI.Xaml.Automation.Peers.AutomationPeer)
    ProviderFromPeer(Windows.UI.Xaml.Automation.Peers.AutomationPeer)
    ProviderFromPeer(Windows.UI.Xaml.Automation.Peers.AutomationPeer)
    ProviderFromPeer(Windows.UI.Xaml.Automation.Peers.AutomationPeer)

    Gets the IRawElementProviderSimple proxy for the specified AutomationPeer.

    protected IRawElementProviderSimple ProviderFromPeer(Windows.UI.Xaml.Automation.Peers.AutomationPeer peer)protected IRawElementProviderSimple ProviderFromPeer(Windows.UI.Xaml.Automation.Peers.AutomationPeer peer)Protected Function ProviderFromPeer(peer As Windows.UI.Xaml.Automation.Peers.AutomationPeer) As IRawElementProviderSimple

    Parameters

    Returns

  • SetFocusCore()
    SetFocusCore()
    SetFocusCore()
    SetFocusCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls SetFocus() or an equivalent Microsoft UI Automation client API.

    protected virtual void SetFocusCore()protected virtual void SetFocusCore()Protected Overridable Function SetFocusCore() As void

    Remarks

    The standard implementation uses IsKeyboardFocusable() to determine whether the peer reports that the owner can be focused. FrameworkElementAutomationPeer adds behavior that performs the actual focus operation if it is possible.

  • ShowContextMenuCore()
    ShowContextMenuCore()
    ShowContextMenuCore()
    ShowContextMenuCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls ShowContextMenu() or an equivalent Microsoft UI Automation client API.

    protected virtual void ShowContextMenuCore()protected virtual void ShowContextMenuCore()Protected Overridable Function ShowContextMenuCore() As void
  • GetLandmarkTypeCore()
    GetLandmarkTypeCore()
    GetLandmarkTypeCore()
    GetLandmarkTypeCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls GetLandmarkType() or an equivalent Microsoft UI Automation client API.

    protected virtual AutomationLandmarkType GetLandmarkTypeCore()protected virtual AutomationLandmarkType GetLandmarkTypeCore()Protected Overridable Function GetLandmarkTypeCore() As AutomationLandmarkType

    Returns

  • GetLocalizedLandmarkTypeCore()
    GetLocalizedLandmarkTypeCore()
    GetLocalizedLandmarkTypeCore()
    GetLocalizedLandmarkTypeCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls GetLocalizedLandmarkType() or an equivalent Microsoft UI Automation client API.

    protected virtual string GetLocalizedLandmarkTypeCore()protected virtual string GetLocalizedLandmarkTypeCore()Protected Overridable Function GetLocalizedLandmarkTypeCore() As string

    Returns

    • string
      string
      string

      The landmark type of the peer, as a string that is localized to be suitable for direct presentation to users by assistive technology.

  • GetDescribedByCore()
    GetDescribedByCore()
    GetDescribedByCore()
    GetDescribedByCore()

    Gets a collection of elements that provide more information about the automation element.

    protected virtual IIterable<AutomationPeer> GetDescribedByCore()protected virtual IIterable<AutomationPeer> GetDescribedByCore()Protected Overridable Function GetDescribedByCore() As IIterable( Of AutomationPeer )

    Returns

    • A collection of elements that provide more information about the automation element.

    Remarks

    GetDescribedByCore() is used when an automation element is explained by another segment of the application UI. For example, the collection can point to a text element of "2,529 items in 85 groups, 10 items selected" from a complex custom list object. Instead of using the object model for clients to digest similar information, the collection returned by GetDescribedByCore() can offer quick access to UI elements that may already offer useful end-user information that describes the UI element.

  • GetFlowsFromCore()
    GetFlowsFromCore()
    GetFlowsFromCore()
    GetFlowsFromCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls GetFlowsFrom(Windows.UI.Xaml.DependencyObject) or an equivalent Microsoft UI Automation client API.

    protected virtual IIterable<AutomationPeer> GetFlowsFromCore()protected virtual IIterable<AutomationPeer> GetFlowsFromCore()Protected Overridable Function GetFlowsFromCore() As IIterable( Of AutomationPeer )

    Returns

    • A list of automation elements that suggests the reading order before the current automation element.

    Remarks

    The "Core" methods are the standard implementations that perform the default action of an associated UI Automation client-callable method. You can override any of the "Core" methods to return alternative values in a custom automation peer. In this case, GetFlowsFromCore() is invoked any time that GetFlowsFrom(Windows.UI.Xaml.DependencyObject) is called.

    The base implementation for AutomationPeer returns null.

  • GetFlowsToCore()
    GetFlowsToCore()
    GetFlowsToCore()
    GetFlowsToCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls GetFlowsTo(Windows.UI.Xaml.DependencyObject) or an equivalent Microsoft UI Automation client API.

    protected virtual IIterable<AutomationPeer> GetFlowsToCore()protected virtual IIterable<AutomationPeer> GetFlowsToCore()Protected Overridable Function GetFlowsToCore() As IIterable( Of AutomationPeer )

    Returns

    • A list of automation elements that suggests the reading order after the current automation element.

    Remarks

    The "Core" methods are the standard implementations that perform the default action of an associated UI Automation client-callable method. You can override any of the "Core" methods to return alternative values in a custom automation peer. In this case, GetFlowsToCore() is invoked any time that GetFlowsTo(Windows.UI.Xaml.DependencyObject) is called.

    The base implementation for AutomationPeer returns null.

  • GetFullDescriptionCore()
    GetFullDescriptionCore()
    GetFullDescriptionCore()
    GetFullDescriptionCore()

    Provides the peer's behavior when a Microsoft UI Automation client calls GetFullDescription() or an equivalent Microsoft UI Automation client API.

    protected virtual string GetFullDescriptionCore()protected virtual string GetFullDescriptionCore()Protected Overridable Function GetFullDescriptionCore() As string

    Returns

    • string
      string
      string

      A localized string that describes the actual visual appearance or contents of something such as an image or image control.

    Remarks

    You should never invoke the base behavior, and all custom peers should override GetFullDescriptionCore() to report the full description of this AutomationPeer. For more info, see Custom automation peers.

  • IsDataValidForFormCore()
    IsDataValidForFormCore()
    IsDataValidForFormCore()
    IsDataValidForFormCore()

    Provides the peer’s behavior when a Microsoft UI Automation client accesses IsDataValidForForm() or an equivalent Microsoft UI Automation client API.

    protected virtual bool IsDataValidForFormCore()protected virtual bool IsDataValidForFormCore()Protected Overridable Function IsDataValidForFormCore() As bool

    Returns

    • bool
      bool
      bool

      A Boolean value that indicates whether the entered or selected value is valid for the form rule associated with the automation element.

  • IsPeripheralCore()
    IsPeripheralCore()
    IsPeripheralCore()
    IsPeripheralCore()

    Provides the peer’s behavior when a Microsoft UI Automation client accesses IsPeripheral() or an equivalent Microsoft UI Automation client API.

    protected virtual bool IsPeripheralCore()protected virtual bool IsPeripheralCore()Protected Overridable Function IsPeripheralCore() As bool

    Returns

    • bool
      bool
      bool

      A Boolean value that indicates whether the automation element represents peripheral UI.

  • GetCultureCore()
    GetCultureCore()
    GetCultureCore()
    GetCultureCore()

    Gets the culture value for the element that is associated with the automation peer.

    protected virtual int GetCultureCore()protected virtual int GetCultureCore()Protected Overridable Function GetCultureCore() As int

    Returns

    • int
      int
      int

      The value of the culture property for the element that is associated with the automation peer.

Device family

Windows 10 (introduced v10.0.10240.0)

API contract

Windows.Foundation.UniversalApiContract (introduced v1)

Attributes

Windows.Foundation.Metadata.MarshalingBehaviorAttribute
Windows.Foundation.Metadata.ContractVersionAttribute
Windows.Foundation.Metadata.ThreadingAttribute
Windows.Foundation.Metadata.StaticAttribute
Windows.Foundation.Metadata.ComposableAttribute
Windows.Foundation.Metadata.WebHostHiddenAttribute
Windows.Foundation.Metadata.StaticAttribute

Details

Assembly

Windows.UI.Xaml.Automation.Peers.dll