Control.ControlAccessibleObject Kelas

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

Sumber:: Control.ControlAccessibleObject.cs

Sumber:: Control.ControlAccessibleObject.cs

Sumber:: Control.ControlAccessibleObject.cs

Sumber:: Control.ControlAccessibleObject.cs

Sumber:: Control.ControlAccessibleObject.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.

Menyediakan informasi tentang kontrol yang dapat digunakan oleh aplikasi aksesibilitas.

public: ref class Control::ControlAccessibleObject : System::Windows::Forms::AccessibleObject

[System.Runtime.InteropServices.ComVisible(true)]
public class Control.ControlAccessibleObject : System.Windows.Forms.AccessibleObject

public class Control.ControlAccessibleObject : System.Windows.Forms.AccessibleObject

[<System.Runtime.InteropServices.ComVisible(true)>]
type Control.ControlAccessibleObject = class
    inherit AccessibleObject

type Control.ControlAccessibleObject = class
    inherit AccessibleObject

Public Class Control.ControlAccessibleObject
Inherits AccessibleObject

Warisan: Object

MarshalByRefObject

AccessibleObject
Control.ControlAccessibleObject

Warisan: Object

MarshalByRefObject

StandardOleMarshalObject

AccessibleObject
Control.ControlAccessibleObject

Turunan: System.Windows.Forms.ButtonBase.ButtonBaseAccessibleObject

System.Windows.Forms.DataGridView.DataGridViewAccessibleObject

System.Windows.Forms.DateTimePicker.DateTimePickerAccessibleObject

System.Windows.Forms.DomainUpDown.DomainUpDownAccessibleObject

System.Windows.Forms.RadioButton.RadioButtonAccessibleObject

Lainnya…

Atribut: ComVisibleAttribute

Contoh

Contoh kode berikut membuat kontrol kotak centang yang berasal dari CheckBox kelas dan membuat kustom Control.ControlAccessibleObject untuk kelas turunan yang akan digunakan. Kelas turunan, MyCheckBox, memiliki Appearance dari Button secara default sehingga muncul sebagai tombol alih. Kelas turunan Control.ControlAccessibleObject , MyCheckBoxControlAccessibleObject, mengambil alih tiga properti untuk memperhitungkan perbedaan penampilan.

#using <Accessibility.dll>
#using <System.Drawing.dll>
#using <System.dll>
#using <System.Windows.Forms.dll>

using namespace System;
using namespace System::Windows::Forms;
using namespace System::Drawing;

namespace MyCustomControls
{
   public ref class MyCheckBox: public CheckBox
   {
   public:
      MyCheckBox()
      {
         // Make the check box appear like a toggle button.
         this->Appearance = ::Appearance::Button;

         // Center the text on the button.
         this->TextAlign = ContentAlignment::MiddleCenter;

         // Set the AccessibleDescription text.
         this->AccessibleDescription = "A toggle style button.";
      }

   protected:

      // Create an instance of the AccessibleObject
      // defined for the 'MyCheckBox' control
      virtual AccessibleObject^ CreateAccessibilityInstance() override;
   };

   // Accessible Object* for use with the 'MyCheckBox' control.
   private ref class MyCheckBoxAccessibleObject: public Control::ControlAccessibleObject
   {
   public:
      MyCheckBoxAccessibleObject( MyCheckBox^ owner )
         : ControlAccessibleObject( owner )
      {}

      property String^ DefaultAction 
      {
         virtual String^ get() override
         {
            // Return the DefaultAction based upon
            // the state of the control.
            if ( (dynamic_cast<MyCheckBox^>(Owner))->Checked )
            {
               return "Toggle button up";
            }
            else
            {
               return "Toggle button down";
            }
         }
      }

      property String^ Name 
      {
         virtual String^ get() override
         {
            // Return the Text property of the control
            // if the AccessibleName is 0.
            String^ name = Owner->AccessibleName;
            if ( name != nullptr )
            {
               return name;
            }

            return (dynamic_cast<MyCheckBox^>(Owner))->Text;
         }

         virtual void set( String^ value ) override
         {
            ControlAccessibleObject::Name = value;
         }
      }

      property AccessibleRole Role 
      {
         virtual AccessibleRole get() override
         {
            // Since the check box appears like a button,
            // make the Role the same as a button.
            return AccessibleRole::PushButton;
         }
      }
   };

