FrameworkElementAutomationPeer-Klasse
TOC
Inhaltsverzeichnis reduzieren
Inhaltsverzeichnis erweitern

FrameworkElementAutomationPeer Class

Macht von FrameworkElement abgeleitete Typen (einschließlich aller Steuerelemente) für die Microsoft-Benutzeroberflächenautomatisierung verfügbar.

Vererbung

Object
  DependencyObject
    AutomationPeer
      FrameworkElementAutomationPeer

Syntax


public class FrameworkElementAutomationPeer : AutomationPeer

Attribute

[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]
[WebHostHidden()]

Member

FrameworkElementAutomationPeerKlasse hat diese Membertypen:

Konstruktoren

FrameworkElementAutomationPeerKlasse hat diese Konstruktoren.

KonstruktorBeschreibung
FrameworkElementAutomationPeer Initializes a new instance of the FrameworkElementAutomationPeer class.

 

Methoden

The FrameworkElementAutomationPeer Klasse hat diese Methoden. Es erbt auch Methoden von Object Klasse.

MethodeBeschreibung
ClearValue Clears the local value of a dependency property. (Geerbt von DependencyObject)
CreatePeerForElement Creates a FrameworkElementAutomationPeer for the specified UIElement.
FromElement Returns the FrameworkElementAutomationPeer for the specified UIElement.
GetAcceleratorKey Gets the accelerator key combinations for the object that is associated with the UI Automation peer. (Geerbt von AutomationPeer)
GetAcceleratorKeyCore Provides the peer's behavior when a Microsoft UI Automation client calls GetAcceleratorKey or an equivalent Microsoft UI Automation client API. (Geerbt von AutomationPeer)
GetAccessKey Gets the access key for the element that is associated with the automation peer. (Geerbt von AutomationPeer)
GetAccessKeyCore Provides the peer's behavior when a Microsoft UI Automation client calls GetAccessKey or an equivalent Microsoft UI Automation client API. (Geerbt von AutomationPeer)
GetAnimationBaseValue Returns any base value established for a dependency property, which would apply in cases where an animation is not active. (Geerbt von DependencyObject)
GetAutomationControlType Gets the control type for the element that is associated with the UI Automation peer. (Geerbt von AutomationPeer)
GetAutomationControlTypeCore Provides the peer's behavior when a Microsoft UI Automation client calls GetAutomationControlType or an equivalent Microsoft UI Automation client API. (Geerbt von AutomationPeer)
GetAutomationId Gets the AutomationId of the element that is associated with the automation peer. (Geerbt von AutomationPeer)
GetAutomationIdCore Provides the peer's behavior when a Microsoft UI Automation client calls GetAutomationId or an equivalent Microsoft UI Automation client API. (Geerbt von AutomationPeer)
GetBoundingRectangle Gets the Rect object that represents the screen coordinates of the element that is associated with the automation peer. (Geerbt von AutomationPeer)
GetBoundingRectangleCore Provides the peer's behavior when a Microsoft UI Automation client calls GetBoundingRectangle or an equivalent Microsoft UI Automation client API. (Geerbt von AutomationPeer)
GetChildren Gets the collection of child elements that are represented in the UI Automation tree as immediate child elements of the automation peer. (Geerbt von AutomationPeer)
GetChildrenCore Provides the peer's behavior when a Microsoft UI Automation client calls GetChildren or an equivalent Microsoft UI Automation client API. (Geerbt von AutomationPeer)
GetClassName Gets a name that is used with AutomationControlType, to differentiate the control that is represented by this AutomationPeer. (Geerbt von AutomationPeer)
GetClassNameCore Provides the peer's behavior when a Microsoft UI Automation client calls GetClassName or an equivalent Microsoft UI Automation client API. (Geerbt von AutomationPeer)
GetClickablePoint Gets a point on the element that is associated with the automation peer that responds to a mouse click. (Geerbt von AutomationPeer)
GetClickablePointCore Provides the peer's behavior when a Microsoft UI Automation client calls GetClickablePoint or an equivalent Microsoft UI Automation client API. (Geerbt von AutomationPeer)
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. (Geerbt von AutomationPeer)
GetControlledPeersCore Gets a list of the controlled peers for the current automation peer. (Geerbt von AutomationPeer)
GetHelpText Gets text that describes the functionality of the control that is associated with the automation peer. (Geerbt von AutomationPeer)
GetHelpTextCore Provides the peer's behavior when a Microsoft UI Automation client calls GetHelpText or an equivalent Microsoft UI Automation client API. (Geerbt von AutomationPeer)
GetItemStatus Gets text that conveys the visual status of the element that is associated with this automation peer. (Geerbt von AutomationPeer)
GetItemStatusCore Provides the peer's behavior when a Microsoft UI Automation client calls GetItemStatus or an equivalent Microsoft UI Automation client API. (Geerbt von AutomationPeer)
GetItemType Gets a string that describes what kind of item an element represents. (Geerbt von AutomationPeer)
GetItemTypeCore Provides the peer's behavior when a Microsoft UI Automation client calls GetItemType or an equivalent Microsoft UI Automation client API. (Geerbt von AutomationPeer)
GetLabeledBy Gets the AutomationPeer for the UIElement that is targeted to the element. (Geerbt von AutomationPeer)
GetLabeledByCore Provides the peer's behavior when a Microsoft UI Automation client calls GetLabeledBy or an equivalent Microsoft UI Automation client API. (Geerbt von AutomationPeer)
GetLiveSetting Gets the live setting notification behavior information for the object that is associated with the UI Automation peer. (Geerbt von AutomationPeer)
GetLiveSettingCore Provides the peer's behavior when a Microsoft UI Automation client calls GetLiveSetting or an equivalent Microsoft UI Automation client API. (Geerbt von AutomationPeer)
GetLocalizedControlType Gets a localized string that represents the AutomationControlType value for the control that is associated with this automation peer. (Geerbt von AutomationPeer)
GetLocalizedControlTypeCore Provides the peer's behavior when a Microsoft UI Automation client calls GetLocalizedControlType or an equivalent Microsoft UI Automation client API. (Geerbt von AutomationPeer)
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. (Geerbt von AutomationPeer)
GetNameCore Provides the peer's behavior when a Microsoft UI Automation client calls GetName or an equivalent Microsoft UI Automation client API. (Geerbt von AutomationPeer)
GetOrientation Gets a value that indicates the explicit control orientation, if any. (Geerbt von AutomationPeer)
GetOrientationCore Provides the peer's behavior when a Microsoft UI Automation client calls GetOrientation or an equivalent Microsoft UI Automation client API. (Geerbt von AutomationPeer)
GetParent Gets the AutomationPeer that is the parent of this AutomationPeer. (Geerbt von AutomationPeer)
GetPattern Gets the control pattern that is associated with the specified PatternInterface. (Geerbt von AutomationPeer)
GetPatternCore Provides the peer's behavior when a Microsoft UI Automation client calls GetPattern or an equivalent Microsoft UI Automation client API. (Geerbt von AutomationPeer)
GetPeerFromPoint Gets an AutomationPeer from the specified point. (Geerbt von AutomationPeer)
GetPeerFromPointCore Provides the peer's behavior when a Microsoft UI Automation client calls GetPeerFromPoint or an equivalent Microsoft UI Automation client API. (Geerbt von AutomationPeer)
GetValue Returns the current effective value of a dependency property from a DependencyObject. (Geerbt von DependencyObject)
HasKeyboardFocus Gets a value that indicates whether the element that is associated with this automation peer currently has keyboard focus. (Geerbt von AutomationPeer)
HasKeyboardFocusCore Provides the peer's behavior when a Microsoft UI Automation client calls HasKeyboardFocus or an equivalent Microsoft UI Automation client API. (Geerbt von AutomationPeer)
InvalidatePeer Triggers recalculation of the main properties of the AutomationPeer and raises the PropertyChanged notification to the automation client if the properties have changed. (Geerbt von AutomationPeer)
IsContentElement Gets a value that indicates whether the element that is associated with this automation peer contains data that is presented to the user. (Geerbt von AutomationPeer)
IsContentElementCore Provides the peer's behavior when a Microsoft UI Automation client calls IsContentElement or an equivalent Microsoft UI Automation client API. (Geerbt von AutomationPeer)
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. (Geerbt von AutomationPeer)
IsControlElementCore Provides the peer's behavior when a Microsoft UI Automation client calls IsControlElement or an equivalent Microsoft UI Automation client API. (Geerbt von AutomationPeer)
IsEnabled Gets a value that indicates whether the element associated with this automation peer supports interaction. (Geerbt von AutomationPeer)
IsEnabledCore Provides the peer's behavior when a Microsoft UI Automation client calls IsEnabled or an equivalent Microsoft UI Automation client API. (Geerbt von AutomationPeer)
IsKeyboardFocusable Gets a value that indicates whether the element can accept keyboard focus. (Geerbt von AutomationPeer)
IsKeyboardFocusableCore Provides the peer's behavior when a Microsoft UI Automation client calls IsKeyboardFocusable or an equivalent Microsoft UI Automation client API. (Geerbt von AutomationPeer)
IsOffscreen Gets a value that indicates whether an element is off the screen. (Geerbt von AutomationPeer)
IsOffscreenCore Provides the peer's behavior when a Microsoft UI Automation client calls IsOffscreen or an equivalent Microsoft UI Automation client API. (Geerbt von AutomationPeer)
IsPassword Gets a value that indicates whether the element contains sensitive content. (Geerbt von AutomationPeer)
IsPasswordCore Provides the peer's behavior when a Microsoft UI Automation client calls IsPassword or an equivalent Microsoft UI Automation client API. (Geerbt von AutomationPeer)
IsRequiredForForm Gets a value that indicates whether the element that is associated with this peer must be completed on a form. (Geerbt von AutomationPeer)
IsRequiredForFormCore Provides the peer's behavior when a Microsoft UI Automation client calls IsRequiredForForm or an equivalent Microsoft UI Automation client API. (Geerbt von AutomationPeer)
PeerFromProvider Gets an AutomationPeer for the specified IRawElementProviderSimple proxy. (Geerbt von AutomationPeer)
ProviderFromPeer Gets the IRawElementProviderSimple proxy for the specified AutomationPeer. (Geerbt von AutomationPeer)
RaiseAutomationEvent Raises an automation event. (Geerbt von AutomationPeer)
RaisePropertyChangedEvent Raises an event to notify the automation client of a changed property value. (Geerbt von AutomationPeer)
ReadLocalValue Returns the local value of a dependency property, if a local value is set. (Geerbt von DependencyObject)
SetFocus Sets the keyboard focus on the element that is associated with this automation peer. (Geerbt von AutomationPeer)
SetFocusCore Provides the peer's behavior when a Microsoft UI Automation client calls SetFocus or an equivalent Microsoft UI Automation client API. (Geerbt von AutomationPeer)
SetValue Sets the local value of a dependency property on a DependencyObject. (Geerbt von DependencyObject)
ShowContextMenu Shows the available context menu for the owner element. (Geerbt von AutomationPeer)
ShowContextMenuCore Provides the peer's behavior when a Microsoft UI Automation client calls ShowContextMenu or an equivalent Microsoft UI Automation client API. (Geerbt von AutomationPeer)

 

