Aracılığıyla paylaş


Control.ControlAccessibleObject Sınıf

Tanım

Erişilebilirlik uygulaması tarafından kullanılabilecek bir denetim hakkında bilgi sağlar.

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
Devralma
Control.ControlAccessibleObject
Devralma
Türetilmiş
Öznitelikler

Örnekler

Aşağıdaki kod örneği, sınıfından CheckBox türetilen bir onay kutusu denetimi oluşturur ve türetilmiş sınıfın kullanması için özel Control.ControlAccessibleObject bir değer oluşturur. Türetilmiş sınıfı, MyCheckBoxvarsayılan olarak bir Appearance öğesine Button sahiptir, bu nedenle iki durumlu düğme olarak görünür. Türetilmiş Control.ControlAccessibleObject sınıfı, MyCheckBoxControlAccessibleObjectgörünümdeki farkı hesaba katmak için üç özelliği geçersiz kılar.

#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

Açıklamalar

Windows Forms yerleşik erişilebilirlik desteği vardır ve uygulamanız hakkında erişilebilirlik istemci uygulamalarıyla çalışmasını sağlayan bilgiler sağlar. Erişilebilirlik istemcisi uygulamalarına örnek olarak ekran büyüteci ve gözden geçiren yardımcı programları, ses giriş yardımcı programları, ekran klavyeleri, alternatif giriş cihazları ve klavye geliştirme yardımcı programları verilebilir. Bazen erişilebilirlik istemci uygulamalarına ek bilgi sağlamak istersiniz. Bu ek bilgileri sağlamanın iki yolu vardır. Mevcut denetimler için sınırlı erişilebilirlik bilgileri sağlamak için, denetimin AccessibleName, AccessibleDescription, AccessibleDefaultActionDescriptionve AccessibleRole özellik değerlerini ayarlayın. Bu değerler erişilebilirlik istemci uygulamalarına bildirilir. Alternatif olarak, denetiminize daha fazla erişilebilirlik bilgisi eklenmesi gerekiyorsa, veya Control.ControlAccessibleObject sınıflarından AccessibleObject türetilen kendi sınıfınızı yazabilirsiniz. Örneğin, ortak denetimlerden türetilmemiş kendi denetiminizi yazıyorsanız veya denetiminizde isabet testi gibi işlemlere ihtiyacınız varsa, yöntemini çağırarak CreateAccessibilityInstance denetiminiz için bir Control.ControlAccessibleObject oluşturmanız gerekir.

Not

Yöntemini geçersiz kılarsanız AccessibleObject.GetChild , yöntemini de geçersiz kılmanız AccessibleObject.GetChildCount gerekir. Özelliğini almak veya ayarlamak AccessibilityObject için, .NET Framework yüklü derlemeye Accessibility bir başvuru eklemeniz gerekir.

Erişilebilir nesneler hakkında daha fazla bilgi için bkz. Microsoft Etkin Erişilebilirlik.

Oluşturucular

Control.ControlAccessibleObject(Control)

Control.ControlAccessibleObject sınıfının yeni bir örneğini başlatır.

Özellikler

Bounds

Erişilebilir nesnenin konumunu ve boyutunu alır.

(Devralındığı yer: AccessibleObject)
DefaultAction

Nesnenin varsayılan eylemini açıklayan bir dize alır. Tüm nesnelerin varsayılan eylemi yoktur.

Description

açıklamasını Control.ControlAccessibleObjectalır.

Handle

Erişilebilir nesnenin tutamacını alır veya ayarlar.

Help

Nesnenin ne yaptığının veya nesnenin nasıl kullanıldığının açıklamasını alır.

KeyboardShortcut

Erişilebilir bir nesne için nesne kısayol tuşunu veya erişim tuşunu alır.

Name

Erişilebilir nesne adını alır veya ayarlar.

Owner

Erişilebilir nesnenin sahibini alır.

Parent

Erişilebilir bir nesnenin üst öğesini alır.

Role

Bu erişilebilir nesnenin rolünü alır.

State

Bu erişilebilir nesnenin durumunu alır.

(Devralındığı yer: AccessibleObject)
Value

Erişilebilir bir nesnenin değerini alır veya ayarlar.

(Devralındığı yer: AccessibleObject)

Yöntemler

CreateObjRef(Type)

Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur.

(Devralındığı yer: MarshalByRefObject)
DoDefaultAction()