   AccessibleObject^ MyCheckBox::CreateAccessibilityInstance()
   {
      return gcnew MyCheckBoxAccessibleObject( this );
   }
}

using System;
using System.Windows.Forms;
using Accessibility;
using System.Drawing;

namespace MyCustomControls
{
   public class MyCheckBox : CheckBox
   {
      public MyCheckBox()
      {
         // Make the check box appear like a toggle button.
         this.Appearance = Appearance.Button;
         // Center the text on the button.
         this.TextAlign = ContentAlignment.MiddleCenter;
         // Set the AccessibleDescription text.
         this.AccessibleDescription = "A toggle style button.";
      }
      
      // Create an instance of the AccessibleObject 
      // defined for the 'MyCheckBox' control
      protected override AccessibleObject CreateAccessibilityInstance() 
      {
         return new MyCheckBoxAccessibleObject(this);
      }
   }

   // Accessible object for use with the 'MyCheckBox' control.
   internal class MyCheckBoxAccessibleObject : Control.ControlAccessibleObject 
   {
      public MyCheckBoxAccessibleObject(MyCheckBox owner) : base(owner) 
      {
      }
               
      public override string DefaultAction 
      {
         get
         {
            // Return the DefaultAction based upon 
            // the state of the control.
            if( ((MyCheckBox)Owner).Checked )
            {
               return "Toggle button up";
            }
            else
            {
               return "Toggle button down";
            }
         }
      }

      public override string Name 
      {
         get 
         {
            // Return the Text property of the control 
            // if the AccessibleName is null.
            string name = Owner.AccessibleName;
            if (name != null) 
            {
               return name;
            }
            return ((MyCheckBox)Owner).Text;
         }
         
         set
         {
            base.Name = value;
         }
      }            
               
      public override AccessibleRole Role 
      {
         get 
         {
            // Since the check box appears like a button,
            // make the Role the same as a button.
            return AccessibleRole.PushButton;
         }
      }
   }
}

Imports System.Windows.Forms
Imports Accessibility
Imports System.Drawing

Namespace MyCustomControls
   Public Class MyCheckBox
      Inherits CheckBox
      
      Public Sub New()
         ' Make the check box appear like a toggle button.
         Me.Appearance = Appearance.Button
         ' Center the text on the button.
         Me.TextAlign = ContentAlignment.MiddleCenter
      End Sub
      
      ' Create an instance of the AccessibleObject 
      ' defined for the 'MyCheckBox' control 
      Protected Overrides Function CreateAccessibilityInstance() _
        As AccessibleObject
         Return New MyCheckBoxAccessibleObject(Me)
      End Function
   End Class
    
   ' Accessible object for use with the 'MyCheckBox' control.
   Friend Class MyCheckBoxAccessibleObject
      Inherits Control.ControlAccessibleObject
      
      Public Sub New(owner As MyCheckBox)
         MyBase.New(owner)
      End Sub
      
      Public Overrides ReadOnly Property DefaultAction() As String
         Get
            ' Return the DefaultAction based upon 
            ' the state of the control. 
            If CType(Owner, MyCheckBox).Checked Then
               Return "Toggle button up"
            Else
               Return "Toggle button down"
            End If
         End Get
      End Property
      
      Public Overrides Property Name() As String
         Get
            ' Return the Text property of the control 
            ' if the AccessibleName is null. 
            Dim accessibleName As String = Owner.AccessibleName
            If (accessibleName IsNot Nothing) Then
               Return accessibleName
            End If
            Return CType(Owner, MyCheckBox).Text
         End Get

         Set
            MyBase.Name = value
         End Set
      End Property
      
      Public Overrides ReadOnly Property Role() As AccessibleRole
         Get
            ' Since the check box appears like a button,
            ' make the Role the same as a button. 
            Return AccessibleRole.PushButton
         End Get
      End Property
   End Class
