Control.ControlAccessibleObject Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zawiera informacje o kontrolce, która może być używana przez aplikację ułatwień dostępu.

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

Dziedziczenie: Object

MarshalByRefObject

AccessibleObject
Control.ControlAccessibleObject

Dziedziczenie: Object

MarshalByRefObject

StandardOleMarshalObject

AccessibleObject
Control.ControlAccessibleObject

Pochodne: 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

Więcej…

Atrybuty: ComVisibleAttribute

Przykłady

Poniższy przykład kodu tworzy kontrolkę pola wyboru, która pochodzi z CheckBox klasy i tworzy niestandardowe Control.ControlAccessibleObject dla klasy pochodnej do użycia. Klasa pochodna , MyCheckBoxdomyślnie ma wartość , Button Appearance więc jest wyświetlana jako przycisk przełącznika. Klasa pochodna Control.ControlAccessibleObject , MyCheckBoxControlAccessibleObjectzastępuje trzy właściwości, aby uwzględnić różnicę w wyglądzie.

#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

Uwagi

Windows Forms ma wbudowaną obsługę ułatwień dostępu i udostępnia informacje o aplikacji, które umożliwiają pracę z aplikacjami klienckimi ułatwień dostępu. Przykłady aplikacji klienckich ułatwień dostępu to: narzędzia powiększania ekranu i recenzenta, narzędzia wprowadzania głosu, klawiatury na ekranie, alternatywne urządzenia wejściowe i narzędzia do ulepszania klawiatury. Czasami należy podać dodatkowe informacje dla aplikacji klienckich ułatwień dostępu. Istnieją dwa sposoby dostarczania tych dodatkowych informacji. Aby zapewnić ograniczone informacje o ułatwieniach dostępu dla istniejących kontrolek, ustaw wartości właściwości , AccessibleDescription AccessibleDefaultActionDescriptioni AccessibleRole , AccessibleNamektóre będą zgłaszane do aplikacji klienckich ułatwień dostępu. Alternatywnie, jeśli potrzebujesz dodatkowych informacji o ułatwieniach dostępu do kontrolki, możesz napisać własną klasę pochodną klasy AccessibleObject lub Control.ControlAccessibleObject . Jeśli na przykład piszesz własną kontrolkę, która nie pochodzi z typowych kontrolek lub potrzebujesz takich operacji, jak testowanie trafień w kontrolce, należy utworzyć Control.ControlAccessibleObject element dla kontrolki, wywołując metodę CreateAccessibilityInstance .

Uwaga

W przypadku zastąpienia AccessibleObject.GetChild metody należy również zastąpić metodę AccessibleObject.GetChildCount . Aby pobrać lub ustawić AccessibilityObject właściwość, należy dodać odwołanie do zestawu zainstalowanego Accessibility z .NET Framework.

Aby uzyskać więcej informacji na temat obiektów z ułatwieniami dostępu, zobacz Microsoft Active Accessibility (Ułatwienia dostępu w usłudze Microsoft Active).

Konstruktory

Control.ControlAccessibleObject(Control)

Inicjuje nowe wystąpienie klasy Control.ControlAccessibleObject.

Właściwości

Bounds	Pobiera lokalizację i rozmiar dostępnego obiektu. (Odziedziczone po AccessibleObject)
DefaultAction	Pobiera ciąg opisujący domyślną akcję obiektu. Nie wszystkie obiekty mają akcję domyślną.
Description	Pobiera opis obiektu Control.ControlAccessibleObject.
Handle	Pobiera lub ustawia uchwyt dostępnego obiektu.
Help	Pobiera opis działania obiektu lub sposobu użycia obiektu.
KeyboardShortcut	Pobiera klucz skrótu obiektu lub klucz dostępu dla dostępnego obiektu.
Name	Pobiera lub ustawia dostępną nazwę obiektu.
Owner	Pobiera właściciela dostępnego obiektu.
Parent	Pobiera element nadrzędny dostępnego obiektu.
Role	Pobiera rolę tego dostępnego obiektu.
State	Pobiera stan tego dostępnego obiektu. (Odziedziczone po AccessibleObject)
Value	Pobiera lub ustawia wartość dostępnego obiektu. (Odziedziczone po AccessibleObject)

Metody

CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
DoDefaultAction()	Wykonuje akcję domyślną skojarzona z tym dostępnym obiektem. (Odziedziczone po AccessibleObject)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetChild(Int32)	Pobiera dostępne dziecko odpowiadające określonemu indeksowi. (Odziedziczone po AccessibleObject)
GetChildCount()	Pobiera liczbę elementów podrzędnych należących do dostępnego obiektu. (Odziedziczone po AccessibleObject)
GetFocused()	Pobiera obiekt, który ma fokus klawiatury. (Odziedziczone po AccessibleObject)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetHelpTopic(String)	Pobiera identyfikator tematu Pomocy i ścieżkę do pliku Pomocy skojarzonego z tym dostępnym obiektem.
GetLifetimeService()	Nieaktualne. Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetSelected()	Pobiera aktualnie wybranego elementu podrzędnego. (Odziedziczone po AccessibleObject)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
HitTest(Int32, Int32)	Pobiera obiekt podrzędny na określonych współrzędnych ekranu. (Odziedziczone po AccessibleObject)
InitializeLifetimeService()	Nieaktualne. Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
Navigate(AccessibleNavigation)	Przechodzi do innego dostępnego obiektu. (Odziedziczone po AccessibleObject)
NotifyClients(AccessibleEvents)	Powiadamia aplikacje klienckie ułatwień dostępu określonego AccessibleEventselementu .
NotifyClients(AccessibleEvents, Int32)	Powiadamia aplikacje klienckie ułatwień dostępu określone AccessibleEvents dla określonej kontrolki podrzędnej.
NotifyClients(AccessibleEvents, Int32, Int32)	Powiadamia aplikacje klienckie ułatwień dostępu określone AccessibleEvents dla określonej kontrolki podrzędnej, podając identyfikację elementu AccessibleObject.
RaiseAutomationNotification(AutomationNotificationKind, AutomationNotificationProcessing, String)	Zgłasza zdarzenie powiadomienia automatyzacji interfejsu użytkownika. (Odziedziczone po AccessibleObject)
RaiseLiveRegionChanged()	Zgłasza zdarzenie automatyzacji interfejsu użytkownika LiveRegionChanged.
RaiseLiveRegionChanged()	Zgłasza zdarzenie automatyzacji interfejsu użytkownika LiveRegionChanged. (Odziedziczone po AccessibleObject)
Select(AccessibleSelection)	Modyfikuje zaznaczenie lub przenosi fokus klawiatury dostępnego obiektu. (Odziedziczone po AccessibleObject)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt.
UseStdAccessibleObjects(IntPtr)	Kojarzy obiekt z wystąpieniem AccessibleObject obiektu na podstawie uchwytu obiektu. (Odziedziczone po AccessibleObject)
UseStdAccessibleObjects(IntPtr, Int32)	Kojarzy obiekt z wystąpieniem AccessibleObject obiektu na podstawie uchwytu i identyfikatora obiektu. (Odziedziczone po AccessibleObject)

Jawne implementacje interfejsu

