FrameworkElementAutomationPeer.FromElement(UIElement) Méthode

Définition

Espace de noms:

Microsoft.UI.Xaml.Automation.Peers

Retourne le FrameworkElementAutomationPeer pour l’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 la 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 d’exécution à l’intérieur de vos définitions de classe de contrôle juste-à-temps, à l’aide de 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);
    }
}

Remarques

FromElement est une classe d’assistance utilisée par le code de contrôle personnalisé pour renvoyer le instance homologue agissant. À l’aide de l’homologue retourné, vous pouvez déclencher des événements d’automatisation à partir des mêmes routines que celles qui déclenchent également vos événements logiques de contrôle généraux 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 d’élément pour une raison quelconque. Il appelle la même logique CreateAutomationPeer en interne afin d’obtenir l’homologue.

Voir aussi

• CreatePeerForElement(UIElement)