Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

Control.ControlAccessibleObject-Klasse

Aktualisiert: November 2007

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)

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

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.

kb5ze4tt.alert_note(de-de,VS.90).gifHinweis:

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.

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.

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


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


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

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0, 2.0, 1.1, 1.0
Anzeigen: