Control.ControlAccessibleObject Klasse

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt Informationen über ein Steuerelement bereit, das von einer barrierefreien Anwendung verwendet werden kann.

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

Vererbung: Object

MarshalByRefObject

AccessibleObject
Control.ControlAccessibleObject

Vererbung: Object

MarshalByRefObject

StandardOleMarshalObject

AccessibleObject
Control.ControlAccessibleObject

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

Mehr …

Attribute: ComVisibleAttribute

Beispiele

Im folgenden Codebeispiel wird ein Kontrollkästchen-Steuerelement erstellt, das von der CheckBox -Klasse abgeleitet wird, und ein benutzerdefiniertes Control.ControlAccessibleObject für die abgeleitete Klasse erstellt. Die abgeleitete Klasse MyCheckBoxhat standardmäßig eine Appearance von Button , sodass sie als Umschaltfläche angezeigt wird. Die abgeleitete Control.ControlAccessibleObject Klasse überschreibt drei Eigenschaften, MyCheckBoxControlAccessibleObjectum den Unterschied in der Darstellung zu berücksichtigen.

#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

Hinweise

Windows Forms verfügt über integrierte Unterstützung für Barrierefreiheit und stellt Informationen zu Ihrer Anwendung bereit, die es ihr ermöglichen, mit Clientanwendungen für Barrierefreiheit zu arbeiten. Beispiele für Barrierefreiheitsclientanwendungen sind: Bildschirmvergrößerungs- und Prüfprogrammprogramme, Spracheingabeprogramme, Bildschirmtastaturen, alternative Eingabegeräte und Hilfsprogramme zur Tastaturverbesserung. Manchmal möchten Sie zusätzliche Informationen für Barrierefreiheitsclientanwendungen bereitstellen. Es gibt zwei Möglichkeiten, diese zusätzlichen Informationen bereitzustellen. Um Informationen zur eingeschränkten Barrierefreiheit für vorhandene Steuerelemente bereitzustellen, legen Sie die Eigenschaftswerte , AccessibleDescription, AccessibleDefaultActionDescriptionund AccessibleRole des Steuerelements fest, die an Barrierefreiheitsclientanwendungen AccessibleNamegemeldet werden. Wenn Sie mehr Barrierefreiheitsinformationen in Ihr Steuerelement einfügen möchten, können Sie alternativ eine eigene Klasse schreiben, die von der - oder Control.ControlAccessibleObject -AccessibleObjectKlasse abgeleitet ist. Wenn Sie z. B. ein eigenes Steuerelement schreiben, das nicht von den allgemeinen Steuerelementen abgeleitet ist, oder Wenn Sie Vorgänge wie Treffertests innerhalb Ihres Steuerelements benötigen, sollten Sie ein Control.ControlAccessibleObject für Ihr Steuerelement erstellen, indem Sie die CreateAccessibilityInstance -Methode aufrufen.

Hinweis

Wenn Sie die AccessibleObject.GetChild -Methode überschreiben, müssen Sie auch die AccessibleObject.GetChildCount -Methode überschreiben. Zum Abrufen oder Festlegen der AccessibilityObject Eigenschaft müssen Sie einen Verweis auf die Assembly hinzufügen, die Accessibility mit dem .NET Framework installiert ist.

Weitere Informationen zu barrierefreien Objekten finden Sie unter Microsoft Active Accessibility.

Konstruktoren

Control.ControlAccessibleObject(Control)

Initialisiert eine neue Instanz der Control.ControlAccessibleObject-Klasse.

Eigenschaften

Bounds	Ruft die Position und Größe des Eingabehilfenobjekts ab. (Geerbt von AccessibleObject)
DefaultAction	Ruft eine Zeichenfolge ab, die die Standardaktion des Objekts beschreibt. Nicht alle Objekte verfügen über eine Standardaktion.
Description	Ruft die Beschreibung von Control.ControlAccessibleObject ab.
Handle	Ruft das Handle des barrierefreien Objekts ab oder legt dieses fest.
Help	Ruft die Beschreibung der Funktion und Verwendung des Objekts ab.
KeyboardShortcut	Ruft die Tastenkombination oder die Zugriffstaste für ein barrierefreies Objekt ab.
Name	Ruft den Namen des Barrierefreiheitsobjekts ab oder legt ihn fest.
Owner	Ruft den Besitzer des barrierefreien Objekts ab.
Parent	Ruft das übergeordnete Element eines zugreifbaren Objekts ab.
Role	Ruft die Rolle dieses zugreifbaren Objekts ab.
State	Ruft den Zustand dieses barrierefreien Objekts ab. (Geerbt von AccessibleObject)
Value	Ruft den Wert eines barrierefreien Objekts ab oder legt diesen fest. (Geerbt von AccessibleObject)

