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

Udostępnij za pośrednictwem