Eigenschaften

Der FrameworkElementAutomationPeerKlasse hat diese Eigenschaften.

EigenschaftZugriffstypBeschreibung

Dispatcher

SchreibgeschütztGets the CoreDispatcher that this object is associated with. (Geerbt von DependencyObject)

EventsSource

Lese-/SchreibzugriffGets 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. (Geerbt von AutomationPeer)

Owner

SchreibgeschütztGets the UIElement owner that is associated with this FrameworkElementAutomationPeer.

 

Hinweise

Es ist keine "ControlAutomationPeer"-Klasse vorhanden. FrameworkElementAutomationPeer dient als Implementierung für alle grundlegenden Control-Klassenszenarien, die Benutzeroberflächenautomatisierung einschließen. Dies schließt Verhalten ein, das nicht unbedingt als öffentliche API-Bereitstellung angezeigt wird, wie die praktischen Implementierungen vieler Core-Methoden aus AutomationPeer.

FrameworkElementAutomationPeer schließt umfangreiche Basisimplementierungen des Peerverhaltens ein, die andere Peers verwenden können, um Informationen zu melden, die von den Besitzerklassen auf den Ebenen UIElement und FrameworkElement stammten. Weitere Informationen finden Sie im Artikel Benutzerdefinierten Automatisierungspeers im Abschnitt "Basisimplementierungen in FrameworkElementAutomationPeer".