Methoden

CreateObjRef(Type)	Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
DoDefaultAction()	Führt die Standardaktion aus, die diesem barrierefreien Objekt zugeordnet ist. (Geerbt von AccessibleObject)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetChild(Int32)	Ruft das zugreifbare untergeordnete Element ab, das dem angegebenen Index entspricht. (Geerbt von AccessibleObject)
GetChildCount()	Ruft die Anzahl der untergeordneten Elemente ab, die zu einem Objekt gehören, auf das zugegriffen werden kann. (Geerbt von AccessibleObject)
GetFocused()	Ruft das Objekt ab, das den Tastaturfokus besitzt. (Geerbt von AccessibleObject)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetHelpTopic(String)	Ruft einen Bezeichner für ein Hilfethema und den Pfad der Hilfedatei ab, die diesem barrierefreien Objekt zugeordnet ist.
GetLifetimeService()	Veraltet. Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetSelected()	Ruft das gerade ausgewählte untergeordnete Element ab. (Geerbt von AccessibleObject)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
HitTest(Int32, Int32)	Ruft das untergeordnete Objekt an den angegebenen Bildschirmkoordinaten ab. (Geerbt von AccessibleObject)
InitializeLifetimeService()	Veraltet. Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
Navigate(AccessibleNavigation)	Navigiert zu einem anderen zugreifbaren Objekt. (Geerbt von AccessibleObject)
NotifyClients(AccessibleEvents)	Benachrichtigt Clientanwendungen für die Barrierefreiheit über das angegebene AccessibleEvents.
NotifyClients(AccessibleEvents, Int32)	Benachrichtigt die Clientanwendungen für die Barrierefreiheit über die angegebenen AccessibleEvents für das angegebene untergeordnete Steuerelement.
NotifyClients(AccessibleEvents, Int32, Int32)	Benachrichtigt die Clientanwendungen für die Barrierefreiheit über die angegebenen AccessibleEvents für das angegebene untergeordnete Steuerelement und gibt die Identifikation von AccessibleObject an.
RaiseAutomationNotification(AutomationNotificationKind, AutomationNotificationProcessing, String)	Löst das Benachrichtigungsereignis der Benutzeroberflächenautomatisierung aus. (Geerbt von AccessibleObject)
RaiseLiveRegionChanged()	Löst das LiveRegionChanged-Ereignis der Benutzeroberflächenautomatisierung aus.
RaiseLiveRegionChanged()	Löst das LiveRegionChanged-Ereignis der Benutzeroberflächenautomatisierung aus. (Geerbt von AccessibleObject)
Select(AccessibleSelection)	Ändert die Auswahl oder verschiebt den Tastaturfokus des barrierefreien Objekts. (Geerbt von AccessibleObject)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.
UseStdAccessibleObjects(IntPtr)	Ordnet einer Instanz eines AccessibleObject auf Grundlage des Handles des Objekts ein Objekt zu. (Geerbt von AccessibleObject)
UseStdAccessibleObjects(IntPtr, Int32)	Ordnet einer Instanz eines AccessibleObject anhand des Handles und der Objekt-ID des Objekts ein Objekt zu. (Geerbt von AccessibleObject)

Explizite Schnittstellenimplementierungen

