FrameworkElementAutomationPeer.FromElement(UIElement) Méthode

Définition

Espace de noms:

Windows.UI.Xaml.Automation.Peers

Retourne l’objet FrameworkElementAutomationPeer pour l’élément UIElement spécifié.

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

Paramètres

element

UIElement

UIElement associé à ce FrameworkElementAutomationPeer.

Retours

AutomationPeer

FrameworkElementAutomationPeer ou null si frameworkElementAutomationPeer n’a pas pu être créé.

Exemples

La conception de prise en charge de l’automatisation ne conserve pas de handle pour votre propre homologue dans le cadre de la façon dont vous implémentez OnCreateAutomationPeer, car il n’existe aucune garantie quant au moment où l’homologue est réellement créé. Au lieu de cela, vous pouvez case activée pour les écouteurs d’événements d’automatisation au moment de l’exécution à l’intérieur de vos définitions de classe de contrôle juste-à-temps, en utilisant du code comme suit :

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

Remarques

FromElement est une classe d’assistance qui est utilisée par le code de contrôle personnalisé pour retourner l’homologue agissant instance. À l’aide de l’homologue retourné, vous pouvez déclencher des événements d’automatisation à partir des mêmes routines qui déclenchent également vos événements de logique de contrôle général ou modifient les propriétés de contrôle. Vous pouvez également écrire vos propres méthodes d’assistance qui effectuent cette opération et qui sont appelées à partir de votre logique de contrôle.

CreatePeerForElement a essentiellement le même comportement que FromElement.

Si FromElement retourne null, c’est probablement parce que l’élément que vous avez transmis n’a pas d’implémentation pour OnCreateAutomationPeer.

FromElement peut retourner l’homologue même si la logique système CreateAutomationPeer n’a pas encore été exécutée sur la cible de l’élément pour une raison quelconque. Il appelle la même logique CreateAutomationPeer en interne afin d’obtenir l’homologue.

Voir aussi

• CreatePeerForElement(UIElement)