AutomationPeer Klasse

Definition

Stellt eine Basisklasse bereit, die ein Element für die Benutzeroberflächenautomatisierung verfügbar macht.Provides a base class that exposes an element to UI Automation.

public ref class AutomationPeer abstract : System::Windows::Threading::DispatcherObject
public abstract class AutomationPeer : System.Windows.Threading.DispatcherObject
type AutomationPeer = class
    inherit DispatcherObject
Public MustInherit Class AutomationPeer
Inherits DispatcherObject
Vererbung
AutomationPeer
Abgeleitet

Hinweise

Wenn BenutzeroberflächenautomatisierungUI Automation der Stamm einer- Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) Anwendung über ein Element abgefragt wird, gibt der BenutzeroberflächenautomatisierungUI Automation Stamm den-Peer für dieses Element zurück.When BenutzeroberflächenautomatisierungUI Automation queries the root of a Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) application about an element, the root returns the BenutzeroberflächenautomatisierungUI Automation peer for that element. Der Peer antwortet auch auf BenutzeroberflächenautomatisierungUI Automation Abfragen über das entsprechende Element.The peer also responds to BenutzeroberflächenautomatisierungUI Automation queries about its corresponding element.

Konstruktoren

AutomationPeer()

Stellt beim Aufruf durch den Konstruktor einer abgeleiteten Klasse die Initialisierung für Basisklassenwerte bereit.Provides initialization for base class values when they are called by the constructor of a derived class.

Eigenschaften

Dispatcher

Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist.Gets the Dispatcher this DispatcherObject is associated with.

(Geerbt von DispatcherObject)
EventsSource

Ruft einen AutomationPeer ab, der dem Automatisierungsclient als eine Quelle der Ereignisse gemeldet wurde, die von diesem AutomationPeer kommen, oder legt diesen fest.Gets or sets an AutomationPeer that is reported to the automation client as a source for all the events that come from this AutomationPeer.

IsHwndHost

Ruft einen Wert ab, der angibt, ob das Element, das diesem AutomationPeer zugeordnet ist, hwnds in Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) hostet.Gets a value that indicates whether the element that is associated with this AutomationPeer hosts hwnds in Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF).

Methoden

CheckAccess()

Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann.Determines whether the calling thread has access to this DispatcherObject.

(Geerbt von DispatcherObject)
Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetAcceleratorKey()

Ruft die Tastenkombination für das Element ab, das dem BenutzeroberflächenautomatisierungUI Automation-Peer zugeordnet ist.Gets the accelerator key combinations for the element that is associated with the BenutzeroberflächenautomatisierungUI Automation peer.

GetAcceleratorKeyCore()

Wird beim Überschreiben in einer abgeleiteten Klasse von GetAcceleratorKey() aufgerufen.When overridden in a derived class, is called by GetAcceleratorKey().

GetAccessKey()

Ruft die Tastenkombination für das Element ab, das dem Automatisierungspeer zugeordnet ist.Gets the access key for the element that is associated with the automation peer.

GetAccessKeyCore()

Wird beim Überschreiben in einer abgeleiteten Klasse von GetAccessKey() aufgerufen.When overridden in a derived class, is called by GetAccessKey().

GetAutomationControlType()

Ruft den Steuerelementtyp für das Element ab, das dem BenutzeroberflächenautomatisierungUI Automation-Peer zugeordnet ist.Gets the control type for the element that is associated with the BenutzeroberflächenautomatisierungUI Automation peer.

GetAutomationControlTypeCore()

Wird beim Überschreiben in einer abgeleiteten Klasse von GetAutomationControlType() aufgerufen.When overridden in a derived class, is called by GetAutomationControlType().

GetAutomationId()

Ruft die AutomationId des Elements ab, das dem Automatisierungspeer zugeordnet ist.Gets the AutomationId of the element that is associated with the automation peer.

GetAutomationIdCore()

Wird beim Überschreiben in einer abgeleiteten Klasse von GetAutomationId() aufgerufen.When overridden in a derived class, is called by GetAutomationId().

GetBoundingRectangle()

Ruft das Rect-Objekt ab, das die Bildschirmkoordinaten des Elements darstellt, das dem Automatisierungspeer zugeordnet ist.Gets the Rect object that represents the screen coordinates of the element that is associated with the automation peer.

GetBoundingRectangleCore()

Wird beim Überschreiben in einer abgeleiteten Klasse von GetBoundingRectangle() aufgerufen.When overridden in a derived class, is called by GetBoundingRectangle().