IAccessible.accChildCount	Pobiera liczbę interfejsów podrzędnych należących do tego obiektu. Aby uzyskać opis tego członka, zobacz accChildCount. (Odziedziczone po AccessibleObject)
IAccessible.accDoDefaultAction(Object)	Wykonuje domyślną akcję określonego obiektu. Nie wszystkie obiekty mają akcję domyślną. Aby uzyskać opis tego członka, zobacz accDoDefaultAction(Object). (Odziedziczone po AccessibleObject)
IAccessible.accFocus	Pobiera obiekt, który ma fokus klawiatury. Aby uzyskać opis tego członka, zobacz accFocus. (Odziedziczone po AccessibleObject)
IAccessible.accHitTest(Int32, Int32)	Pobiera obiekt podrzędny na określonych współrzędnych ekranu. Aby uzyskać opis tego członka, zobacz accHitTest(Int32, Int32). (Odziedziczone po AccessibleObject)
IAccessible.accLocation(Int32, Int32, Int32, Int32, Object)	Pobiera bieżącą lokalizację ekranu obiektu. Aby uzyskać opis tego członka, zobacz accLocation(Int32, Int32, Int32, Int32, Object). (Odziedziczone po AccessibleObject)
IAccessible.accNavigate(Int32, Object)	Przechodzi do dostępnego obiektu względem bieżącego obiektu. Aby uzyskać opis tego członka, zobacz accNavigate(Int32, Object). (Odziedziczone po AccessibleObject)
IAccessible.accParent	Pobiera obiekt nadrzędny dostępny dla tego obiektu. Aby uzyskać opis tego członka, zobacz accParent. (Odziedziczone po AccessibleObject)
IAccessible.accSelect(Int32, Object)	Modyfikuje zaznaczenie lub przenosi fokus klawiatury dostępnego obiektu. Aby uzyskać opis tego elementu członkowskiego, zobacz accSelect(Int32, Object). (Odziedziczone po AccessibleObject)
IAccessible.accSelection	Pobiera wybrane obiekty podrzędne dostępnego obiektu. Aby uzyskać opis tego elementu członkowskiego, zobacz accSelection. (Odziedziczone po AccessibleObject)
IReflect.GetField(String, BindingFlags)	FieldInfo Pobiera obiekt odpowiadający określonemu polu i flagi powiązania. Aby uzyskać opis tego elementu członkowskiego, zobacz GetField(String, BindingFlags). (Odziedziczone po AccessibleObject)
IReflect.GetFields(BindingFlags)	Pobiera tablicę FieldInfo obiektów odpowiadających wszystkim polem bieżącej klasy. Aby uzyskać opis tego elementu członkowskiego, zobacz GetFields(BindingFlags). (Odziedziczone po AccessibleObject)
IReflect.GetMember(String, BindingFlags)	Pobiera tablicę MemberInfo obiektów odpowiadających wszystkim członkom publicznym lub wszystkim członkom, które pasują do określonej nazwy. Aby uzyskać opis tego elementu członkowskiego, zobacz GetMember(String, BindingFlags). (Odziedziczone po AccessibleObject)
IReflect.GetMembers(BindingFlags)	Pobiera tablicę MemberInfo obiektów odpowiadających wszystkim członkom publicznym lub wszystkim członkom bieżącej klasy. Aby uzyskać opis tego elementu członkowskiego, zobacz GetMembers(BindingFlags). (Odziedziczone po AccessibleObject)
IReflect.GetMethod(String, BindingFlags)	MethodInfo Pobiera obiekt odpowiadający określonej metodzie w określonych ograniczeniach wyszukiwania. Aby uzyskać opis tego elementu członkowskiego, zobacz GetMethod(String, BindingFlags). (Odziedziczone po AccessibleObject)
IReflect.GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[])	MethodInfo Pobiera obiekt odpowiadający określonej metodzie, używając tablicy Type do wyboru spośród przeciążonych metod. Aby uzyskać opis tego elementu członkowskiego, zobacz GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[]). (Odziedziczone po AccessibleObject)
IReflect.GetMethods(BindingFlags)	Pobiera tablicę MethodInfo obiektów ze wszystkimi metodami publicznymi lub wszystkimi metodami bieżącej klasy. Aby uzyskać opis tego elementu członkowskiego, zobacz GetMethods(BindingFlags). (Odziedziczone po AccessibleObject)
IReflect.GetProperties(BindingFlags)	Pobiera tablicę PropertyInfo obiektów odpowiadających wszystkim właściwościom publicznym lub wszystkim właściwościom bieżącej klasy. Aby uzyskać opis tego elementu członkowskiego, zobacz GetProperties(BindingFlags). (Odziedziczone po AccessibleObject)
IReflect.GetProperty(String, BindingFlags)	PropertyInfo Pobiera obiekt odpowiadający określonej właściwości w określonych ograniczeniach wyszukiwania. Aby uzyskać opis tego elementu członkowskiego, zobacz GetProperty(String, BindingFlags). (Odziedziczone po AccessibleObject)
IReflect.GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])	PropertyInfo Pobiera obiekt odpowiadający określonej właściwości z określonymi ograniczeniami wyszukiwania. Aby uzyskać opis tego elementu członkowskiego, zobacz GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[]). (Odziedziczone po AccessibleObject)
IReflect.InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[])	Wywołuje określony element członkowski. Aby uzyskać opis tego elementu członkowskiego, zobacz InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]). (Odziedziczone po AccessibleObject)
IReflect.UnderlyingSystemType	Pobiera typ bazowy reprezentujący IReflect obiekt. Aby uzyskać opis tego członka, zobacz UnderlyingSystemType. (Odziedziczone po AccessibleObject)

Dotyczy