UIElement.OnCreateAutomationPeer Metodo

Riferimento

Definizione

Spazio dei nomi:: Microsoft.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

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

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 OnCreateAutomationPeer implementazione deve consistere nel costruire la classe peer di automazione personalizzata e restituirla.

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

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

Commenti

Per altre info 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.

È necessario 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 predefinitaOnCreateAutomationPeer. La modalità di 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 info sul motivo per cui potresti voler definire un nuovo peer, vedi Peer di automazione personalizzati.

Nota

Questo esempio non viene gestito e potrebbe non essere compilato.

Vedi 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 faccia altro che inizializzare una nuova istanza del peer di automazione personalizzato, passando il controllo chiamante come proprietario e restituendo 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

Condividi tramite