AccessibleRole Enum

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

Sumber:: AccessibleRoles.cs

Sumber:: AccessibleRoles.cs

Sumber:: AccessibleRoles.cs

Sumber:: AccessibleRoles.cs

Sumber:: AccessibleRoles.cs

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 nilai yang mewakili kemungkinan peran untuk objek yang dapat diakses.

public enum class AccessibleRole

public enum AccessibleRole

type AccessibleRole =

Public Enum AccessibleRole

Warisan: Object

ValueType

Enum
AccessibleRole

Bidang

Nama	Nilai	Deskripsi
Default	-1	Peran yang disediakan sistem.
None	0	Tidak ada peran.
TitleBar	1	Judul atau bilah keterangan untuk jendela.
MenuBar	2	Bilah menu, biasanya di bawah bilah judul jendela, tempat pengguna dapat memilih menu.
ScrollBar	3	Bilah gulir vertikal atau horizontal, yang dapat menjadi bagian dari area klien atau digunakan dalam kontrol.
Grip	4	Penunjuk mouse khusus, yang memungkinkan pengguna memanipulasi elemen antarmuka pengguna seperti jendela. Misalnya, pengguna dapat mengklik dan menyeret pegangan ukuran di sudut kanan bawah jendela untuk mengubah ukurannya.
Sound	5	Suara sistem, yang terkait dengan berbagai peristiwa sistem.
Cursor	6	Penunjuk mouse.
Caret	7	Tanda sisipan, yang merupakan garis berkedip, blok, atau bitmap yang menandai lokasi titik penyisipan di area klien jendela.
Alert	8	Pemberitahuan atau kondisi yang dapat Anda beri tahu pengguna. Gunakan peran ini hanya untuk objek yang mewujudkan pemberitahuan tetapi tidak terkait dengan elemen antarmuka pengguna lain, seperti kotak pesan, grafik, teks, atau suara.
Window	9	Bingkai jendela, yang biasanya berisi objek anak seperti bilah judul, klien, dan objek lain yang biasanya terkandung dalam jendela.
Client	10	Area pengguna jendela.
MenuPopup	11	Menu, yang menyajikan daftar opsi tempat pengguna dapat membuat pilihan untuk melakukan tindakan. Semua jenis menu harus memiliki peran ini, termasuk menu drop-down yang ditampilkan berdasarkan pilihan dari bilah menu, dan menu pintasan yang ditampilkan saat tombol kanan mouse diklik.
MenuItem	12	Item menu, yang merupakan entri di menu yang dapat dipilih pengguna untuk melakukan perintah, memilih opsi, atau menampilkan menu lain. Secara fungsional, item menu dapat setara dengan tombol tekan, tombol radio, kotak centang, atau menu.
ToolTip	13	Tips alat, yang merupakan jendela pop-up persegi kecil yang menampilkan deskripsi singkat tentang tujuan tombol.
Application	14	Jendela utama untuk aplikasi.
Document	15	Jendela dokumen, yang selalu terkandung dalam jendela aplikasi. Peran ini hanya berlaku untuk jendela antarmuka beberapa dokumen (MDI) dan mengacu pada objek yang berisi bilah judul MDI.
Pane	16	Area terpisah dalam bingkai, jendela dokumen terpisah, atau area persegi panjang bilah status yang dapat digunakan untuk menampilkan informasi. Pengguna dapat menavigasi antar panel dan dalam konten panel saat ini, tetapi tidak dapat menavigasi antar item di panel yang berbeda. Dengan demikian, panel mewakili tingkat pengelompokan yang lebih rendah dari jendela bingkai atau dokumen, tetapi di atas kontrol individual. Biasanya, pengguna menavigasi antar panel dengan menekan TAB, F6, atau CTRL+TAB, tergantung pada konteksnya.
Chart	17	Gambar grafis yang digunakan untuk mewakili data.
Dialog	18	Kotak dialog atau kotak pesan.
Border	19	Batas jendela. Seluruh batas diwakili oleh satu objek, bukan oleh objek terpisah untuk setiap sisi.
Grouping	20	Objek yang dikelompokkan secara logis. Mungkin ada hubungan induk-anak antara objek pengelompokan dan objek yang dikandungnya.
Separator	21	Ruang dibagi secara visual menjadi dua wilayah, seperti item menu pemisah atau pemisah membagi panel pemisah dalam jendela.
ToolBar	22	Toolbar, yang merupakan pengelompokan kontrol yang menyediakan akses mudah ke fitur yang sering digunakan.
StatusBar	23	Bilah status, yang merupakan area biasanya di bagian bawah jendela aplikasi yang menampilkan informasi tentang operasi saat ini, status aplikasi, atau objek yang dipilih. Bilah status dapat memiliki beberapa bidang yang menampilkan berbagai jenis informasi, seperti penjelasan perintah menu yang saat ini dipilih di bilah status.
Table	24	Tabel yang berisi baris dan kolom sel dan, secara opsional, header baris dan header kolom.
ColumnHeader	25	Header kolom, yang menyediakan label visual untuk kolom dalam tabel.
RowHeader	26	Header baris, yang menyediakan label visual untuk baris tabel.
Column	27	Kolom sel dalam tabel.
Row	28	Baris sel dalam tabel.
Cell	29	Sel dalam tabel.
Link	30	Tautan, yang merupakan koneksi antara dokumen sumber dan dokumen tujuan. Objek ini mungkin terlihat seperti teks atau grafik, tetapi bertindak seperti tombol.
HelpBalloon	31	Tampilan Bantuan dalam bentuk TipsAlat atau Balon Bantuan, yang berisi tombol dan label yang dapat diklik pengguna untuk membuka topik Bantuan kustom.
Character	32	Objek grafis seperti kartun, seperti Asisten Microsoft Office, yang biasanya ditampilkan untuk memberikan bantuan kepada pengguna aplikasi.
List	33	Kotak daftar, yang memungkinkan pengguna memilih satu atau beberapa item.
ListItem	34	Item dalam kotak daftar atau bagian daftar kotak kombo, kotak daftar drop-down, atau kotak kombo turun bawah.
Outline	35	Struktur kerangka atau pohon, seperti kontrol tampilan pohon, yang menampilkan daftar hierarkis dan biasanya memungkinkan pengguna untuk memperluas dan menciutkan cabang.
OutlineItem	36	Item dalam kerangka atau struktur pohon.
PageTab	37	Halaman properti yang memungkinkan pengguna untuk melihat atribut untuk halaman, seperti judul halaman, apakah itu halaman beranda, atau apakah halaman telah dimodifikasi. Biasanya, satu-satunya anak dari kontrol ini adalah objek yang dikelompokkan yang berisi konten halaman terkait.
PropertyPage	38	Halaman properti, yang merupakan kotak dialog yang mengontrol tampilan dan perilaku objek, seperti file atau sumber daya. Tampilan halaman properti berbeda sesuai dengan tujuannya.
Indicator	39	Indikator, seperti grafik penunjuk, yang menunjuk ke item saat ini.
Graphic	40	Gambar.
StaticText	41	Teks baca-saja, seperti dalam label, untuk kontrol atau instruksi lain dalam kotak dialog. Teks statis tidak dapat diubah atau dipilih.
Text	42	Teks yang dapat dipilih yang dapat diedit atau baca-saja.
PushButton	43	Kontrol tombol tekan, yang merupakan kontrol persegi kecil yang dapat diaktifkan atau dinonaktifkan pengguna. Tombol tekan, juga dikenal sebagai tombol perintah, memiliki tampilan yang dinaikkan dalam status mati default dan penampilan tenggelam saat dihidupkan.
CheckButton	44	Kontrol kotak centang, yang merupakan opsi yang dapat diaktifkan atau dinonaktifkan terlepas dari opsi lain.
RadioButton	45	Tombol opsi, juga dikenal sebagai tombol radio. Semua objek yang berbagi induk tunggal yang memiliki atribut ini diasumsikan sebagai bagian dari satu grup yang saling eksklusif. Anda dapat menggunakan objek yang dikelompokkan untuk membagi tombol opsi menjadi grup terpisah jika perlu.
ComboBox	46	Kotak kombo, yang merupakan kontrol edit dengan kotak daftar terkait yang menyediakan sekumpulan pilihan yang telah ditentukan sebelumnya.
DropList	47	Kotak daftar drop-down. Kontrol ini memperlihatkan satu item dan memungkinkan pengguna untuk menampilkan dan memilih item lain dari daftar pilihan alternatif.
ProgressBar	48	Bilah kemajuan, yang menunjukkan kemajuan operasi panjang dengan menampilkan garis berwarna di dalam persegi panjang horizontal. Panjang garis sehubungan dengan panjang persegi panjang sesuai dengan persentase operasi yang selesai. Kontrol ini tidak mengambil input pengguna.
Dial	49	Kenop atau kenop. Ini juga bisa menjadi objek baca-saja, seperti speedometer.
HotkeyField	50	Bidang hot-key yang memungkinkan pengguna memasukkan kombinasi atau urutan penekanan tombol untuk digunakan sebagai hot key, yang memungkinkan pengguna untuk melakukan tindakan dengan cepat. Kontrol hot-key menampilkan penekanan tombol yang dimasukkan oleh pengguna dan memastikan bahwa pengguna memilih kombinasi kunci yang valid.
Slider	51	Kontrol, kadang-kadang disebut trackbar, yang memungkinkan pengguna untuk menyesuaikan pengaturan dalam kenaikan tertentu antara nilai minimum dan maksimum dengan memindahkan slider. Kontrol volume dalam sistem operasi Windows adalah kontrol penggerak.
SpinButton	52	Kotak putar, juga dikenal sebagai kontrol naik turun, yang berisi sepasang tombol panah. Pengguna mengklik tombol panah dengan mouse untuk menaikkan atau menurunkan nilai. Kontrol tombol putar paling sering digunakan dengan kontrol pendamping, yang disebut jendela teman, tempat nilai saat ini ditampilkan.
Diagram	53	Gambar grafis yang digunakan untuk membuat diagram data.
Animation	54	Kontrol animasi, yang berisi konten yang berubah dari waktu ke waktu, seperti kontrol yang menampilkan serangkaian bingkai bitmap, seperti filmstrip. Kontrol animasi biasanya ditampilkan ketika file sedang disalin, atau ketika beberapa tugas lain yang memakan waktu sedang dilakukan.
Equation	55	Persamaan matematika.
ButtonDropDown	56	Tombol yang menjatuhkan daftar item.
ButtonMenu	57	Tombol yang menurun menu.
ButtonDropDownGrid	58	Tombol yang menjatuhkan kisi.
WhiteSpace	59	Spasi kosong di antara objek lain.
PageTabList	60	Kontainer kontrol tab halaman.
Clock	61	Kontrol yang menampilkan waktu.
SplitButton	62	Tombol toolbar yang memiliki ikon daftar drop-down yang berdekatan langsung dengan tombol .
IpAddress	63	Kontrol yang dirancang untuk memasukkan alamat Protokol Internet (IP).
OutlineButton	64	Kontrol yang menavigasi seperti item kerangka.

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 AccessibleRole enumerasi dengan Role properti . AccessibleObject Lihat gambaran umum kelas untuk contoh kode lengkap.

