FrameworkElementAutomationPeer.FromElement(UIElement) Metode

Definisi

Ruang nama:

Windows.UI.Xaml.Automation.Peers

Mengembalikan FrameworkElementAutomationPeer untuk UIElement yang ditentukan.

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

Parameter

element

UIElement

UIElement yang terkait dengan FrameworkElementAutomationPeer ini.

Mengembalikan

AutomationPeer

FrameworkElementAutomationPeer, atau null jika FrameworkElementAutomationPeer tidak dapat dibuat.

Contoh

Desain dukungan otomatisasi tidak mempertahankan handel ke serekan Anda sendiri sebagai bagian dari cara Anda menerapkan OnCreateAutomationPeer, karena tidak ada jaminan kapan serekan benar-benar dibuat. Sebagai gantinya, Anda dapat memeriksa pendengar peristiwa otomatisasi run-time di dalam definisi kelas kontrol Anda tepat waktu, menggunakan kode seperti ini:

if (AutomationPeer.ListenerExists(AutomationEvents.PropertyChanged))
{
    MyAutomationPeer peer = 
        FrameworkElementAutomationPeer.FromElement(myCtrl) as MyAutomationPeer;

    if (peer != null)
    {
        peer.RaisePropertyChangedEvent(
            RangeValuePatternIdentifiers.ValueProperty,
            (double)oldValue,
            (double)newValue);
    }
}

If AutomationPeer.ListenerExists(AutomationEvents.PropertyChanged) Then
    Dim peer As MyDownAutomationPeer = _
    TryCast(FrameworkElementAutomationPeer.FromElement(myCtrl), MyAutomationPeer)
    If peer IsNot Nothing Then
        peer.RaisePropertyChangedEvent(RangeValuePatternIdentifiers.ValueProperty, CDbl(oldValue), CDbl(newValue))
    End If
End If

Keterangan

FromElement adalah kelas pembantu yang digunakan oleh kode kontrol kustom untuk mengembalikan instans serekan bertindak. Dengan menggunakan peer yang dikembalikan, Anda dapat mengaktifkan peristiwa otomatisasi dari dalam rutinitas yang sama yang juga mengaktifkan peristiwa logika kontrol umum Anda atau mengubah properti kontrol. Atau Anda dapat menulis metode pembantu Anda sendiri yang melakukan ini dan dipanggil dari logika kontrol Anda.

CreatePeerForElement pada dasarnya memiliki perilaku yang sama dengan FromElement.

Jika FromElement mengembalikan null, itu mungkin karena elemen yang Anda lewati tidak memiliki implementasi untuk OnCreateAutomationPeer.

FromElement dapat mengembalikan peer meskipun logika sistem CreateAutomationPeer belum berjalan pada target elemen karena alasan tertentu. Ini akan memanggil logika CreateAutomationPeer yang sama secara internal untuk mendapatkan peer.

Lihat juga

• CreatePeerForElement(UIElement)