Control.ControlAccessibleObject Klasa

Definicja

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
Control.ControlAccessibleObject
Dziedziczenie
Pochodne
Atrybuty

Przykłady

Poniższy przykład kodu tworzy kontrolkę pola wyboru, która pochodzi z CheckBox klasy i tworzy niestandardową Control.ControlAccessibleObject dla klasy pochodnej do użycia. Klasa pochodna , ma Appearance Button domyślnie wartość , MyCheckBoxwię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ą jej 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 wejściowe 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 dotyczące ułatwień dostępu dla istniejących kontrolek, ustaw wartości właściwości , AccessibleDescriptioni AccessibleRole AccessibleDefaultActionDescription, AccessibleNamektóre będą zgłaszane do aplikacji klienckich ułatwień dostępu. Alternatywnie, jeśli potrzebujesz dodatkowych informacji o ułatwieniu dostępu do kontrolki, możesz napisać własną klasę pochodzącą z AccessibleObject klas 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 trafienia w kontrolce, należy utworzyć Control.ControlAccessibleObject element dla kontrolki, wywołując metodę CreateAccessibilityInstance .

Uwaga

Jeśli zastąpisz metodę AccessibleObject.GetChild , 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 przy użyciu .NET Framework.

Aby uzyskać więcej informacji na temat obiektów dostępnych, 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 elementu Control.ControlAccessibleObject.

Handle

Pobiera lub ustawia uchwyt dostępnego obiektu.

Help

Pobiera opis tego, co robi obiekt lub jak jest używany obiekt.

KeyboardShortcut

Pobiera klucz skrótu obiektu lub klucz dostępu dla dostępnego obiektu.

Name

Pobiera lub ustawia nazwę dostępnego obiektu.

Owner

Pobiera właściciela obiektu dostępnego.

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 domyślną akcję 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ępny element podrzędny odpowiadający określonemu indeksowi.

(Odziedziczone po AccessibleObject)
GetChildCount()

Pobiera liczbę elementów podrzędnych należących do obiektu dostępnego.

(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 wybrane dziecko.

(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ę AccessibleObjectelementu .

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 elementu członkowskiego, 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 elementu członkowskiego, zobacz accDoDefaultAction(Object).

(Odziedziczone po AccessibleObject)
IAccessible.accFocus

Pobiera obiekt, który ma fokus klawiatury. Aby uzyskać opis tego elementu członkowskiego, zobacz accFocus.

(Odziedziczone po AccessibleObject)
IAccessible.accHitTest(Int32, Int32)

Pobiera obiekt podrzędny na określonych współrzędnych ekranu. Aby uzyskać opis tego elementu członkowskiego, zobacz accHitTest(Int32, Int32).

(Odziedziczone po AccessibleObject)
IAccessible.accLocation(Int32, Int32, Int32, Int32, Object)

Pobiera bieżącą lokalizację ekranu obiektu. Aby uzyskać opis tego elementu członkowskiego, 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 elementu członkowskiego, zobacz accNavigate(Int32, Object).

(Odziedziczone po AccessibleObject)
IAccessible.accParent

Pobiera nadrzędny obiekt dostępny dla tego obiektu. Aby uzyskać opis tego elementu członkowskiego, zobacz accParent.

(Odziedziczone po AccessibleObject)
IAccessible.accSelect(Int32, Object)

Modyfikuje zaznaczenie lub przenosi fokus klawiatury dostępnego obiektu. Aby uzyskać opis tego członka, zobacz accSelect(Int32, Object).

(Odziedziczone po AccessibleObject)
IAccessible.accSelection

Pobiera zaznaczone obiekty podrzędne dostępnego obiektu. Aby uzyskać opis tego członka, 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 polam bieżącej klasy. Aby uzyskać opis tego członka, 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 są zgodne z określoną nazwą. Aby uzyskać opis tego członka, 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 członka, zobacz GetMembers(BindingFlags).

(Odziedziczone po AccessibleObject)
IReflect.GetMethod(String, BindingFlags)

MethodInfo Pobiera obiekt odpowiadający określonej metodzie w ramach określonych ograniczeń wyszukiwania. Aby uzyskać opis tego członka, zobacz GetMethod(String, BindingFlags).

(Odziedziczone po AccessibleObject)
IReflect.GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[])

MethodInfo Pobiera obiekt odpowiadający określonej metodzie przy użyciu tablicy Type do wyboru spośród metod przeciążonych. Aby uzyskać opis tego członka, 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 członka, 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 członka, zobacz GetProperties(BindingFlags).

(Odziedziczone po AccessibleObject)
IReflect.GetProperty(String, BindingFlags)

PropertyInfo Pobiera obiekt odpowiadający określonej właściwości w ramach określonych ograniczeń wyszukiwania. Aby uzyskać opis tego członka, 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 członka, 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 członka, 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

Zobacz też