GetChildren()

Ruft die Auflistung der GetChildren()-Elemente ab, die in der Benutzeroberflächenautomatisierungs-Struktur als direkte untergeordnete Elemente des Automatisierungspeers dargestellt werden.Gets the collection of GetChildren() elements that are represented in the UI Automation tree as immediate child elements of the automation peer.

GetChildrenCore()

Wird beim Überschreiben in einer abgeleiteten Klasse von GetChildren() aufgerufen.When overridden in a derived class, is called by GetChildren().

GetClassName()

Ruft einen Namen ab, der zusammen mit AutomationControlType verwendet wird, um Steuerelement zu unterscheiden, das durch diesen AutomationPeer dargestellt wird.Gets a name that is used with AutomationControlType, to differentiate the control that is represented by this AutomationPeer.

GetClassNameCore()

Wird beim Überschreiben in einer abgeleiteten Klasse von GetClassName() aufgerufen.When overridden in a derived class, is called by GetClassName().

GetClickablePoint()

Ruft einen Point in dem Element ab, das dem Automatisierungspeer zugeordnet ist, der auf einen Mausklick reagiert.Gets a Point on the element that is associated with the automation peer that responds to a mouse click.

GetClickablePointCore()

Wird beim Überschreiben in einer abgeleiteten Klasse von GetClickablePoint() aufgerufen.When overridden in a derived class, is called by GetClickablePoint().

GetControlledPeers()

Stellt die Benutzeroberflächenautomatisierung mit einer Liste von Elementen bereit, die von diesem AutomationPeer betroffen sind oder gesteuert werden.Provides UI Automation with a list of elements affected or controlled by this AutomationPeer.

GetControlledPeersCore()

Stellt beim Überschreiben in einer abgeleiteten Klasse die Benutzeroberflächenautomatisierung mit einer Liste von Elementen bereit, die von diesem AutomationPeer betroffen sind oder gesteuert werden.When overridden in a derived class, provides UI Automation with a list of elements affected or controlled by this AutomationPeer.

GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetHelpText()

Ruft Text ab, der die Funktion des Steuerelements beschreibt, das dem Automatisierungspeer zugeordnet ist.Gets text that describes the functionality of the control that is associated with the automation peer.

GetHelpTextCore()

Wird beim Überschreiben in einer abgeleiteten Klasse von GetHelpText() aufgerufen.When overridden in a derived class, is called by GetHelpText().

GetHostRawElementProviderCore()

Teilt BenutzeroberflächenautomatisierungUI Automation mit, an welcher Stelle der BenutzeroberflächenautomatisierungUI Automation-Struktur das vom Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF)-Element gehostete hwnd-Objekt platziert werden soll.Tells BenutzeroberflächenautomatisierungUI Automation where in the BenutzeroberflächenautomatisierungUI Automation tree to place the hwnd being hosted by a Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) element.

GetItemStatus()

Ruft Text ab, der den visuellen Status des Elements übermittelt, das diesem Automatisierungspeer zugeordnet ist.Gets text that conveys the visual status of the element that is associated with this automation peer.

GetItemStatusCore()

Wird beim Überschreiben in einer abgeleiteten Klasse von GetItemStatus() aufgerufen.When overridden in a derived class, is called by GetItemStatus().

GetItemType()

Ruft eine Zeichenfolge ab, die beschreibt, was für ein Element ein Objekt darstellt.Gets a string that describes what kind of item an object represents.

GetItemTypeCore()

Wird beim Überschreiben in einer abgeleiteten Klasse von GetItemType() aufgerufen.When overridden in a derived class, is called by GetItemType().

GetLabeledBy()

Ruft den AutomationPeer für das Label ab, das für das Element bestimmt ist.Gets the AutomationPeer for the Label that is targeted to the element.

GetLabeledByCore()

Wird beim Überschreiben in einer abgeleiteten Klasse von GetLabeledBy() aufgerufen.When overridden in a derived class, is called by GetLabeledBy().

GetLiveSetting()

Ruft die Benachrichtigungsmerkmale des dynamischen Bereichs ab, der diesem Automatisierungspeer zugeordnet ist.Gets the notification characteristics of a live region that is associated with this automation peer.

GetLiveSettingCore()

Wenn der Wert in einer abgeleiteten Klasse überschrieben wird, werden die Benachrichtigungsmerkmale eines dynamischen Bereichs zurückgegeben.When overridden in a derived class, returns the notification characteristics of a live region. Wird von der GetLiveSetting()-Methode aufgerufen.Called by the GetLiveSetting() method.

GetLocalizedControlType()

Ruft eine lesbare lokalisierte Zeichenfolge ab, die den AutomationControlType-Wert für das Steuerelement darstellt, das diesem Automatisierungspeer zugeordnet ist.Gets a human-readable localized string that represents the AutomationControlType value for the control that is associated with this automation peer.

GetLocalizedControlTypeCore()

Wird beim Überschreiben in einer abgeleiteten Klasse von GetLocalizedControlType() aufgerufen.When overridden in a derived class, is called by GetLocalizedControlType().

GetName()

Ruft den Text ab, der das Element beschreibt, das diesem Automatisierungspeer zugeordnet ist.Gets text that describes the element that is associated with this automation peer.

GetNameCore()

Wird beim Überschreiben in einer abgeleiteten Klasse von GetName() aufgerufen.When overridden in a derived class, is called by GetName().

GetOrientation()

Ruft einen Wert ab, der die explizite Steuerelementausrichtung angibt (sofern vorhanden).Gets a value that indicates the explicit control orientation, if any.

GetOrientationCore()

Wird beim Überschreiben in einer abgeleiteten Klasse von GetOrientation() aufgerufen.When overridden in a derived class, is called by GetOrientation().

GetParent()

Ruft den AutomationPeer ab, der das übergeordnete Element dieses AutomationPeer ist.Gets the AutomationPeer that is the parent of this AutomationPeer.

GetPattern(PatternInterface)

Wenn diese Methode in einer abgeleiteten Klasse überschrieben wird, ruft sie das Steuerelementmuster ab, das der angegebenen PatternInterface zugeordnet ist.When overridden in a derived class, gets the control pattern that is associated with the specified PatternInterface.

GetPeerFromPoint(Point)

Ruft einen AutomationPeer vom angegebenen Punkt ab.Gets an AutomationPeer from the specified point.

GetPeerFromPointCore(Point)

Wird beim Überschreiben in einer abgeleiteten Klasse von GetPeerFromPoint(Point) aufgerufen.When overridden in a derived class, is called from GetPeerFromPoint(Point).

GetPositionInSet()

Versucht, den Wert der PositionInSet-Eigenschaft abzurufen.Attempts to get the value of the PositionInSet property.

GetPositionInSetCore()

Stellt beim Überschreiben in einer abgeleiteten Klasse die Benutzeroberflächenautomatisierung mit einem einsbasierten ganzzahligen Wert bereit, der die Position beschreibt, die dieses Element in einer Gruppe oder in einem Satz belegt.When overridden in a derived class, provides UI Automation with a one-based integer value that describes the position this element occupies in a group or set.

GetSizeOfSet()

Versucht, den Wert der SizeOfSet-Eigenschaft abzurufen.Attempts to get the value of the SizeOfSet property.

GetSizeOfSetCore()

Stellt beim Überschreiben in einer abgeleiteten Klasse die Benutzeroberflächenautomatisierung mit der Größe der Gruppe oder des Satzes bereit, der bzw. dem dieses Element angehört.When overridden in a derived class, provides UI Automation with the size of the group or set that this element belongs to.

GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
HasKeyboardFocus()

Ruft einen Wert ab, der angibt, ob das Element, das diesem Automatisierungspeer zugeordnet ist, derzeit über den Tastaturfokus verfügt.Gets a value that indicates whether the element that is associated with this automation peer currently has keyboard focus.

HasKeyboardFocusCore()

Wird beim Überschreiben in einer abgeleiteten Klasse von HasKeyboardFocus() aufgerufen.When overridden in a derived class, is called by HasKeyboardFocus().

InvalidatePeer()

Löst die Neuberechnung der Haupteigenschaften von AutomationPeer und die PropertyChanged-Benachrichtigung an den Automatisierungsclient aus, wenn die Eigenschaften geändert wurden.Triggers recalculation of the main properties of the AutomationPeer and raises the PropertyChanged notification to the Automation Client if the properties changed.

IsContentElement()

Ruft einen Wert ab, der angibt, ob das diesem Automatisierungspeer zugeordnete Element Daten enthält, die dem Benutzer angezeigt werden.Gets a value that indicates whether the element that is associated with this automation peer contains data that is presented to the user.

IsContentElementCore()

Wird beim Überschreiben in einer abgeleiteten Klasse von IsContentElement() aufgerufen.When overridden in a derived class, is called by IsContentElement().

IsControlElement()