// Inner class ChartControlAccessibleObject represents accessible information associated with the ChartControl.
// The ChartControlAccessibleObject is returned in the ChartControl::CreateAccessibilityInstance .
ref class ChartControlAccessibleObject: public ControlAccessibleObject
{
private:
   ChartControl^ chartControl;

public:
   ChartControlAccessibleObject( ChartControl^ ctrl )
      : ControlAccessibleObject( ctrl )
   {
      chartControl = ctrl;
   }


   property System::Windows::Forms::AccessibleRole Role 
   {

      // Gets the role for the Chart. This is used by accessibility programs.
      virtual System::Windows::Forms::AccessibleRole get() override
      {
         return ::AccessibleRole::Chart;
      }

   }

   property AccessibleStates State 
   {

      // Gets the state for the Chart. This is used by accessibility programs.
      virtual AccessibleStates get() override
      {
         return AccessibleStates::ReadOnly;
      }

   }

   // The CurveLegend objects are "child" controls in terms of accessibility so
   // return the number of ChartLengend objects.
   virtual int GetChildCount() override
   {
      return chartControl->Legends->Length;
   }


   // Gets the Accessibility object of the child CurveLegend idetified by index.
   virtual AccessibleObject^ GetChild( int index ) override
   {
      if ( index >= 0 && index < chartControl->Legends->Length )
      {
         return chartControl->Legends[ index ]->AccessibilityObject;
      }

      return nullptr;
   }


internal:

   // Helper function that is used by the CurveLegend's accessibility object
   // to navigate between sibiling controls. Specifically, this function is used in
   // the CurveLegend::CurveLegendAccessibleObject.Navigate function.
   AccessibleObject^ NavigateFromChild( CurveLegend::CurveLegendAccessibleObject^ child, AccessibleNavigation navdir )
   {
      switch ( navdir )
      {
         case AccessibleNavigation::Down:
         case AccessibleNavigation::Next:
            return GetChild( child->ID + 1 );

         case AccessibleNavigation::Up:
         case AccessibleNavigation::Previous:
            return GetChild( child->ID - 1 );
      }
      return nullptr;
   }


   // Helper function that is used by the CurveLegend's accessibility object
   // to select a specific CurveLegend control. Specifically, this function is used
   // in the CurveLegend::CurveLegendAccessibleObject.Select function.
   void SelectChild( CurveLegend::CurveLegendAccessibleObject^ child, AccessibleSelection selection )
   {
      int childID = child->ID;
      
      // Determine which selection action should occur, based on the
      // AccessibleSelection value.
      if ( (selection & AccessibleSelection::TakeSelection) != (AccessibleSelection)0 )
      {
         for ( int i = 0; i < chartControl->Legends->Length; i++ )
         {
            if ( i == childID )
            {
               chartControl->Legends[ i ]->Selected = true;
            }
            else
            {
               chartControl->Legends[ i ]->Selected = false;
            }

         }
         
         // AccessibleSelection->AddSelection means that the CurveLegend will be selected.
         if ( (selection & AccessibleSelection::AddSelection) != (AccessibleSelection)0 )
         {
            chartControl->Legends[ childID ]->Selected = true;
         }
         
         // AccessibleSelection->AddSelection means that the CurveLegend will be unselected.
         if ( (selection & AccessibleSelection::RemoveSelection) != (AccessibleSelection)0 )
         {
            chartControl->Legends[ childID ]->Selected = false;
         }
      }
   }

};

