FrameworkElementAutomationPeer.FromElement(UIElement) Metodo

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

Restituisce

FrameworkElementAutomationPeer o Null se non è stato possibile creare FrameworkElementAutomationPeer.

Esempio

La progettazione del supporto per l'automazione non mantiene un handle per il peer come parte di come si implementa OnCreateAutomationPeer, perché non esistono 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 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);
    }
}

Commenti

FromElement è una classe helper utilizzata dal codice di controllo personalizzato per restituire l'istanza peer agendo. Usando il peer restituito, è possibile generare eventi di automazione dall'interno delle stesse routine che attivano anche gli eventi della 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 internamente la stessa logica CreateAutomationPeer per ottenere il peer.

Si applica a

Vedi anche

• CreatePeerForElement(UIElement)