Bagikan melalui

UIElement.OnCreateAutomationPeer Metode

  • Referensi

Definisi

Ruang nama:
Windows.UI.Xaml
Edit

Saat diimplementasikan di kelas turunan, mengembalikan implementasi AutomationPeer khusus kelas untuk infrastruktur Microsoft UI Automation.

protected:
 virtual AutomationPeer ^ OnCreateAutomationPeer() = OnCreateAutomationPeer;
AutomationPeer OnCreateAutomationPeer();
protected virtual AutomationPeer OnCreateAutomationPeer();
function onCreateAutomationPeer()
Protected Overridable Function OnCreateAutomationPeer () As AutomationPeer

Mengembalikan

AutomationPeer

Subkelas AutomationPeer khusus kelas yang akan dikembalikan.

Contoh

Keseluruhan implementasi OnCreateAutomationPeer harus terdiri dari membangun kelas serekan otomatisasi kustom dan mengembalikannya.

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

Keterangan

Untuk informasi selengkapnya tentang tujuan rekan otomatisasi dan mengapa Anda mungkin perlu menentukan kelas AutomationPeer khusus kelas, lihat Rekan otomatisasi kustom.

Anda harus mengambil alih metode ini di kelas kustom tempat Anda ingin menyediakan peer otomatisasi kustom untuk Microsoft UI Automation, bukan serekan default yang direferensikan oleh implementasi OnCreateAutomationPeer default. Cara Anda menentukan serekan kustom untuk kontrol kustom Anda bergantung pada persyaratan aksesibilitas kontrol Anda, kontrak UI-nya, dan perilakunya. Untuk informasi selengkapnya tentang mengapa Anda mungkin ingin menentukan serekan baru, lihat Rekan otomatisasi kustom.

Catatan

Sampel ini tidak dipertahankan dan mungkin tidak dikompilasi.

Lihat sampel aksesibilitas XAML untuk implementasi OnCreateAutomationPeer yang menentukan peer kustom yang dikembalikan oleh OnCreateAutomationPeer (implementasi serekan adalah bagian dari Skenario 3 dalam sampel ini).

Kami menyarankan agar implementasi OnCreateAutomationPeer tidak boleh melakukan apa pun selain menginisialisasi instans baru dari peer otomatisasi kustom Anda, meneruskan kontrol panggilan sebagai pemilik, dan mengembalikan instans tersebut. Jangan coba logika tambahan dalam metode ini. Secara khusus, logika apa pun yang berpotensi menyebabkan penghancuran AutomationPeer dalam panggilan yang sama dapat mengakibatkan perilaku runtime yang tidak terduga.

Berlaku untuk

Lihat juga