IAccessible.accChildCount	Ruft die Anzahl der untergeordneten Schnittstellen ab, die zu diesem Objekt gehören. Eine Beschreibung dieses Elements finden Sie unter accChildCount. (Geerbt von AccessibleObject)
IAccessible.accDoDefaultAction(Object)	Führt die Standardaktion des angegebenen Objekts aus. Nicht alle Objekte verfügen über eine Standardaktion. Eine Beschreibung dieses Elements finden Sie unter accDoDefaultAction(Object). (Geerbt von AccessibleObject)
IAccessible.accFocus	Ruft das Objekt ab, das den Tastaturfokus besitzt. Eine Beschreibung dieses Elements finden Sie unter accFocus. (Geerbt von AccessibleObject)
IAccessible.accHitTest(Int32, Int32)	Ruft das untergeordnete Objekt an den angegebenen Bildschirmkoordinaten ab. Eine Beschreibung dieses Elements finden Sie unter accHitTest(Int32, Int32). (Geerbt von AccessibleObject)
IAccessible.accLocation(Int32, Int32, Int32, Int32, Object)	Ruft die aktuelle Bildschirmposition des Objekts ab. Eine Beschreibung dieses Elements finden Sie unter accLocation(Int32, Int32, Int32, Int32, Object). (Geerbt von AccessibleObject)
IAccessible.accNavigate(Int32, Object)	Navigiert zu einem barrierefreien Objekt relativ zum aktuellen Objekt. Eine Beschreibung dieses Elements finden Sie unter accNavigate(Int32, Object). (Geerbt von AccessibleObject)
IAccessible.accParent	Ruft das diesem Objekt übergeordnete barrierefreie Objekt ab. Eine Beschreibung dieses Elements finden Sie unter accParent. (Geerbt von AccessibleObject)
IAccessible.accSelect(Int32, Object)	Ändert die Auswahl oder verschiebt den Tastaturfokus des barrierefreien Objekts. Eine Beschreibung dieses Elements finden Sie unter accSelect(Int32, Object). (Geerbt von AccessibleObject)
IAccessible.accSelection	Ruft die ausgewählten untergeordneten Objekte eines barrierefreien Objekts ab. Eine Beschreibung dieses Elements finden Sie unter accSelection. (Geerbt von AccessibleObject)
IReflect.GetField(String, BindingFlags)	Ruft das FieldInfo-Objekt ab, das dem angegebenen Feld und dem angegebenen Bindungsflag entspricht. Eine Beschreibung dieses Elements finden Sie unter GetField(String, BindingFlags). (Geerbt von AccessibleObject)
IReflect.GetFields(BindingFlags)	Ruft ein Array von FieldInfo-Objekten ab, die allen Feldern der aktuellen Klasse entsprechen. Eine Beschreibung dieses Elements finden Sie unter GetFields(BindingFlags). (Geerbt von AccessibleObject)
IReflect.GetMember(String, BindingFlags)	Ruft ein Array von MemberInfo-Objekten ab, die entweder allen öffentlichen Membern oder allen Membern entsprechen, die mit einem angegebenen Namen übereinstimmen. Eine Beschreibung dieses Elements finden Sie unter GetMember(String, BindingFlags). (Geerbt von AccessibleObject)
IReflect.GetMembers(BindingFlags)	Ruft ein Array von MemberInfo-Objekten ab, die entweder allen öffentlichen Membern oder allen Membern der aktuellen Klasse entsprechen. Eine Beschreibung dieses Elements finden Sie unter GetMembers(BindingFlags). (Geerbt von AccessibleObject)
IReflect.GetMethod(String, BindingFlags)	Ruft ein MethodInfo-Objekt ab, das unter angegebenen Sucheinschränkungen einer angegebenen Methode entspricht. Eine Beschreibung dieses Elements finden Sie unter GetMethod(String, BindingFlags). (Geerbt von AccessibleObject)
IReflect.GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[])	Ruft ein MethodInfo-Objekt ab, das einer angegebenen Methode entspricht, und verwendet für die Auswahl überladener Methoden ein Type-Array. Eine Beschreibung dieses Elements finden Sie unter GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[]). (Geerbt von AccessibleObject)
IReflect.GetMethods(BindingFlags)	Ruft ein Array von MethodInfo-Objekten mit allen öffentlichen Methoden oder allen Methoden der aktuellen Klasse ab. Eine Beschreibung dieses Elements finden Sie unter GetMethods(BindingFlags). (Geerbt von AccessibleObject)
IReflect.GetProperties(BindingFlags)	Ruft ein Array von PropertyInfo-Objekten ab, die entweder allen öffentlichen Eigenschaften oder allen Eigenschaften der aktuellen Klasse entsprechen. Eine Beschreibung dieses Elements finden Sie unter GetProperties(BindingFlags). (Geerbt von AccessibleObject)
IReflect.GetProperty(String, BindingFlags)	Ruft ein PropertyInfo-Objekt ab, das unter den angegebenen Sucheinschränkungen einer angegebenen Eigenschaft entspricht. Eine Beschreibung dieses Elements finden Sie unter GetProperty(String, BindingFlags). (Geerbt von AccessibleObject)
IReflect.GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])	Ruft ein PropertyInfo-Objekt ab, das unter den angegebenen Sucheinschränkungen einer angegebenen Eigenschaft entspricht. Eine Beschreibung dieses Elements finden Sie unter GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[]). (Geerbt von AccessibleObject)
IReflect.InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[])	Ruft einen angegebenen Member auf. Eine Beschreibung dieses Elements finden Sie unter InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]). (Geerbt von AccessibleObject)
IReflect.UnderlyingSystemType	Ruft den zugrunde liegenden Typ ab, der das IReflect-Objekt darstellt. Eine Beschreibung dieses Elements finden Sie unter UnderlyingSystemType. (Geerbt von AccessibleObject)

Gilt für:

Freigeben über