FrameworkElementAutomationPeer.FromElement(UIElement) Methode

Definition

Namespace:

Windows.UI.Xaml.Automation.Peers

Gibt das 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

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

Beispiele

Der Entwurf für die Automatisierungsunterstützung behält als Teil der Implementierung von OnCreateAutomationPeer kein Handle für Ihren eigenen Peer bei, 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 dem folgenden 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);
    }
}

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

Hinweise

FromElement ist eine Hilfsklasse, die vom benutzerdefinierten Steuerungscode 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. Sie können auch eigene 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 übergebene Element über keine Implementierung für OnCreateAutomationPeer verfügt.

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

Weitere Informationen

• CreatePeerForElement(UIElement)