// class ChartControlAccessibleObject

// Inner class ChartControlAccessibleObject represents accessible information associated with the ChartControl.
// The ChartControlAccessibleObject is returned in the ChartControl.CreateAccessibilityInstance override.
public class ChartControlAccessibleObject : ControlAccessibleObject
{
    ChartControl chartControl;

    public ChartControlAccessibleObject(ChartControl ctrl) : base(ctrl) 
    {
        chartControl = ctrl;
    }

    // Gets the role for the Chart. This is used by accessibility programs.
    public override AccessibleRole Role
    {  
        get {
            return AccessibleRole.Chart;
        }
    }

    // Gets the state for the Chart. This is used by accessibility programs.
    public override AccessibleStates State
    {  
        get {                    
            return AccessibleStates.ReadOnly;
        }
    }

    // The CurveLegend objects are "child" controls in terms of accessibility so 
    // return the number of ChartLengend objects.
    public override int GetChildCount()
    {  
        return chartControl.Legends.Length;
    }

    // Gets the Accessibility object of the child CurveLegend idetified by index.
    public override AccessibleObject GetChild(int index)
    {  
        if (index >= 0 && index < chartControl.Legends.Length) {
            return chartControl.Legends[index].AccessibilityObject;
        }                
        return null;
    }

    // Helper function that is used by the CurveLegend's accessibility object
    // to navigate between sibiling controls. Specifically, this function is used in
    // the CurveLegend.CurveLegendAccessibleObject.Navigate function.
    internal AccessibleObject NavigateFromChild(CurveLegend.CurveLegendAccessibleObject child, 
                                                AccessibleNavigation navdir) 
    {  
        switch(navdir) {
            case AccessibleNavigation.Down:
            case AccessibleNavigation.Next:
                return GetChild(child.ID + 1);
                
            case AccessibleNavigation.Up:
            case AccessibleNavigation.Previous:
                return GetChild(child.ID - 1);                        
        }
        return null;
    }