End Namespace

Keterangan

Windows Forms memiliki dukungan aksesibilitas bawaan, dan menyediakan informasi tentang aplikasi Anda yang memungkinkannya bekerja dengan aplikasi klien aksesibilitas. Contoh aplikasi klien aksesibilitas adalah: utilitas pembesar layar dan peninjau, utilitas input suara, keyboard di layar, perangkat input alternatif, dan utilitas peningkatan keyboard. Terkadang Anda ingin memberikan informasi tambahan ke aplikasi klien aksesibilitas. Ada dua cara untuk memberikan informasi tambahan ini. Untuk memberikan informasi aksesibilitas terbatas untuk kontrol yang ada, atur nilai properti , , AccessibleDescription, AccessibleDefaultActionDescriptiondan AccessibleRole kontrolAccessibleName, yang akan dilaporkan ke aplikasi klien aksesibilitas. Atau, jika Anda memerlukan lebih banyak informasi aksesibilitas untuk disertakan dengan kontrol Anda, Anda dapat menulis kelas Anda sendiri yang berasal dari AccessibleObject kelas atau Control.ControlAccessibleObject . Misalnya, jika Anda menulis kontrol Anda sendiri yang tidak berasal dari kontrol umum atau Anda memerlukan operasi seperti pengujian hit dalam kontrol Anda, Anda harus membuat Control.ControlAccessibleObject untuk kontrol Anda dengan memanggil CreateAccessibilityInstance metode .

Nota

Jika Anda mengambil AccessibleObject.GetChild alih metode , Anda juga harus mengambil AccessibleObject.GetChildCount alih metode . Untuk mendapatkan atau mengatur AccessibilityObject properti, Anda harus menambahkan referensi ke Accessibility rakitan yang diinstal dengan .NET Framework.

Untuk informasi selengkapnya tentang objek yang dapat diakses, lihat Aksesibilitas Aktif Microsoft.

Konstruktor

Nama	Deskripsi
Control.ControlAccessibleObject(Control)	Menginisialisasi instans baru dari kelas Control.ControlAccessibleObject.

Properti

Nama	Deskripsi
Bounds	Mendapatkan lokasi dan ukuran objek yang dapat diakses. (Diperoleh dari AccessibleObject)
DefaultAction	Mendapatkan string yang menjelaskan tindakan default objek. Tidak semua objek memiliki tindakan default.
Description	Mendapatkan deskripsi .Control.ControlAccessibleObject
Handle	Mendapatkan atau mengatur handel objek yang dapat diakses.
Help	Mendapatkan deskripsi tentang apa yang dilakukan objek atau bagaimana objek digunakan.
KeyboardShortcut	Mendapatkan kunci pintasan objek atau kunci akses untuk objek yang dapat diakses.
Name	Mendapatkan atau mengatur nama objek yang dapat diakses.
Owner	Mendapatkan pemilik objek yang dapat diakses.
Parent	Mendapatkan induk objek yang dapat diakses.
Role	Mendapatkan peran objek yang dapat diakses ini.
State	Mendapatkan status objek yang dapat diakses ini. (Diperoleh dari AccessibleObject)
Value	Mendapatkan atau mengatur nilai objek yang dapat diakses. (Diperoleh dari AccessibleObject)

Metode