Zusätzlich zu den Core-Überschreibungen verfügt FrameworkElementAutomationPeer über zwei statische Hilfsprogrammmethoden, die hilfreich sind, um einen Peerhandle aus dem Steuerungscode abzurufen oder um Elementpeers aus einem Elementcontainerpeer zur Unterstützung der Benutzeroberflächenautomatisierung zu generieren. Diese lauten wie folgt:

Wenn es nötig ist, einen benutzerdefinierten Automatisierungspeer zu definieren, und Sie keine stärker abgeleitete Peerklasse identifizieren können, die mit der Steuerelement- oder Basisklasse, von der Sie die Besitzerklasse ableiten, kombiniert wird, sollten Sie FrameworkElementAutomationPeer als Basis für den Peer verwenden. Auch wenn die Besitzerklasse nicht notwendigerweise eine FrameworkElement-Klasse ist, können Sie Peers praktischerweise nicht von der AutomationPeer-Klasse direkt ableiten, da die FrameworkElementAutomationPeer-Klasse viele Überschreibungen hat, die das erwartete Verhalten für Layout, Automatisierung und Benutzeroberflächeninteraktionen bereitstellen. Sie müssen die Besitzerklasse zumindest von UIElement ableiten; andernfalls gibt es keine Möglichkeit, den Peer auf Automatisierungsstrukturlast mit OnCreateAutomationPeer zu erstellen.

