FrameworkElementAutomationPeer.FromElement(UIElement) Metodo

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Automation.Peers

Restituisce frameworkElementAutomationPeer per l'UIElement specificato.

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

Parametri

element

UIElement

UIElement associato a frameworkElementAutomationPeer.

Restituisce

AutomationPeer

FrameworkElementAutomationPeer o Null se non è stato possibile creare FrameworkElementAutomationPeer.

Esempio

La progettazione del supporto per l'automazione non mantiene un handle al peer come parte del modo in cui si implementa OnCreateAutomationPeer, perché non sono presenti garanzie di quando il peer viene effettivamente creato. È invece possibile verificare la presenza di listener di eventi di automazione in fase di esecuzione all'interno delle definizioni della classe di controllo just-in-time usando il codice simile al seguente:

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

Commenti

FromElement è una classe helper usata dal codice di controllo personalizzato per restituire l'istanza peer che agisce. Usando il peer restituito, è possibile generare eventi di automazione all'interno delle stesse routine che generano anche gli eventi di logica di controllo generale o le proprietà del controllo delle modifiche. In alternativa, è possibile scrivere metodi helper personalizzati che eseguono questa operazione e vengono richiamati dalla logica di controllo.

CreatePeerForElement ha fondamentalmente lo stesso comportamento di FromElement.

Se FromElement restituisce Null, è probabile che l'elemento passato non abbia un'implementazione per OnCreateAutomationPeer.

FromElement può restituire il peer anche se la logica di sistema CreateAutomationPeer non è ancora stata eseguita nella destinazione dell'elemento per qualche motivo. Richiama la stessa logica CreateAutomationPeer internamente per ottenere il peer.

Vedi anche

• CreatePeerForElement(UIElement)