UIElement.OnCreateAutomationPeer Metode

Referensi

Definisi

Ruang nama:: Microsoft.UI.Xaml

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

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 OnCreateAutomationPeer implementasi harus terdiri dari membangun kelas peer 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());
    }

Keterangan

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

Anda harus mengganti metode ini di kelas kustom tempat Anda ingin menyediakan peer otomatisasi kustom untuk Microsoft UI Automation, bukan serekan default yang direferensikan oleh implementasi default OnCreateAutomationPeer . Cara Anda menentukan serekan kustom untuk kontrol kustom Anda tergantung 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).

OnCreateAutomationPeer Sebaiknya implementasi tidak lebih dari menginisialisasi instans baru dari rekan 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

Share via