    // Helper function that is used by the CurveLegend's accessibility object
    // to select a specific CurveLegend control. Specifically, this function is used
    // in the CurveLegend.CurveLegendAccessibleObject.Select function.
    internal void SelectChild(CurveLegend.CurveLegendAccessibleObject child, AccessibleSelection selection) 
    {   
        int childID = child.ID;

        // Determine which selection action should occur, based on the
        // AccessibleSelection value.
        if ((selection & AccessibleSelection.TakeSelection) != 0) {
            for(int i = 0; i < chartControl.Legends.Length; i++) {
                if (i == childID) {
                    chartControl.Legends[i].Selected = true;                        
                } else {
                    chartControl.Legends[i].Selected = false;
                }
            }

            // AccessibleSelection.AddSelection means that the CurveLegend will be selected.
            if ((selection & AccessibleSelection.AddSelection) != 0) {
                chartControl.Legends[childID].Selected = true;                        
            }

            // AccessibleSelection.AddSelection means that the CurveLegend will be unselected.
            if ((selection & AccessibleSelection.RemoveSelection) != 0) {
                chartControl.Legends[childID].Selected = false;                        
            }
        }            
    }
}

' Inner Class ChartControlAccessibleObject represents accessible information 
' associated with the ChartControl.
' The ChartControlAccessibleObject is returned in the         ' ChartControl.CreateAccessibilityInstance override.
Public Class ChartControlAccessibleObject
    Inherits Control.ControlAccessibleObject

    Private chartControl As ChartControl
    
    Public Sub New(ctrl As ChartControl)
        MyBase.New(ctrl)
        chartControl = ctrl
    End Sub
    
    ' Get the role for the Chart. This is used by accessibility programs.            
    Public Overrides ReadOnly Property Role() As AccessibleRole
        Get
            Return System.Windows.Forms.AccessibleRole.Chart
        End Get
    End Property
    
    ' Get the state for the Chart. This is used by accessibility programs.            
    Public Overrides ReadOnly Property State() As AccessibleStates
        Get
            Return AccessibleStates.ReadOnly
        End Get
    End Property                        
    
    ' The CurveLegend objects are "child" controls in terms of accessibility so 
    ' return the number of ChartLengend objects.            
    Public Overrides Function GetChildCount() As Integer
        Return chartControl.Legends.Length
    End Function 
    
    ' Get the Accessibility object of the child CurveLegend idetified by index.
    Public Overrides Function GetChild(index As Integer) As AccessibleObject
        If index >= 0 And index < chartControl.Legends.Length Then
            Return chartControl.Legends(index).AccessibilityObject
        End If
        Return Nothing
    End Function 
    
    ' Helper function that is used by the CurveLegend's accessibility object
    ' to navigate between sibiling controls. Specifically, this function is used in
    ' the CurveLegend.CurveLegendAccessibleObject.Navigate function.
    Friend Function NavigateFromChild(child As CurveLegend.CurveLegendAccessibleObject, _
                                    navdir As AccessibleNavigation) As AccessibleObject
        Select Case navdir
            Case AccessibleNavigation.Down, AccessibleNavigation.Next
                    Return GetChild(child.ID + 1)
            
            Case AccessibleNavigation.Up, AccessibleNavigation.Previous
                    Return GetChild(child.ID - 1)
        End Select
        Return Nothing
    End Function            

    ' Helper function that is used by the CurveLegend's accessibility object
    ' to select a specific CurveLegend control. Specifically, this function is used 
    ' in the CurveLegend.CurveLegendAccessibleObject.Select function.            
    Friend Sub SelectChild(child As CurveLegend.CurveLegendAccessibleObject, selection As AccessibleSelection)
        Dim childID As Integer = child.ID
        
        ' Determine which selection action should occur, based on the
        ' AccessibleSelection value.
        If (selection And AccessibleSelection.TakeSelection) <> 0 Then
            Dim i As Integer
            For i = 0 To chartControl.Legends.Length - 1
                If i = childID Then
                    chartControl.Legends(i).Selected = True
                Else
                    chartControl.Legends(i).Selected = False
                End If
            Next i
            
            ' AccessibleSelection.AddSelection means that the CurveLegend will be selected.
            If (selection And AccessibleSelection.AddSelection) <> 0 Then
                chartControl.Legends(childID).Selected = True
            End If

            ' AccessibleSelection.AddSelection means that the CurveLegend will be unselected.                    
            If (selection And AccessibleSelection.RemoveSelection) <> 0 Then
                chartControl.Legends(childID).Selected = False
            End If
        End If
    End Sub
End Class

Keterangan

Peran objek menjelaskan fungsi objek dan digunakan oleh aplikasi aksesibilitas.

Enumerasi ini digunakan oleh AccessibleObject dan Control.AccessibleRole

Untuk informasi tambahan tentang aplikasi aksesibilitas, cari "Microsoft Active Accessibility" di pustaka Microsoft Developer Network (MSDN).

Berlaku untuk

Lihat juga

Saran dan Komentar

Apakah halaman ini membantu?