Nama	Deskripsi
CreateObjRef(Type)	Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
DoDefaultAction()	Melakukan tindakan default yang terkait dengan objek yang dapat diakses ini. (Diperoleh dari AccessibleObject)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetChild(Int32)	Mengambil anak yang dapat diakses yang sesuai dengan indeks yang ditentukan. (Diperoleh dari AccessibleObject)
GetChildCount()	Mengambil jumlah anak milik objek yang dapat diakses. (Diperoleh dari AccessibleObject)
GetFocused()	Mengambil objek yang memiliki fokus keyboard. (Diperoleh dari AccessibleObject)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetHelpTopic(String)	Mendapatkan pengidentifikasi untuk topik Bantuan dan jalur ke file Bantuan yang terkait dengan objek yang dapat diakses ini.
GetLifetimeService()	Kedaluwarsa. Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
GetSelected()	Mengambil anak yang saat ini dipilih. (Diperoleh dari AccessibleObject)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
HitTest(Int32, Int32)	Mengambil objek anak pada koordinat layar yang ditentukan. (Diperoleh dari AccessibleObject)
InitializeLifetimeService()	Kedaluwarsa. Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
Navigate(AccessibleNavigation)	Menavigasi ke objek lain yang dapat diakses. (Diperoleh dari AccessibleObject)
NotifyClients(AccessibleEvents, Int32, Int32)	Memberi tahu aplikasi klien aksesibilitas dari yang ditentukan AccessibleEvents untuk kontrol anak yang ditentukan, memberikan identifikasi AccessibleObject.
NotifyClients(AccessibleEvents, Int32)	Memberi tahu aplikasi klien aksesibilitas dari yang ditentukan AccessibleEvents untuk kontrol anak yang ditentukan.
NotifyClients(AccessibleEvents)	Memberi tahu aplikasi klien aksesibilitas dari aplikasi yang ditentukan AccessibleEvents.
RaiseAutomationNotification(AutomationNotificationKind, AutomationNotificationProcessing, String)	Menaikkan peristiwa pemberitahuan otomatisasi UI. (Diperoleh dari AccessibleObject)
RaiseLiveRegionChanged()	Menaikkan peristiwa otomatisasi UI LiveRegionChanged.
Select(AccessibleSelection)	Memodifikasi pilihan atau memindahkan fokus keyboard objek yang dapat diakses. (Diperoleh dari AccessibleObject)
ToString()	Mengembalikan string yang mewakili objek saat ini.
UseStdAccessibleObjects(IntPtr, Int32)	Mengaitkan objek dengan instans AccessibleObject berdasarkan handel dan id objek objek. (Diperoleh dari AccessibleObject)
UseStdAccessibleObjects(IntPtr)	Mengaitkan objek dengan instans AccessibleObject berdasarkan handel objek. (Diperoleh dari AccessibleObject)

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
IAccessible.accChildCount	Mendapatkan jumlah antarmuka anak yang termasuk dalam objek ini. Untuk deskripsi anggota ini, lihat accChildCount. (Diperoleh dari AccessibleObject)
IAccessible.accDoDefaultAction(Object)	Melakukan tindakan default objek yang ditentukan. Tidak semua objek memiliki tindakan default. Untuk deskripsi anggota ini, lihat accDoDefaultAction(Object). (Diperoleh dari AccessibleObject)
IAccessible.accFocus	Mendapatkan objek yang memiliki fokus keyboard. Untuk deskripsi anggota ini, lihat accFocus. (Diperoleh dari AccessibleObject)
IAccessible.accHitTest(Int32, Int32)	Mendapatkan objek anak pada koordinat layar yang ditentukan. Untuk deskripsi anggota ini, lihat accHitTest(Int32, Int32). (Diperoleh dari AccessibleObject)
IAccessible.accLocation(Int32, Int32, Int32, Int32, Object)	Mendapatkan lokasi layar objek saat ini. Untuk deskripsi anggota ini, lihat accLocation(Int32, Int32, Int32, Int32, Object). (Diperoleh dari AccessibleObject)
IAccessible.accNavigate(Int32, Object)	Menavigasi ke objek yang dapat diakses relatif terhadap objek saat ini. Untuk deskripsi anggota ini, lihat accNavigate(Int32, Object). (Diperoleh dari AccessibleObject)
IAccessible.accParent	Mendapatkan objek yang dapat diakses induk dari objek ini. Untuk deskripsi anggota ini, lihat accParent. (Diperoleh dari AccessibleObject)
IAccessible.accSelect(Int32, Object)	Memodifikasi pilihan atau memindahkan fokus keyboard objek yang dapat diakses. Untuk deskripsi anggota ini, lihat accSelect(Int32, Object). (Diperoleh dari AccessibleObject)
IAccessible.accSelection	Mendapatkan objek turunan terpilih dari objek yang dapat diakses. Untuk deskripsi anggota ini, lihat accSelection. (Diperoleh dari AccessibleObject)
IReflect.GetField(String, BindingFlags)	Mendapatkan objek yang FieldInfo sesuai dengan bidang dan bendera pengikatan yang ditentukan. Untuk deskripsi anggota ini, lihat GetField(String, BindingFlags). (Diperoleh dari AccessibleObject)
IReflect.GetFields(BindingFlags)	Mendapatkan array FieldInfo objek yang sesuai dengan semua bidang kelas saat ini. Untuk deskripsi anggota ini, lihat GetFields(BindingFlags). (Diperoleh dari AccessibleObject)
IReflect.GetMember(String, BindingFlags)	Mendapatkan array MemberInfo objek yang sesuai dengan semua anggota publik atau semua anggota yang cocok dengan nama tertentu. Untuk deskripsi anggota ini, lihat GetMember(String, BindingFlags). (Diperoleh dari AccessibleObject)
IReflect.GetMembers(BindingFlags)	Mendapatkan array MemberInfo objek yang sesuai dengan semua anggota publik atau ke semua anggota kelas saat ini. Untuk deskripsi anggota ini, lihat GetMembers(BindingFlags). (Diperoleh dari AccessibleObject)
IReflect.GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[])	Mendapatkan objek yang MethodInfo sesuai dengan metode tertentu, menggunakan array Jenis untuk dipilih di antara metode yang kelebihan beban. Untuk deskripsi anggota ini, lihat GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[]). (Diperoleh dari AccessibleObject)
IReflect.GetMethod(String, BindingFlags)	Mendapatkan objek yang MethodInfo sesuai dengan metode tertentu di bawah batasan pencarian tertentu. Untuk deskripsi anggota ini, lihat GetMethod(String, BindingFlags). (Diperoleh dari AccessibleObject)
IReflect.GetMethods(BindingFlags)	Mendapatkan array MethodInfo objek dengan semua metode publik atau semua metode kelas saat ini. Untuk deskripsi anggota ini, lihat GetMethods(BindingFlags). (Diperoleh dari AccessibleObject)
IReflect.GetProperties(BindingFlags)	Mendapatkan array PropertyInfo objek yang sesuai dengan semua properti publik atau ke semua properti kelas saat ini. Untuk deskripsi anggota ini, lihat GetProperties(BindingFlags). (Diperoleh dari AccessibleObject)
IReflect.GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])	Mendapatkan objek yang PropertyInfo sesuai dengan properti tertentu dengan batasan pencarian tertentu. Untuk deskripsi anggota ini, lihat GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[]). (Diperoleh dari AccessibleObject)
IReflect.GetProperty(String, BindingFlags)	Mendapatkan objek yang PropertyInfo sesuai dengan properti tertentu di bawah batasan pencarian tertentu. Untuk deskripsi anggota ini, lihat GetProperty(String, BindingFlags). (Diperoleh dari AccessibleObject)
IReflect.InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[])	Memanggil anggota tertentu. Untuk deskripsi anggota ini, lihat InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]). (Diperoleh dari AccessibleObject)
IReflect.UnderlyingSystemType	Mendapatkan jenis yang mendasar IReflect yang mewakili objek. Untuk deskripsi anggota ini, lihat UnderlyingSystemType. (Diperoleh dari AccessibleObject)

Berlaku untuk

Lihat juga

Saran dan Komentar

Apakah halaman ini membantu?