AccessibleEvents Enum
Definisi
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.
Menentukan peristiwa yang dilaporkan oleh aplikasi yang dapat diakses.
public enum class AccessibleEventspublic enum AccessibleEventstype AccessibleEvents = Public Enum AccessibleEvents- Warisan
Bidang
| Nama | Nilai | Deskripsi |
|---|---|---|
| SystemSound | 1 | Suara diputar. Sistem mengirimkan kejadian ini ketika suara sistem, seperti untuk menu, diputar, bahkan jika tidak ada suara yang dapat didengar. Ini mungkin disebabkan oleh kurangnya file suara atau kartu suara. Server mengirim peristiwa ini jika elemen antarmuka pengguna kustom menghasilkan suara. |
| SystemAlert | 2 | Pemberitahuan dibuat. Aplikasi server mengirim peristiwa ini setiap kali terjadi perubahan antarmuka pengguna penting yang mungkin perlu diketahui pengguna. Sistem tidak mengirim peristiwa secara konsisten untuk objek kotak dialog. |
| SystemForeground | 3 | Jendela latar depan berubah. Sistem mengirimkan peristiwa ini bahkan jika jendela latar depan diubah ke jendela lain di utas yang sama. Aplikasi server tidak pernah mengirim kejadian ini. |
| SystemMenuStart | 4 | Item menu pada bilah menu dipilih. Sistem mengirimkan kejadian ini untuk menu standar. Server mengirim kejadian ini untuk menu kustom. Sistem mungkin menaikkan lebih dari satu |
| SystemMenuEnd | 5 | Menu dari bilah menu ditutup. Sistem mengirimkan kejadian ini untuk menu standar. Server mengirim kejadian ini untuk menu kustom. |
| SystemMenuPopupStart | 6 | Menu pintasan ditampilkan. Sistem mengirimkan kejadian ini untuk menu standar. Server mengirim kejadian ini untuk menu kustom. Sistem tidak mengirim peristiwa secara konsisten. Untuk panggilan ke |
| SystemMenuPopupEnd | 7 | Menu pintasan ditutup. Sistem mengirimkan kejadian ini untuk menu standar. Server mengirim kejadian ini untuk menu kustom. Ketika menu pintasan ditutup, klien menerima pesan ini diikuti hampir segera oleh Untuk panggilan ke |
| SystemCaptureStart | 8 | Jendela sedang dipindahkan atau diubah ukurannya. Sistem mengirimkan peristiwa; server tidak pernah mengirim kejadian ini. |
| SystemCaptureEnd | 9 | Jendela telah kehilangan tangkapan mouse. Sistem mengirimkan peristiwa; server tidak pernah mengirim kejadian ini. |
| SystemMoveSizeStart | 10 | Jendela sedang dipindahkan atau diubah ukurannya. Sistem mengirimkan peristiwa; server tidak pernah mengirim kejadian ini. |
| SystemMoveSizeEnd | 11 | Pergerakan atau perubahan ukuran jendela selesai. Sistem mengirimkan peristiwa; server tidak pernah mengirim kejadian ini. |
| SystemContextHelpStart | 12 | Jendela memasuki mode Bantuan peka konteks. Sistem tidak mengirim peristiwa secara konsisten. |
| SystemContextHelpEnd | 13 | Jendela keluar dari mode Bantuan peka konteks. Sistem tidak mengirim peristiwa secara konsisten. |
| SystemDragDropStart | 14 | Aplikasi akan memasuki mode seret dan letakkan. Aplikasi yang mendukung operasi seret dan letakkan harus mengirim peristiwa ini; sistem tidak. |
| SystemDragDropEnd | 15 | Aplikasi akan keluar dari mode seret dan letakkan. Aplikasi yang mendukung operasi seret dan letakkan harus mengirim peristiwa ini; sistem tidak. |
| SystemDialogStart | 16 | Kotak dialog ditampilkan. Sistem mengirimkan peristiwa untuk kotak dialog standar. Server mengirim kejadian ini untuk kotak dialog kustom. Sistem tidak mengirim peristiwa secara konsisten. |
| SystemDialogEnd | 17 | Kotak dialog ditutup. Sistem tidak mengirim peristiwa untuk kotak dialog standar. Server mengirim kejadian ini untuk kotak dialog kustom. Sistem tidak mengirim peristiwa secara konsisten. |
| SystemScrollingStart | 18 | Pengguliran telah dimulai pada bilah gulir. Sistem mengirimkan peristiwa untuk bilah gulir yang dilampirkan ke jendela dan untuk kontrol bilah gulir standar. Server mengirim kejadian ini untuk bilah gulir kustom. |
| SystemScrollingEnd | 19 | Pengguliran telah berakhir pada bilah gulir. Sistem mengirimkan kejadian ini untuk bilah gulir yang dilampirkan ke jendela dan untuk kontrol bilah gulir standar. Server mengirim kejadian ini untuk bilah gulir kustom. |
| SystemSwitchStart | 20 | Pengguna menekan ALT+TAB, yang mengaktifkan jendela sakelar. Jika hanya satu aplikasi yang berjalan saat pengguna menekan ALT+TAB, sistem akan menaikkan |
| SystemSwitchEnd | 21 | Pengguna merilis ALT+TAB. Sistem mengirim |
| SystemMinimizeStart | 22 | Objek jendela akan diminimalkan atau dimaksimalkan. Sistem mengirimkan peristiwa; server tidak pernah mengirim kejadian ini. |
| SystemMinimizeEnd | 23 | Objek jendela diminimalkan atau dimaksimalkan. Sistem mengirimkan peristiwa; server tidak pernah mengirim kejadian ini. |
| Create | 32768 | Objek dibuat. Sistem operasi mengirimkan peristiwa 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. Server harus mengirim kejadian ini untuk semua objek anak objek sebelum mengirim kejadian untuk objek induk. Server harus memastikan bahwa semua objek anak sepenuhnya dibuat dan siap untuk menerima panggilan dari klien ketika objek induk mengirim peristiwa. |
| Destroy | 32769 | Sebuah objek 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. Kejadian ini mungkin atau mungkin tidak dikirim untuk objek turunan. Namun, klien dapat menyimpulkan bahwa semua anak objek telah dihancurkan ketika objek induk mengirim peristiwa ini. |
| Show | 32770 | Objek tersembunyi sedang ditampilkan. Sistem mengirimkan kejadian ini untuk elemen antarmuka pengguna berikut: tanda sisipan, kursor, dan objek jendela. Aplikasi server mengirimkan kejadian ini untuk objek yang dapat diakses. Klien dapat menyimpulkan bahwa, ketika peristiwa ini dikirim oleh objek induk, semua objek turunan telah ditampilkan. Oleh karena itu, aplikasi server tidak perlu mengirim kejadian ini untuk objek anak. |
| Hide | 32771 | Objek disembunyikan. Sistem mengirimkan peristiwa untuk elemen antarmuka pengguna berikut: tanda sisipan dan kursor. Aplikasi server mengirim peristiwa untuk objek yang dapat diakses. Ketika peristiwa dihasilkan untuk objek induk, semua objek turunan telah disembunyikan. Oleh karena itu, aplikasi server tidak perlu mengirim peristiwa untuk objek anak. Sistem tidak mengirim peristiwa secara konsisten. |
| Reorder | 32772 | 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 mengirim kejadian ini sesuai untuk objek yang dapat diakses. Kejadian ini juga dikirim oleh jendela induk ketika urutan z untuk jendela anak berubah. |
| Focus | 32773 | Objek telah menerima fokus keyboard. Sistem mengirimkan kejadian ini untuk elemen antarmuka pengguna berikut: kontrol tampilan daftar, bilah menu, menu pintasan, jendela sakelar, kontrol tab, kontrol tampilan pohon, dan objek jendela. Aplikasi server mengirimkan kejadian ini untuk objek yang dapat diakses. |
| Selection | 32774 | Objek yang dapat diakses dalam objek kontainer telah dipilih. Kejadian ini menandakan satu pilihan. Anak telah dipilih dalam kontainer yang sebelumnya tidak berisi turunan terpilih, atau pilihan telah berubah dari satu anak ke anak lainnya. |
| SelectionAdd | 32775 | Item dalam objek kontainer ditambahkan ke 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 telah ditambahkan ke pilihan yang ada. |
| SelectionRemove | 32776 | Item dalam objek kontainer 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 telah dihapus dari pilihan yang ada. |
| SelectionWithin | 32777 | Banyak perubahan pilihan terjadi dalam objek kontainer. Sistem mengirimkan kejadian ini untuk kotak daftar. Aplikasi server mengirimkan kejadian ini untuk objek yang dapat diakses. Kejadian ini dapat dikirim ketika item yang dipilih dalam kontrol telah berubah secara substansial. Kejadian ini memberi tahu klien bahwa banyak perubahan pilihan telah terjadi. Ini lebih disukai untuk mengirim beberapa |
| StateChange | 32778 | Status objek telah berubah. Sistem mengirimkan peristiwa untuk elemen antarmuka pengguna berikut: kotak centang, kotak kombo, kontrol header, tombol tekan, tombol radio, bilah gulir, kontrol toolbar, kontrol tampilan pohon, kontrol naik turun, dan objek jendela. Aplikasi server mengirim peristiwa untuk objek yang dapat diakses. Misalnya, perubahan status dapat terjadi ketika objek tombol telah ditekan atau dirilis, atau ketika objek diaktifkan atau dinonaktifkan. Sistem tidak mengirim peristiwa secara konsisten. |
| LocationChange | 32779 | Objek telah mengubah lokasi, bentuk, atau ukuran. Sistem mengirimkan kejadian 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 objek tingkat atas dalam hierarki objek yang telah berubah, bukan untuk anak-anak apa pun yang mungkin dikandungnya. Misalnya, jika pengguna mengubah ukuran jendela, sistem mengirim 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 anak non-mengambang ketika induk bergerak. Namun, jika aplikasi secara eksplisit mengubah ukuran jendela anak sebagai akibat dari diubah ukurannya, sistem mengirimkan beberapa peristiwa untuk anak-anak yang diubah ukurannya. Jika properti objek State diatur ke Floating, server harus mengirim peristiwa perubahan lokasi setiap kali objek berubah lokasi. Jika objek tidak memiliki status ini, server harus menaikkan kejadian ini ketika objek bergerak relatif terhadap induknya. |
| NameChange | 32780 | Properti objek Name berubah. Sistem mengirimkan kejadian ini untuk elemen antarmuka pengguna berikut: kotak centang, kursor, kontrol tampilan daftar, tombol tekan, tombol radio, kontrol bilah status, kontrol tampilan pohon, dan objek jendela. Aplikasi server mengirimkan kejadian ini untuk objek yang dapat diakses. |
| DescriptionChange | 32781 | Properti objek Description berubah. Aplikasi server mengirimkan kejadian ini untuk objek yang dapat diakses. |
| ValueChange | 32782 | Properti objek Value berubah. Sistem menaikkan |
| ParentChange | 32783 | Objek memiliki objek induk baru. Aplikasi server mengirimkan kejadian ini untuk objek yang dapat diakses. |
| HelpChange | 32784 | Properti objek Help berubah. Aplikasi server mengirimkan kejadian ini untuk objek yang dapat diakses. |
| DefaultActionChange | 32785 | Properti objek DefaultAction berubah. Sistem mengirimkan kejadian ini untuk kotak dialog. Aplikasi server mengirimkan kejadian ini untuk objek yang dapat diakses. Oleh karena itu, aplikasi server tidak perlu mengirim kejadian ini untuk objek anak. Objek tersembunyi memiliki status Invisible, dan objek yang ditampilkan tidak. Peristiwa jenis |
| AcceleratorChange | 32786 | Properti objek KeyboardShortcut berubah. Aplikasi server mengirim peristiwa untuk objek yang dapat diakses. |
Contoh
Contoh kode berikut menunjukkan pembuatan kontrol bagan sadar aksesibilitas, menggunakan AccessibleObject kelas dan Control.ControlAccessibleObject untuk mengekspos informasi yang dapat diakses. Kontrol memplot dua kurva bersama dengan legenda. Kelas ChartControlAccessibleObject , yang berasal dari ControlAccessibleObject, digunakan dalam CreateAccessibilityInstance metode untuk memberikan informasi yang dapat diakses kustom untuk kontrol bagan. Karena legenda bagan bukan kontrol -based aktual Control , tetapi sebaliknya digambar oleh kontrol bagan, itu bukan informasi bawaan yang dapat diakses. Karena itu, ChartControlAccessibleObject kelas mengambil alih GetChild metode untuk mengembalikan CurveLegendAccessibleObject yang mewakili informasi yang dapat diakses untuk setiap bagian legenda. Ketika aplikasi yang mudah diakses menggunakan kontrol ini, kontrol dapat memberikan informasi yang dapat diakses yang diperlukan.
Contoh ini menunjukkan penggunaan AccessibleEvents enumerasi dengan AccessibilityNotifyClients metode . AccessibleObject Lihat gambaran umum kelas untuk contoh kode lengkap.
// Gets or sets the location for the curve legend.
Point get()
{
return location;
}
void set( Point value )
{
location = value;
chart->Invalidate();
// Notifies the chart of the location change. This is used for
// the accessibility information. AccessibleEvents::LocationChange
// tells the chart the reason for the notification.
chart->AccessibilityNotifyClients( AccessibleEvents::LocationChange, (dynamic_cast<CurveLegendAccessibleObject^>(AccessibilityObject))->ID );
}
}
property String^ Name
{
// Gets or sets the Name for the curve legend.
String^ get()
{
return name;
}
void set( String^ value )
{
if ( name != value )
{
name = value;
chart->Invalidate();
// Notifies the chart of the name change. This is used for
// the accessibility information. AccessibleEvents::NameChange
// tells the chart the reason for the notification.
chart->AccessibilityNotifyClients( AccessibleEvents::NameChange, (dynamic_cast<CurveLegendAccessibleObject^>(AccessibilityObject))->ID );
}
}
}
property bool Selected
{
// Gets or sets the Selected state for the curve legend.
bool get()
{
return selected;
}
void set( bool value )
{
if ( selected != value )
{
selected = value;
chart->Invalidate();
// Notifies the chart of the selection value change. This is used for
// the accessibility information. The AccessibleEvents value depends upon
// if the selection is true (AccessibleEvents::SelectionAdd) or
// false (AccessibleEvents::SelectionRemove).
chart->AccessibilityNotifyClients( selected ? AccessibleEvents::SelectionAdd : AccessibleEvents::SelectionRemove, (dynamic_cast<CurveLegendAccessibleObject^>(AccessibilityObject))->ID );
}
}
// Gets or sets the location for the curve legend.
public Point Location
{
get {
return location;
}
set {
location = value;
chart.Invalidate();
// Notifies the chart of the location change. This is used for
// the accessibility information. AccessibleEvents.LocationChange
// tells the chart the reason for the notification.
chart.AccessibilityNotifyClients(AccessibleEvents.LocationChange,
((CurveLegendAccessibleObject)AccessibilityObject).ID);
}
}
// Gets or sets the Name for the curve legend.
public string Name
{
get {
return name;
}
set {
if (name != value)
{
name = value;
chart.Invalidate();
// Notifies the chart of the name change. This is used for
// the accessibility information. AccessibleEvents.NameChange
// tells the chart the reason for the notification.
chart.AccessibilityNotifyClients(AccessibleEvents.NameChange,
((CurveLegendAccessibleObject)AccessibilityObject).ID);
}
}
}
// Gets or sets the Selected state for the curve legend.
public bool Selected
{
get {
return selected;
}
set {
if (selected != value)
{
selected = value;
chart.Invalidate();
// Notifies the chart of the selection value change. This is used for
// the accessibility information. The AccessibleEvents value depends upon
// if the selection is true (AccessibleEvents.SelectionAdd) or
// false (AccessibleEvents.SelectionRemove).
chart.AccessibilityNotifyClients(
selected ? AccessibleEvents.SelectionAdd : AccessibleEvents.SelectionRemove,
((CurveLegendAccessibleObject)AccessibilityObject).ID);
}
}
}
' Gets or sets the location for the curve legend.
Public Property Location() As Point
Get
Return m_location
End Get
Set
m_location = value
chart.Invalidate()
' Notifies the chart of the location change. This is used for
' the accessibility information. AccessibleEvents.LocationChange
' tells the chart the reason for the notification.
chart.ExposeAccessibilityNotifyClients(AccessibleEvents.LocationChange, _
CType(AccessibilityObject, CurveLegendAccessibleObject).ID)
End Set
End Property
' Gets or sets the Name for the curve legend.
Public Property Name() As String
Get
Return m_name
End Get
Set
If m_name <> value Then
m_name = value
chart.Invalidate()
' Notifies the chart of the name change. This is used for
' the accessibility information. AccessibleEvents.NameChange
' tells the chart the reason for the notification.
chart.ExposeAccessibilityNotifyClients(AccessibleEvents.NameChange, _
CType(AccessibilityObject, CurveLegendAccessibleObject).ID)
End If
End Set
End Property
' Gets or sets the Selected state for the curve legend.
Public Property Selected() As Boolean
Get
Return m_selected
End Get
Set
If m_selected <> value Then
m_selected = value
chart.Invalidate()
' Notifies the chart of the selection value change. This is used for
' the accessibility information. The AccessibleEvents value varies
' on whether the selection is true (AccessibleEvents.SelectionAdd) or
' false (AccessibleEvents.SelectionRemove).
If m_selected Then
chart.ExposeAccessibilityNotifyClients(AccessibleEvents.SelectionAdd, _
CType(AccessibilityObject, CurveLegendAccessibleObject).ID)
Else
chart.ExposeAccessibilityNotifyClients(AccessibleEvents.SelectionRemove, _
CType(AccessibilityObject, CurveLegendAccessibleObject).ID)
End If
End If
End Set
End Property
Keterangan
Aplikasi sistem operasi dan server aksesibilitas menghasilkan peristiwa aksesibilitas sebagai respons terhadap perubahan di antarmuka pengguna.
Enumerasi ini digunakan oleh AccessibleObject dan Control.
Untuk informasi selengkapnya, lihat Aksesibilitas Microsoft Active.