Ruft einen Wert ab, der angibt, ob das Element vom Endbenutzer als interaktiv angesehen wird oder ob es einen Teil der logischen Struktur des Steuerelements in der GUIGUI darstellt.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 GUIGUI.

IsControlElementCore()

Wird beim Überschreiben in einer abgeleiteten Klasse von IsControlElement() aufgerufen.When overridden in a derived class, is called by IsControlElement().

IsEnabled()

Ruft einen Wert ab, der angibt, ob das Element, das diesem Automatisierungspeer zugeordnet ist, Interaktionen unterstützt.Gets a value that indicates whether the element associated with this automation peer supports interaction.

IsEnabledCore()

Wird beim Überschreiben in einer abgeleiteten Klasse von IsEnabled() aufgerufen.When overridden in a derived class, is called by IsEnabled().

IsKeyboardFocusable()

Ruft einen Wert ab, der angibt, ob das Element den Tastaturfokus annehmen kann.Gets a value that indicates whether the element can accept keyboard focus.

IsKeyboardFocusableCore()

Wird beim Überschreiben in einer abgeleiteten Klasse von IsKeyboardFocusable() aufgerufen.When overridden in a derived class, is called by IsKeyboardFocusable().

IsOffscreen()

Ruft einen Wert ab, der angibt, ob sich ein Element außerhalb des Bildschirms befindet.Gets a value that indicates whether an element is off the screen.

IsOffscreenCore()

Wird beim Überschreiben in einer abgeleiteten Klasse von IsOffscreen() aufgerufen.When overridden in a derived class, is called by IsOffscreen().

IsPassword()

Ruft einen Wert ab, der angibt, ob das Element vertraulichen Inhalt enthält.Gets a value that indicates whether the element contains sensitive content.

IsPasswordCore()

Wird beim Überschreiben in einer abgeleiteten Klasse von IsPassword() aufgerufen.When overridden in a derived class, is called by IsPassword().

IsRequiredForForm()

Ruft einen Wert ab, der angibt, ob das Element, das diesem Peer zugeordnet ist, in einem Formular ausgefüllt werden muss.Gets a value that indicates whether the element that is associated with this peer must be completed on a form.

IsRequiredForFormCore()

Wird beim Überschreiben in einer abgeleiteten Klasse von IsRequiredForForm() aufgerufen.When overridden in a derived class, is called by IsRequiredForForm().

ListenerExists(AutomationEvents)

Ruft einen Wert ab, der angibt, ob BenutzeroberflächenautomatisierungUI Automation eine Überwachung in Bezug auf das angegebene Ereignis durchführt.Gets a value that indicates whether BenutzeroberflächenautomatisierungUI Automation is listening for the specified event.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
PeerFromProvider(IRawElementProviderSimple)

Ruft einen AutomationPeer für den angegebenen IRawElementProviderSimple-Proxy ab.Gets an AutomationPeer for the specified IRawElementProviderSimple proxy.

ProviderFromPeer(AutomationPeer)

Ruft IRawElementProviderSimple für den angegebenen AutomationPeer ab.Gets the IRawElementProviderSimple for the specified AutomationPeer.

RaiseAsyncContentLoadedEvent(AsyncContentLoadedEventArgs)

Wird vom AutomationPeer aufgerufen, um das AsyncContentLoadedEvent-Ereignis auszulösen.Called by the AutomationPeer to raise the AsyncContentLoadedEvent event.

RaiseAutomationEvent(AutomationEvents)

Löst ein Automatisierungsereignis aus.Raises an automation event.

RaisePropertyChangedEvent(AutomationProperty, Object, Object)

Löst ein Ereignis aus, um den Automatisierungsclient über einen geänderten Eigenschaftswert zu benachrichtigen.Raises an event to notify the automation client of a changed property value.

ResetChildrenCache()

Setzt durch Aufrufen von GetChildrenCore() die Struktur untergeordneter Elemente synchron zurück.Synchronously resets the tree of child elements by calling GetChildrenCore().

SetFocus()

Legt den Tastaturfokus auf das Element fest, das diesem Automatisierungspeer zugeordnet ist.Sets the keyboard focus on the element that is associated with this automation peer.

SetFocusCore()

Wird beim Überschreiben in einer abgeleiteten Klasse von SetFocus() aufgerufen.When overridden in a derived class, is called by SetFocus().

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)
VerifyAccess()

Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann.Enforces that the calling thread has access to this DispatcherObject.

(Geerbt von DispatcherObject)

Gilt für:

Siehe auch