Beispiele

In diesem Beispiel werden die grundlegenden Unterklassenanforderungen für die Ableitung eines Peers von FrameworkElementAutomationPeer und die Unterstützung mindestens eines Steuerelementmusters dargestellt. Dieser Code ist ein Auszug aus dem Beispiel für eine XAML-Barrierefreiheit.


        public class MediaContainerAP : FrameworkElementAutomationPeer, IRangeValueProvider, IToggleProvider
        {
            MediaElement _mediaElement;
            FrameworkElement _labeledBy;
// nondefault ctors omitted
            protected override object GetPatternCore(PatternInterface patternInterface)
            {
                if (patternInterface == PatternInterface.RangeValue)
                {
                    return this;
                }
                else if (patternInterface == PatternInterface.Toggle)
                {
                    return this;
                }
                return null;
            }


            protected override AutomationControlType GetAutomationControlTypeCore()
            {
                return AutomationControlType.Group;
            }

            protected override string GetLocalizedControlTypeCore()
            {
                return "Video";
            }

            protected override string GetClassNameCore()
            {
                return "MediaElementContainer";
            }
// pattern implementation omitted ...
        }


Anforderungen

Mindestens unterstützter Client

Windows 8 [Nur Windows Store-Apps]

Mindestens unterstützter Server

Windows Server 2012 [Nur Windows Store-Apps]

Namespace

Windows.UI.Xaml.Automation.Peers
Windows::UI::Xaml::Automation::Peers [C++]

Metadaten

Windows.winmd

Siehe auch

FrameworkElement
Benutzerdefinierte Automatisierungspeers
AutomationPeer
Beispiel für eine XAML-Barrierefreiheit

 

 

Anzeigen:
© 2016 Microsoft