Bu erişilebilir nesneyle ilişkili varsayılan eylemi gerçekleştirir.

(Devralındığı yer: AccessibleObject)
Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetChild(Int32)

Belirtilen dizine karşılık gelen erişilebilir alt öğeyi alır.

(Devralındığı yer: AccessibleObject)
GetChildCount()

Erişilebilir bir nesneye ait alt öğe sayısını alır.

(Devralındığı yer: AccessibleObject)
GetFocused()

Klavye odağı olan nesneyi alır.

(Devralındığı yer: AccessibleObject)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetHelpTopic(String)

Bir Yardım konusunun tanımlayıcısını ve bu erişilebilir nesneyle ilişkili Yardım dosyasının yolunu alır.

GetLifetimeService()
Geçersiz.

Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır.

(Devralındığı yer: MarshalByRefObject)
GetSelected()

Seçili durumdaki alt öğeyi alır.

(Devralındığı yer: AccessibleObject)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
HitTest(Int32, Int32)

Belirtilen ekran koordinatlarında alt nesneyi alır.

(Devralındığı yer: AccessibleObject)
InitializeLifetimeService()
Geçersiz.

Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır.

(Devralındığı yer: MarshalByRefObject)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
MemberwiseClone(Boolean)

Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur.

(Devralındığı yer: MarshalByRefObject)
Navigate(AccessibleNavigation)

Başka bir erişilebilir nesneye gider.

(Devralındığı yer: AccessibleObject)
NotifyClients(AccessibleEvents)

Erişilebilirlik istemci uygulamalarını belirtilen AccessibleEventsöğesine bildirir.

NotifyClients(AccessibleEvents, Int32)

Belirtilen alt denetim için belirtilen AccessibleEvents erişilebilirlik istemci uygulamalarına bildirir.

NotifyClients(AccessibleEvents, Int32, Int32)

Belirtilen alt denetim için belirtilen AccessibleEvents erişilebilirlik istemci uygulamalarına bildirimde bulunur ve kimliğini verir AccessibleObject.

RaiseAutomationNotification(AutomationNotificationKind, AutomationNotificationProcessing, String)

UI otomasyonu bildirim olayını tetikler.

(Devralındığı yer: AccessibleObject)
RaiseLiveRegionChanged()

LiveRegionChanged UI otomasyon olayını tetikler.

RaiseLiveRegionChanged()

LiveRegionChanged UI otomasyon olayını tetikler.

(Devralındığı yer: AccessibleObject)
Select(AccessibleSelection)

Seçimi değiştirir veya erişilebilir nesnenin klavye odağını taşır.

(Devralındığı yer: AccessibleObject)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

UseStdAccessibleObjects(IntPtr)

Bir nesneyi, nesnesinin tutamacını temel alan bir AccessibleObject örneğiyle ilişkilendirir.

(Devralındığı yer: AccessibleObject)
UseStdAccessibleObjects(IntPtr, Int32)

Bir nesneyi, tanıtıcıyı ve nesne kimliğini temel alan bir AccessibleObject örneğiyle ilişkilendirir.

(Devralındığı yer: AccessibleObject)

Belirtik Arabirim Kullanımları

IAccessible.accChildCount

Bu nesneye ait alt arabirimlerin sayısını alır. Bu üyenin açıklaması için bkz accChildCount. .

(Devralındığı yer: AccessibleObject)
IAccessible.accDoDefaultAction(Object)

Belirtilen nesnenin varsayılan eylemini gerçekleştirir. Tüm nesnelerin varsayılan eylemi yoktur. Bu üyenin açıklaması için bkz accDoDefaultAction(Object). .

(Devralındığı yer: AccessibleObject)
IAccessible.accFocus

Klavye odağı olan nesneyi alır. Bu üyenin açıklaması için bkz accFocus. .

(Devralındığı yer: AccessibleObject)
IAccessible.accHitTest(Int32, Int32)

Belirtilen ekran koordinatlarında alt nesneyi alır. Bu üyenin açıklaması için bkz accHitTest(Int32, Int32). .

(Devralındığı yer: AccessibleObject)
IAccessible.accLocation(Int32, Int32, Int32, Int32, Object)

Nesnenin geçerli ekran konumunu alır. Bu üyenin açıklaması için bkz accLocation(Int32, Int32, Int32, Int32, Object). .

(Devralındığı yer: AccessibleObject)
IAccessible.accNavigate(Int32, Object)

Geçerli nesneye göre erişilebilir bir nesneye gider. Bu üyenin açıklaması için bkz accNavigate(Int32, Object). .

(Devralındığı yer: AccessibleObject)
IAccessible.accParent

Bu nesnenin üst erişilebilir nesnesini alır. Bu üyenin açıklaması için bkz accParent. .

(Devralındığı yer: AccessibleObject)
IAccessible.accSelect(Int32, Object)

Seçimi değiştirir veya erişilebilir nesnenin klavye odağını taşır. Bu üyenin açıklaması için bkz accSelect(Int32, Object). .

(Devralındığı yer: AccessibleObject)
IAccessible.accSelection

Erişilebilir bir nesnenin seçili alt nesnelerini alır. Bu üyenin açıklaması için bkz accSelection. .

(Devralındığı yer: AccessibleObject)
IReflect.GetField(String, BindingFlags)

FieldInfo Belirtilen alana ve bağlama bayrağına karşılık gelen nesneyi alır. Bu üyenin açıklaması için bkz GetField(String, BindingFlags). .

(Devralındığı yer: AccessibleObject)
IReflect.GetFields(BindingFlags)

Geçerli sınıfın FieldInfo tüm alanlarına karşılık gelen bir nesne dizisi alır. Bu üyenin açıklaması için bkz GetFields(BindingFlags). .

(Devralındığı yer: AccessibleObject)
IReflect.GetMember(String, BindingFlags)

Tüm ortak üyelere veya belirtilen adla eşleşen tüm üyelere karşılık gelen bir nesne dizisi MemberInfo alır. Bu üyenin açıklaması için bkz GetMember(String, BindingFlags). .

(Devralındığı yer: AccessibleObject)
IReflect.GetMembers(BindingFlags)

Tüm ortak üyelere veya geçerli sınıfın MemberInfo tüm üyelerine karşılık gelen bir nesne dizisi alır. Bu üyenin açıklaması için bkz GetMembers(BindingFlags). .

(Devralındığı yer: AccessibleObject)
IReflect.GetMethod(String, BindingFlags)

MethodInfo Belirtilen arama kısıtlamaları altında belirtilen yönteme karşılık gelen bir nesne alır. Bu üyenin açıklaması için bkz GetMethod(String, BindingFlags). .

(Devralındığı yer: AccessibleObject)
IReflect.GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[])

MethodInfo Aşırı yüklenmiş yöntemler arasından seçim yapmak için tür dizisini kullanarak belirtilen yönteme karşılık gelen bir nesne alır. Bu üyenin açıklaması için bkz GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[]). .

(Devralındığı yer: AccessibleObject)
IReflect.GetMethods(BindingFlags)

Tüm genel yöntemler veya geçerli sınıfın MethodInfo tüm yöntemleriyle bir nesne dizisi alır. Bu üyenin açıklaması için bkz GetMethods(BindingFlags). .

(Devralındığı yer: AccessibleObject)
IReflect.GetProperties(BindingFlags)

Tüm ortak özelliklere veya geçerli sınıfın PropertyInfo tüm özelliklerine karşılık gelen bir nesne dizisi alır. Bu üyenin açıklaması için bkz GetProperties(BindingFlags). .

(Devralındığı yer: AccessibleObject)
IReflect.GetProperty(String, BindingFlags)

PropertyInfo Belirtilen arama kısıtlamaları altında belirtilen özelliğe karşılık gelen bir nesne alır. Bu üyenin açıklaması için bkz GetProperty(String, BindingFlags). .

(Devralındığı yer: AccessibleObject)
IReflect.GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])

PropertyInfo Belirtilen arama kısıtlamalarına sahip belirtilen özelliğe karşılık gelen bir nesne alır. Bu üyenin açıklaması için bkz GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[]). .

(Devralındığı yer: AccessibleObject)
IReflect.InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[])

Belirtilen üyeyi çağırır. Bu üyenin açıklaması için bkz InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]). .

(Devralındığı yer: AccessibleObject)
IReflect.UnderlyingSystemType

Nesneyi temsil IReflect eden temel alınan türü alır. Bu üyenin açıklaması için bkz UnderlyingSystemType. .

(Devralındığı yer: AccessibleObject)

Şunlara uygulanır

Ayrıca bkz.