Konstanta Peristiwa (Winuser.h)
Topik ini menjelaskan peristiwa yang dihasilkan oleh sistem operasi dan oleh aplikasi server. Konstanta tercantum dalam urutan alfabet.
Sebelum menggunakan peristiwa ini, aplikasi klien harus menggunakan Pengamat Peristiwa yang Dapat Diakses untuk memverifikasi bahwa peristiwa ini digunakan oleh elemen UI.
Untuk informasi selengkapnya tentang peristiwa secara umum, lihat Apa itu WinEvents? dan Peristiwa Tingkat Sistem dan Tingkat Objek. Untuk informasi selengkapnya tentang peristiwa yang dikirim oleh sistem, lihat Lampiran A: Referensi Elemen Antarmuka Pengguna yang Didukung.
| Konstanta/nilai | Deskripsi |
|---|---|
|
Rentang nilai konstanta WinEvent yang ditentukan oleh Accessibility Interoperability Alliance (AIA) untuk digunakan di seluruh industri. Untuk informasi selengkapnya, lihat Alokasi ID WinEvent. |
|
Nilai peristiwa terendah dan tertinggi yang mungkin. |
|
Properti KeyboardShortcut objek telah berubah. Aplikasi server mengirimkan kejadian ini untuk objek yang dapat diakses. |
|
Dikirim saat jendela diselubungi. Jendela berjubah masih ada, tetapi tidak terlihat oleh pengguna. |
|
Pengguliran objek jendela telah berakhir. Tidak seperti EVENT_SYSTEM_SCROLLEND, peristiwa ini dikaitkan dengan jendela gulir. Apakah pengguliran adalah pengguliran horizontal atau vertikal, kejadian ini harus dikirim setiap kali tindakan gulir selesai. Parameter hwnd dari fungsi panggilan balik WinEventProc menjelaskan jendela pengguliran; parameter idObjectOBJID_CLIENT, dan parameter idChildCHILDID_SELF. |
|
Objek telah dibuat. Sistem mengirimkan kejadian ini untuk elemen antarmuka pengguna berikut: tanda sisipan, kontrol header, kontrol tampilan daftar, kontrol tab, kontrol toolbar, kontrol tampilan pohon, dan objek jendela . Aplikasi server mengirimkan kejadian ini untuk objek yang dapat diakses. Sebelum mengirim peristiwa untuk objek induk, server harus mengirimkannya untuk semua objek anak objek. Server harus memastikan bahwa semua objek anak sepenuhnya dibuat dan siap untuk menerima panggilan IAccessible dari klien sebelum objek induk mengirim kejadian ini. Karena objek induk dibuat setelah objek turunannya, klien harus memastikan bahwa induk objek telah dibuat sebelum memanggil IAccessible::get_accParent, terutama jika fungsi kait dalam konteks digunakan. |
|
Properti DefaultAction objek telah berubah. Sistem mengirimkan kejadian ini untuk kotak dialog. Aplikasi server mengirimkan kejadian ini untuk objek yang dapat diakses. |
|
Properti Deskripsi objek telah berubah. Aplikasi server mengirimkan kejadian ini untuk objek yang dapat diakses. |
|
Objek telah dihancurkan. Sistem mengirimkan kejadian ini untuk elemen antarmuka pengguna berikut: tanda sisipan, kontrol header, kontrol tampilan daftar, kontrol tab, kontrol toolbar, kontrol tampilan pohon, dan objek jendela. Aplikasi server mengirimkan kejadian ini untuk objek yang dapat diakses. Klien mengasumsikan bahwa semua anak objek dihancurkan ketika objek induk mengirim peristiwa ini. Setelah menerima peristiwa ini, klien tidak memanggil properti atau metode IAccessible objek. Namun, penunjuk antarmuka harus tetap valid selama ada jumlah referensi di atasnya (karena aturan COM), tetapi elemen UI mungkin tidak lagi ada. Panggilan lebih lanjut pada penunjuk antarmuka dapat mengembalikan kesalahan kegagalan; untuk mencegah hal ini, server membuat objek proksi dan memantau rentang hidupnya. |
|
Pengguna mulai menyeret elemen. Parameter hwnd, idObject, dan idChild dari fungsi panggilan balik WinEventProc mengidentifikasi objek yang diseret. |
|
Pengguna telah mengakhiri operasi seret sebelum menghilangkan elemen yang diseret pada target penghilangan. Parameter hwnd, idObject, dan idChild dari fungsi panggilan balik WinEventProc mengidentifikasi objek yang diseret. |
|
Pengguna menghilangkan elemen pada target penghilangan. Parameter hwnd, idObject, dan idChild dari fungsi panggilan balik WinEventProc mengidentifikasi objek yang diseret. |
|
Pengguna menyeret elemen ke dalam batas target penghilangan. Parameter hwnd, idObject, dan idChild dari fungsi panggilan balik WinEventProc mengidentifikasi target penurunan. |
|
Pengguna menyeret elemen keluar dari batas target penghilangan. Parameter hwnd, idObject, dan idChild dari fungsi panggilan balik WinEventProc mengidentifikasi target penurunan. |
|
Pengguna menghilangkan elemen pada target penghilangan. Parameter hwnd, idObject, dan idChild dari fungsi panggilan balik WinEventProc mengidentifikasi target penurunan. |
|
Nilai peristiwa objek tertinggi. |
|
Objek telah menerima fokus keyboard. Sistem mengirimkan kejadian ini untuk elemen antarmuka pengguna berikut: kontrol tampilan daftar, bilah menu, menu pop-up, jendela sakelar, kontrol tab, kontrol tampilan pohon, dan objek jendela. Aplikasi server mengirimkan kejadian ini untuk objek yang dapat diakses. Parameter hwnd dari fungsi panggilan balik WinEventProc mengidentifikasi jendela yang menerima fokus keyboard. |
|
Properti Bantuan objek telah berubah. Aplikasi server mengirimkan kejadian ini untuk objek yang dapat diakses. |
|
Objek disembunyikan. Sistem mengirimkan peristiwa ini untuk elemen antarmuka pengguna berikut: tanda sisipan dan kursor. Aplikasi server mengirimkan kejadian ini untuk objek yang dapat diakses. Ketika kejadian ini dihasilkan untuk objek induk, semua objek anak sudah disembunyikan. Aplikasi server tidak mengirim kejadian ini untuk objek anak. Objek tersembunyi mencakup bendera STATE_SYSTEM_INVISIBLE ; objek yang ditampilkan tidak menyertakan bendera ini. Peristiwa EVENT_OBJECT_HIDE juga menunjukkan bahwa bendera STATE_SYSTEM_INVISIBLE diatur. Oleh karena itu, server tidak mengirim peristiwa EVENT_OBJECT_STATECHANGE dalam hal ini. |
|
Jendela yang menghosting objek lain yang dapat diakses telah mengubah objek yang dihosting. Klien mungkin perlu mengkueri jendela host untuk menemukan objek baru yang dihosting, terutama jika klien telah memantau peristiwa dari jendela. Objek yang dihosting adalah objek dari kerangka kerja aksesibilitas (MSAA atau Automation UI) yang berbeda dari host. Perubahan pada objek yang dihosting yang berasal dari kerangka kerja yang sama dengan host harus diserahkan dengan peristiwa perubahan struktural, seperti EVENT_OBJECT_CREATE untuk MSAA. Untuk informasi selengkapnya, lihat komentar dalam winuser.h. |
|
Jendela IME telah menjadi tersembunyi. |
|
Jendela IME telah terlihat. |
|
Ukuran atau posisi jendela IME telah berubah. |
|
Objek telah dipanggil; misalnya, pengguna telah mengklik tombol. Kejadian ini didukung oleh kontrol umum dan digunakan oleh Automation UI. Untuk peristiwa ini, parameter hwnd, ID, dan idChild dari fungsi panggilan balik WinEventProc mengidentifikasi item yang dipanggil. |
|
Objek yang merupakan bagian dari wilayah langsung telah berubah. Wilayah langsung adalah area aplikasi yang sering berubah dan/atau asinkron. |
|
Objek telah mengubah lokasi, bentuk, atau ukuran. Sistem mengirimkan peristiwa ini untuk elemen antarmuka pengguna berikut: objek tanda sisipan dan jendela. Aplikasi server mengirimkan kejadian ini untuk objek yang dapat diakses. Kejadian ini dihasilkan sebagai respons terhadap perubahan objek tingkat atas dalam hierarki objek; ini tidak dihasilkan untuk setiap anak yang mungkin dimiliki objek. Misalnya, jika pengguna mengubah ukuran jendela, sistem mengirimkan pemberitahuan ini untuk jendela, tetapi tidak untuk bilah menu, bilah judul, bilah gulir, atau objek lain yang juga telah berubah. Sistem tidak mengirim kejadian ini untuk setiap jendela turunan non-mengambang ketika induk bergerak. Namun, jika aplikasi secara eksplisit mengubah ukuran jendela anak sebagai akibat dari mengubah ukuran jendela induk, sistem mengirimkan beberapa peristiwa untuk turunan yang diubah ukurannya. Jika properti Status objek diatur ke STATE_SYSTEM_FLOATING, server mengirim EVENT_OBJECT_LOCATIONCHANGE setiap kali objek berubah lokasi. Jika objek tidak memiliki status ini, server hanya memicu kejadian ini ketika objek bergerak dalam kaitannya dengan induknya. Untuk pemberitahuan peristiwa ini, parameter idChild dari fungsi panggilan balik WinEventProc mengidentifikasi objek anak yang telah berubah. |
|
Properti Nama objek telah berubah. Sistem mengirimkan kejadian ini untuk elemen antarmuka pengguna berikut: kotak centang, kursor, kontrol tampilan daftar, tombol dorong, tombol radio, kontrol bilah status, kontrol tampilan pohon, dan objek jendela. Aplikasi server mengirimkan kejadian ini untuk objek yang dapat diakses. |
|
Objek memiliki objek induk baru. Aplikasi server mengirimkan kejadian ini untuk objek yang dapat diakses. |
|
Objek kontainer telah menambahkan, menghapus, atau menyusun ulang turunannya. Sistem mengirimkan kejadian ini untuk elemen antarmuka pengguna berikut: kontrol header, kontrol tampilan daftar, kontrol toolbar, dan objek jendela. Aplikasi server mengirimkan kejadian ini yang sesuai untuk objek yang dapat diakses. Misalnya, peristiwa ini dihasilkan oleh objek tampilan daftar saat jumlah elemen anak atau urutan elemen berubah. Kejadian ini juga dikirim oleh jendela induk ketika urutan Z untuk jendela anak berubah. |
|
Pilihan dalam objek kontainer telah berubah. Sistem mengirimkan peristiwa ini untuk elemen antarmuka pengguna berikut: kontrol tampilan daftar, kontrol tab, kontrol tampilan pohon, dan objek jendela. Aplikasi server mengirimkan kejadian ini untuk objek yang dapat diakses. Kejadian ini menandakan satu pilihan: salah satu anak dipilih dalam kontainer yang sebelumnya tidak berisi anak yang dipilih, atau pilihan telah berubah dari satu anak ke anak lainnya. Parameter hwnd dan idObject dari fungsi panggilan balik WinEventProc menjelaskan kontainer; parameter idChild mengidentifikasi objek yang dipilih. Jika anak yang dipilih adalah jendela yang juga berisi objek, parameter idChildOBJID_WINDOW. |
|
Anak dalam objek kontainer telah ditambahkan ke pilihan yang ada. Sistem mengirimkan kejadian ini untuk elemen antarmuka pengguna berikut: kotak daftar, kontrol tampilan daftar, dan kontrol tampilan pohon. Aplikasi server mengirimkan kejadian ini untuk objek yang dapat diakses. Parameter hwnd dan idObject dari fungsi panggilan balik WinEventProc menjelaskan kontainer. Parameter idChild adalah anak yang ditambahkan ke pilihan. |
|
Item dalam objek kontainer telah dihapus dari pilihan. Sistem mengirimkan kejadian ini untuk elemen antarmuka pengguna berikut: kotak daftar, kontrol tampilan daftar, dan kontrol tampilan pohon. Aplikasi server mengirimkan kejadian ini untuk objek yang dapat diakses. Kejadian ini menandakan bahwa anak dihapus dari pilihan yang ada. Parameter hwnd dan idObject dari fungsi panggilan balik WinEventProc menjelaskan kontainer; parameter idChild mengidentifikasi anak yang telah dihapus dari pilihan. |
|
Banyak perubahan pilihan telah terjadi dalam objek kontainer. Sistem mengirimkan kejadian ini untuk kotak daftar; aplikasi server mengirimkannya untuk objek yang dapat diakses. Kejadian ini dikirim ketika item yang dipilih dalam kontrol telah berubah secara substansial. Peristiwa ini memberi tahu klien bahwa banyak perubahan pilihan telah terjadi, dan dikirim alih-alih beberapa peristiwa EVENT_OBJECT_SELECTIONADD atau EVENT_OBJECT_SELECTIONREMOVE . Klien meminta item yang dipilih dengan memanggil metode IAccessible::get_accSelection objek kontainer dan menghitung item yang dipilih. Untuk pemberitahuan peristiwa ini, parameter hwnd dan idObject dari fungsi panggilan balik WinEventProc menjelaskan kontainer tempat perubahan terjadi. |
|
Objek tersembunyi ditampilkan. Sistem mengirimkan peristiwa ini untuk elemen antarmuka pengguna berikut: tanda sisipan, kursor, dan objek jendela. Aplikasi server mengirimkan kejadian ini untuk objek yang dapat diakses. Klien mengasumsikan bahwa ketika peristiwa ini dikirim oleh objek induk, semua objek anak sudah ditampilkan. Oleh karena itu, aplikasi server tidak mengirim kejadian ini untuk objek anak. Objek tersembunyi mencakup bendera STATE_SYSTEM_INVISIBLE ; objek yang ditampilkan tidak menyertakan bendera ini. Peristiwa EVENT_OBJECT_SHOW juga menunjukkan bahwa bendera STATE_SYSTEM_INVISIBLE dibersihkan. Oleh karena itu, server tidak mengirim peristiwa EVENT_OBJECT_STATECHANGE dalam hal ini. |
|
Status objek telah berubah. Sistem mengirimkan kejadian ini untuk elemen antarmuka pengguna berikut: kotak centang, kotak kombo, kontrol header, tombol dorong, tombol radio, bilah gulir, kontrol toolbar, kontrol tampilan pohon, kontrol naik turun, dan objek jendela. Aplikasi server mengirimkan kejadian ini untuk objek yang dapat diakses. Misalnya, perubahan status terjadi saat objek tombol diklik atau dirilis, atau saat objek diaktifkan atau dinonaktifkan. Untuk pemberitahuan peristiwa ini, parameter idChild dari fungsi panggilan balik WinEventProc mengidentifikasi objek anak yang statusnya telah berubah. |
|
Target konversi dalam komposisi IME telah berubah. Target konversi adalah subset komposisi IME yang secara aktif dipilih sebagai target untuk konversi yang dimulai pengguna. |
|
Pilihan teks objek telah berubah. Kejadian ini didukung oleh kontrol umum dan digunakan oleh Automation UI. Parameter hwnd, ID, dan idChild dari fungsi panggilan balik WinEventProc menjelaskan item yang terkandung dalam pilihan teks yang diperbarui. |
|
Dikirim ketika jendela tidak di-uncloaked. Jendela berjubah masih ada, tetapi tidak terlihat oleh pengguna. |
|
Properti Nilai objek telah berubah. Sistem mengirimkan peristiwa ini untuk elemen antarmuka pengguna yang menyertakan bilah gulir dan kontrol berikut: edit, header, kunci panas, bilah kemajuan, penggeser, dan naik ke bawah. Aplikasi server mengirimkan kejadian ini untuk objek yang dapat diakses. |
|
Rentang nilai konstanta peristiwa yang disediakan untuk OEM. Untuk informasi selengkapnya, lihat Alokasi ID WinEvent. |
|
Pemberitahuan telah dibuat. Aplikasi server tidak boleh mengirim kejadian ini. |
|
Persegi pratinjau sedang ditampilkan. |
|
Jendela telah kehilangan tangkapan mouse. Kejadian ini dikirim oleh sistem, tidak pernah oleh server. |
|
Jendela telah menerima tangkapan mouse. Kejadian ini dikirim oleh sistem, tidak pernah oleh server. |
|
Jendela telah keluar dari mode Bantuan peka konteks. Kejadian ini tidak dikirim secara konsisten oleh sistem. |
|
Jendela telah memasuki mode Bantuan peka konteks. Kejadian ini tidak dikirim secara konsisten oleh sistem. |
|
Desktop aktif telah dialihkan. |
|
Kotak dialog telah ditutup. Sistem mengirimkan kejadian ini untuk kotak dialog standar; server mengirimkannya untuk kotak dialog kustom. Kejadian ini tidak dikirim secara konsisten oleh sistem. |
|
Kotak dialog telah ditampilkan. Sistem mengirimkan peristiwa ini untuk kotak dialog standar, yang dibuat menggunakan templat sumber daya atau fungsi kotak dialog Win32. Server mengirim kejadian ini untuk kotak dialog kustom, yang merupakan jendela yang berfungsi sebagai kotak dialog tetapi tidak dibuat dengan cara standar. Kejadian ini tidak dikirim secara konsisten oleh sistem. |
|
Aplikasi akan keluar dari mode seret dan letakkan. Aplikasi yang mendukung operasi seret dan letakkan harus mengirim peristiwa ini; sistem tidak mengirim kejadian ini. |
|
Aplikasi akan memasuki mode seret dan letakkan. Aplikasi yang mendukung operasi seret dan letakkan harus mengirim kejadian ini karena sistem tidak mengirimkannya. |
|
Nilai peristiwa sistem tertinggi. |
|
Jendela latar depan telah berubah. Sistem mengirimkan peristiwa ini bahkan jika jendela latar depan telah berubah ke jendela lain di utas yang sama. Aplikasi server tidak pernah mengirim kejadian ini. Untuk peristiwa ini, parameter hwnd fungsi panggilan balik WinEventProc adalah handel ke jendela yang berada di latar depan, parameter idObjectOBJID_WINDOW, dan parameter idChildCHILDID_SELF. |
|
Menu pop-up telah ditutup. Sistem mengirimkan kejadian ini untuk menu standar; server mengirimkannya untuk menu kustom. Saat menu pop-up ditutup, klien menerima pesan ini, lalu peristiwa EVENT_SYSTEM_MENUEND . Kejadian ini tidak dikirim secara konsisten oleh sistem. |
|
Menu pop-up telah ditampilkan. Sistem mengirimkan peristiwa ini untuk menu standar, yang diidentifikasi oleh HMENU, dan dibuat menggunakan sumber daya templat menu atau fungsi menu Win32. Server mengirim peristiwa ini untuk menu kustom, yang merupakan elemen antarmuka pengguna yang berfungsi sebagai menu tetapi tidak dibuat dengan cara standar. Kejadian ini tidak dikirim secara konsisten oleh sistem. |
|
Menu dari bilah menu telah ditutup. Sistem mengirimkan kejadian ini untuk menu standar; server mengirimkannya untuk menu kustom. Untuk peristiwa ini, parameter hwnd, idObject, dan idChild fungsi panggilan balik WinEventProc mengacu pada kontrol yang berisi bilah menu atau kontrol yang mengaktifkan menu konteks. Parameter hwnd adalah handel ke jendela yang terkait dengan peristiwa. Parameter idObjectOBJID_MENU atau OBJID_SYSMENU untuk menu, atau OBJID_WINDOW untuk menu pop-up. Parameter idChildCHILDID_SELF. |
|
Item menu pada bilah menu telah dipilih. Sistem mengirimkan peristiwa ini untuk menu standar, yang diidentifikasi oleh HMENU, dibuat menggunakan sumber daya templat menu atau elemen API menu Win32. Server mengirim kejadian ini untuk menu kustom, yang merupakan elemen antarmuka pengguna yang berfungsi sebagai menu tetapi tidak dibuat dengan cara standar. Untuk kejadian ini, parameter hwnd, idObject, dan idChild fungsi callback WinEventProc merujuk ke kontrol yang berisi bilah menu atau kontrol yang mengaktifkan menu konteks. Parameter hwnd adalah handel ke jendela yang terkait dengan peristiwa. Parameter idObjectOBJID_MENU atau OBJID_SYSMENU untuk menu, atau OBJID_WINDOW untuk menu pop-up. Parameter idChildCHILDID_SELF. Sistem memicu lebih dari satu peristiwa EVENT_SYSTEM_MENUSTART yang tidak selalu sesuai dengan peristiwa EVENT_SYSTEM_MENUEND . |
|
Objek jendela akan dipulihkan. Kejadian ini dikirim oleh sistem, tidak pernah oleh server. |
|
Objek jendela akan diminimalkan. Kejadian ini dikirim oleh sistem, tidak pernah oleh server. |
|
Pergerakan atau mengubah ukuran jendela telah selesai. Kejadian ini dikirim oleh sistem, tidak pernah oleh server. |
|
Jendela sedang dipindahkan atau diubah ukurannya. Kejadian ini dikirim oleh sistem, tidak pernah oleh server. |
|
Pengguliran telah berakhir pada bilah gulir. Kejadian ini dikirim oleh sistem untuk kontrol bilah gulir standar dan untuk bilah gulir yang dilampirkan ke jendela. Server mengirim kejadian ini untuk bilah gulir kustom, yang merupakan elemen antarmuka pengguna yang berfungsi sebagai bilah gulir tetapi tidak dibuat dengan cara standar. Parameter idObject yang dikirim ke fungsi panggilan balik WinEventProcOBJID_HSCROLL untuk bilah gulir horizontal, dan OBJID_VSCROLL untuk bilah gulir vertikal. |
|
Pengguliran telah dimulai pada bilah gulir. Sistem mengirimkan kejadian ini untuk kontrol bilah gulir standar dan untuk bilah gulir yang terpasang pada jendela. Server mengirim kejadian ini untuk bilah gulir kustom, yang merupakan elemen antarmuka pengguna yang berfungsi sebagai bilah gulir tetapi tidak dibuat dengan cara standar. Parameter idObject yang dikirim ke fungsi panggilan balik WinEventProcOBJID_HSCROLL untuk bilah gulir horizontal, dan OBJID_VSCROLL untuk bilah gulir vertikal. |
|
Suara telah diputar. Sistem mengirimkan peristiwa ini ketika suara sistem, seperti satu untuk menu, diputar bahkan jika tidak ada suara yang dapat didengar (misalnya, karena kurangnya file suara atau kartu suara). Server mengirim kejadian ini setiap kali elemen UI kustom menghasilkan suara. Untuk kejadian ini, fungsi panggilan balik WinEventProc menerima nilai OBJID_SOUND sebagai parameter idObject . |
|
Pengguna telah merilis ALT+TAB. Kejadian ini dikirim oleh sistem, tidak pernah oleh server. Parameter hwnd dari fungsi panggilan balik WinEventProc mengidentifikasi jendela yang telah dialihkan pengguna. Jika hanya satu aplikasi yang berjalan saat pengguna menekan ALT+TAB, sistem mengirimkan peristiwa ini tanpa peristiwa EVENT_SYSTEM_SWITCHSTART yang sesuai. |
|
Pengguna telah menekan ALT+TAB, yang mengaktifkan jendela sakelar. Kejadian ini dikirim oleh sistem, tidak pernah oleh server. Parameter hwnd dari fungsi panggilan balik WinEventProc mengidentifikasi jendela tempat pengguna beralih. Jika hanya satu aplikasi yang berjalan saat pengguna menekan ALT+TAB, sistem mengirim peristiwa EVENT_SYSTEM_SWITCHEND tanpa peristiwa EVENT_SYSTEM_SWITCHSTART yang sesuai. |
|
Rentang nilai konstanta peristiwa yang disediakan untuk pengidentifikasi peristiwa Otomatisasi UI. Untuk informasi selengkapnya, lihat Alokasi ID WinEvent. |
|
Rentang nilai konstanta peristiwa yang dicadangkan untuk pengidentifikasi peristiwa yang diubah properti UI Automation. Untuk informasi selengkapnya, lihat Alokasi ID WinEvent. |
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header |
|
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk