Control.ControlAccessibleObject-Klasse

Stellt Informationen über ein Steuerelement bereit, das mit Programmen für Eingabehilfen verwendet werden kann.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
<ComVisibleAttribute(True)> _
Public Class ControlAccessibleObject
    Inherits AccessibleObject
'Usage
Dim instance As ControlAccessibleObject

[ComVisibleAttribute(true)] 
public class ControlAccessibleObject : AccessibleObject

[ComVisibleAttribute(true)] 
public ref class ControlAccessibleObject : public AccessibleObject

/** @attribute ComVisibleAttribute(true) */ 
public class ControlAccessibleObject extends AccessibleObject

ComVisibleAttribute(true) 
public class ControlAccessibleObject extends AccessibleObject

Hinweise

Die Unterstützung von Eingabehilfen ist in Windows Forms integriert und stellt Informationen über die Anwendung bereit, damit diese mit Clientprogrammen für Eingabehilfen verwendet werden kann. Zu Clientprogrammen für Eingabehilfen zählen: Dienstprogramme für die Bild- und Schriftvergrößerung, Dokumentüberarbeitung sowie für die Spracherkennung, Bildschirmtastaturen, alternative Eingabegeräte und Dienstprogramme für Tastaturerweiterungen. Damit können Sie ggf. Informationen für Clientprogramme für Eingabehilfen bereitstellen. Es gibt zwei Möglichkeiten, diese zusätzlichen Informationen bereitzustellen. Legen Sie den AccessibleName-Eigenschaftenwert, den AccessibleDescription-Eigenschaftenwert, den AccessibleDefaultActionDescription-Eigenschaftenwert und den AccessibleRole-Eigenschaftenwert des Steuerelements fest, die an die Clientprogramme für Eingabehilfen gemeldet werden, um begrenzte Informationen zu Eingabehilfen für vorhandene Steuerelemente bereitzustellen. Wenn weitere Informationen zu Eingabehilfen in dem Steuerelement enthalten sein sollen, können Sie alternativ eine eigene Klasse schreiben, die von der AccessibleObject-Klasse oder der Control.ControlAccessibleObject-Klasse abgeleitet ist. Wenn Sie z. B. eine eigene, nicht von den Standardsteuerelementen abgeleitete Klasse schreiben, oder wenn für ein Steuerelement Operationen wie Aufrufüberprüfungen erforderlich sind, sollten Sie durch Aufruf der CreateAccessibilityInstance-Methode ein Control.ControlAccessibleObject erstellen.

Hinweis

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

Weitere Informationen zu Eingabehilfenobjekten finden Sie in der MSDN Library im Abschnitt Active Accessibility.

Beispiel

Im folgenden Codebeispiel werden ein von der CheckBox-Klasse abgeleitetes Kontrollkästchen-Steuerelement und ein benutzerdefiniertes Control.ControlAccessibleObject für die abgeleitete Klasse erstellt. Die Appearance der abgeleiteten MyCheckBox-Klasse entspricht in der Standardeinstellung Button, sodass sie als eine Umschaltfläche dargestellt wird. Die abgeleitete Control.ControlAccessibleObject-Klasse, MyCheckBoxControlAccessibleObject, überschreibt drei Eigenschaften, um eine unterschiedliche Darstellung zu erreichen.

Imports System
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 Not (accessibleName Is 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

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

#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 );
   }
}

package MyCustomControls;
import System.*;
import System.Windows.Forms.*;
import Accessibility.*;
import System.Drawing.*;

public class MyCheckBox extends CheckBox
{
    public MyCheckBox()
    {
        // Make the check box appear like a toggle button.
        this.set_Appearance(get_Appearance().Button);
        // Center the text on the button.
        this.set_TextAlign(ContentAlignment.MiddleCenter);
        // Set the AccessibleDescription text.
        this.set_AccessibleDescription("A toggle style button.");
    } //MyCheckBox

    // Create an instance of the AccessibleObject 
    // defined for the 'MyCheckBox' control
    protected AccessibleObject CreateAccessibilityInstance()
    {
        return new MyCheckBoxAccessibleObject(this);
    } //CreateAccessibilityInstance
} //MyCheckBox

// Accessible object for use with the 'MyCheckBox' control.
class MyCheckBoxAccessibleObject extends Control.ControlAccessibleObject
{
    public MyCheckBoxAccessibleObject(MyCheckBox owner)
    {
         super(owner);
    } //MyCheckBoxAccessibleObject

    /** @property 
     */
    public String get_DefaultAction()
    {
        // Return the DefaultAction based upon 
        // the state of the control.
        if (((MyCheckBox)get_Owner()).get_Checked()) {
            return "Toggle button up";
        }
        else {
            return "Toggle button down";
        }
    } //get_DefaultAction

    /** @property 
     */
    public String get_Name()
    {
        // Return the Text property of the control 
        // if the AccessibleName is null.
        String name = get_Owner().get_AccessibleName();
        if (name != null) {
            return name;
        }
        return ((MyCheckBox)get_Owner()).get_Text();
    } //get_Name

    /** @property 
     */
    public void set_Name(String value)
    {
        super.set_Name(value);
    } //set_Name

    /** @property 
     */
    public AccessibleRole get_Role()
    {
        // Since the check box appears like a button,
        // make the Role the same as a button.
        return AccessibleRole.PushButton;
    } //get_Role
} //MyCheckBoxAccessibleObject

Vererbungshierarchie

System.Object
   System.MarshalByRefObject
     System.Runtime.InteropServices.StandardOleMarshalObject
       System.Windows.Forms.AccessibleObject
        System.Windows.Forms.Control.ControlAccessibleObject
           System.Windows.Forms.ButtonBase.ButtonBaseAccessibleObject
           System.Windows.Forms.DataGridView.DataGridViewAccessibleObject
           System.Windows.Forms.DateTimePicker.DateTimePickerAccessibleObject
           System.Windows.Forms.DomainUpDown.DomainUpDownAccessibleObject
           System.Windows.Forms.ToolStrip.ToolStripAccessibleObject

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Control.ControlAccessibleObject-Member
System.Windows.Forms-Namespace
AccessibleObject-Klasse
Control.AccessibleName-Eigenschaft
Control.AccessibleDescription-Eigenschaft
Control.AccessibleDefaultActionDescription-Eigenschaft
Control.AccessibleRole-Eigenschaft