FrameworkElementAutomationPeer.FromElement(UIElement) Methode

Definition

Namespace:

Microsoft.UI.Xaml.Automation.Peers

Gibt frameworkElementAutomationPeer für das angegebene UIElement zurück.

public:
 static AutomationPeer ^ FromElement(UIElement ^ element);

 static AutomationPeer FromElement(UIElement const& element);

public static AutomationPeer FromElement(UIElement element);

function fromElement(element)

Public Shared Function FromElement (element As UIElement) As AutomationPeer

Parameter

element

UIElement

Das UIElement , das diesem FrameworkElementAutomationPeer zugeordnet ist.

Gibt zurück

AutomationPeer

FrameworkElementAutomationPeer oder NULL, wenn das FrameworkElementAutomationPeer nicht erstellt werden konnte.

Beispiele

Der Entwurf der Automatisierungsunterstützung behält keinen Handle für Ihren eigenen Peer bei, als Teil der Implementierung von OnCreateAutomationPeer, da es keine Garantien dafür gibt, wann der Peer tatsächlich erstellt wird. Stattdessen können Sie in Ihren Steuerelementklassendefinitionen just-in-time mithilfe von Code wie diesem nach Laufzeitautomatisierungsereignislistenern suchen:

if (AutomationPeer.ListenerExists(AutomationEvents.PropertyChanged))
{
    MyAutomationPeer peer = 
        FrameworkElementAutomationPeer.FromElement(myCtrl) as MyAutomationPeer;

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

Hinweise

FromElement ist eine Hilfsklasse, die vom benutzerdefinierten Steuerelementcode verwendet wird, um den handelnden Peer instance zurückzugeben. Mithilfe des zurückgegebenen Peers können Sie Automatisierungsereignisse innerhalb derselben Routinen auslösen, die auch Ihre allgemeinen Steuerungslogikereignisse auslösen oder Steuerelementeigenschaften ändern. Oder Sie können ihre eigenen Hilfsmethoden schreiben, die dies tun und aus Ihrer Steuerelementlogik aufgerufen werden.

CreatePeerForElement hat im Grunde das gleiche Verhalten wie FromElement.

Wenn FromElement NULL zurückgibt, liegt dies wahrscheinlich daran, dass das von Ihnen übergebene Element keine Implementierung für OnCreateAutomationPeer aufweist.

FromElement kann den Peer zurückgeben, auch wenn die CreateAutomationPeer-Systemlogik aus irgendeinem Grund noch nicht für das Elementziel ausgeführt wurde. Es ruft die gleiche CreateAutomationPeer-Logik intern auf, um den Peer abzurufen.

Weitere Informationen

• CreatePeerForElement(UIElement)