UIElement.OnCreateAutomationPeer Metodo

Riferimento

Definizione

Spazio dei nomi:: Windows.UI.Xaml

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Quando implementato in una classe derivata, restituisce implementazioni di AutomationPeer specifiche della classe per l'infrastruttura di Automazione interfaccia utente Microsoft.

protected:
 virtual AutomationPeer ^ OnCreateAutomationPeer() = OnCreateAutomationPeer;

AutomationPeer OnCreateAutomationPeer();

protected virtual AutomationPeer OnCreateAutomationPeer();

function onCreateAutomationPeer()

Protected Overridable Function OnCreateAutomationPeer () As AutomationPeer

Restituisce

AutomationPeer

Sottoclasse AutomationPeer specifica della classe da restituire.

Esempio

L'intera attività di un'implementazione OnCreateAutomationPeer deve essere costituita dalla costruzione della classe peer di automazione personalizzata e restituita.

protected override AutomationPeer OnCreateAutomationPeer() 
{
    return new MediaContainerAP(this, mediaElement); 
}

#include "MediaContainerAP.h"
...
public:
    MyNamespace::MediaContainerAP OnCreateAutomationPeer()
    {
        return winrt::make<MyNamespace::implementation::MediaContainerAP>(*this, mediaElement());
    }

protected:
    virtual AutomationPeer^ OnCreateAutomationPeer() override
    {
        return ref new MediaContainerAP(this, mediaElement);
    }
};

Protected Overrides Function OnCreateAutomationPeer() As AutomationPeer
    Return New MediaContainerAP(Me, mediaElement)
End Function

Commenti

Per altre informazioni sullo scopo di un peer di automazione e sul motivo per cui potrebbe essere necessario definire una classe AutomationPeer specifica della classe, vedere Peer di automazione personalizzati.

È consigliabile eseguire l'override di questo metodo in una classe personalizzata in cui si vuole fornire un peer di automazione personalizzato per Microsoft Automazione interfaccia utente anziché il peer predefinito a cui fa riferimento l'implementazione predefinita OnCreateAutomationPeer. La definizione di un peer personalizzato per il controllo personalizzato dipende dai requisiti di accessibilità del controllo, dal relativo contratto dell'interfaccia utente e dal relativo comportamento. Per altre informazioni sul motivo per cui è possibile definire un nuovo peer, vedere Peer di automazione personalizzati.

Nota

Questo esempio non viene gestito e potrebbe non essere compilato.

Vedere l'esempio di accessibilità XAML per un'implementazione di OnCreateAutomationPeer che definisce il peer personalizzato restituito da OnCreateAutomationPeer (l'implementazione peer fa parte dello scenario 3 in questo esempio).

È consigliabile che l'implementazione onCreateAutomationPeer non debba eseguire più di inizializzare una nuova istanza del peer di automazione personalizzato, passando il controllo chiamante come proprietario e restituisce tale istanza. Non tentare di usare logica aggiuntiva in questo metodo. In particolare, qualsiasi logica che potrebbe portare alla distruzione di AutomationPeer nella stessa chiamata potrebbe provocare un comportamento di runtime imprevisto.

Si applica a