Control.ControlAccessibleObject Classe

Définition

Fournit des informations sur un contrôle qui peut être utilisé par une application d’accessibilité.

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
Héritage
Control.ControlAccessibleObject
Héritage
Dérivé
Attributs

Exemples

L’exemple de code suivant crée un contrôle de case à cocher qui dérive de la CheckBox classe et crée un personnalisé Control.ControlAccessibleObject pour la classe dérivée à utiliser. La classe dérivée, MyCheckBox, a un Appearance de Button par défaut et s’affiche donc sous la forme d’un bouton bascule. La classe dérivée Control.ControlAccessibleObject , MyCheckBoxControlAccessibleObject, remplace trois propriétés pour tenir compte de la différence d’apparence.

#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

Remarques

Windows Forms intègre une prise en charge de l’accessibilité et fournit des informations sur votre application qui lui permettent d’utiliser des applications clientes d’accessibilité. Voici quelques exemples d’applications clientes d’accessibilité : utilitaires d’agrandissement et de réviseur d’écran, utilitaires d’entrée vocale, claviers à l’écran, autres périphériques d’entrée et utilitaires d’amélioration du clavier. Parfois, vous souhaiterez fournir des informations supplémentaires aux applications clientes d’accessibilité. Il existe deux façons de fournir ces informations supplémentaires. Pour fournir des informations d’accessibilité limitées pour les contrôles existants, définissez les valeurs de propriété , , AccessibleDescriptionAccessibleDefaultActionDescriptionet AccessibleRole du AccessibleNamecontrôle, qui seront signalées aux applications clientes d’accessibilité. Si vous avez besoin d’inclure plus d’informations d’accessibilité dans votre contrôle, vous pouvez également écrire votre propre classe dérivant des AccessibleObject classes ou Control.ControlAccessibleObject . Par exemple, si vous écrivez votre propre contrôle qui n’est pas dérivé des contrôles courants ou si vous avez besoin d’opérations telles que le test d’accès au sein de votre contrôle, vous devez créer un Control.ControlAccessibleObject pour votre contrôle en appelant la CreateAccessibilityInstance méthode .

Notes

Si vous remplacez la AccessibleObject.GetChild méthode, vous devez également remplacer la AccessibleObject.GetChildCount méthode. Pour obtenir ou définir la AccessibilityObject propriété, vous devez ajouter une référence à l’assembly Accessibility installé avec le .NET Framework.

Pour plus d’informations sur les objets accessibles, consultez Microsoft Accessibilité active.

Constructeurs

Control.ControlAccessibleObject(Control)

Initialise une nouvelle instance de la classe Control.ControlAccessibleObject.

Propriétés

Bounds

Obtient l'emplacement et la taille de l'objet accessible.

(Hérité de AccessibleObject)
DefaultAction

Obtient une chaîne qui décrit l’action par défaut de l’objet. Les objets n'ont pas tous une action par défaut.

Description

Obtient la description du Control.ControlAccessibleObject.

Handle

Obtient ou définit le handle de l'objet accessible.

Help

Obtient la description de ce que fait l'objet ou comment il est utilisé.

KeyboardShortcut

Obtient la touche de raccourci ou la touche d'accès rapide de l'objet pour un objet accessible.

Name

Obtient ou définit le nom de l'objet accessible.

Owner

Obtient le propriétaire de l'objet accessible.

Parent

Obtient le parent d'un objet accessible.

Role

Obtient le rôle de l'objet accessible.

State

Obtient l'état de l'objet accessible.

(Hérité de AccessibleObject)
Value

Obtient ou définit la valeur d'un objet accessible.

(Hérité de AccessibleObject)

Méthodes

CreateObjRef(Type)

Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant.

(Hérité de MarshalByRefObject)
DoDefaultAction()

Exécute l'action associée par défaut à l'objet accessible.

(Hérité de AccessibleObject)
Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetChild(Int32)

Récupère l’enfant accessible correspondant à l’index spécifié.

(Hérité de AccessibleObject)
GetChildCount()

Récupère le nombre d’enfants qui appartiennent à un objet accessible.

(Hérité de AccessibleObject)
GetFocused()

Récupère l'objet qui a le focus clavier.

(Hérité de AccessibleObject)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetHelpTopic(String)

Obtient un identificateur d'une rubrique d'aide et le chemin d'accès du fichier d'aide associé à l'objet accessible.

GetLifetimeService()
Obsolète.

Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance.

(Hérité de MarshalByRefObject)
GetSelected()

Récupère l'enfant actuellement sélectionné.

(Hérité de AccessibleObject)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
HitTest(Int32, Int32)

Récupère l'objet enfant qui est situé aux coordonnées d'écran spécifiées.

(Hérité de AccessibleObject)
InitializeLifetimeService()
Obsolète.

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.

(Hérité de MarshalByRefObject)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.

(Hérité de MarshalByRefObject)
Navigate(AccessibleNavigation)

Navigue vers un autre objet accessible.

(Hérité de AccessibleObject)
NotifyClients(AccessibleEvents)

Avertit les applications clientes d'accessibilité des AccessibleEvents spécifiés.

NotifyClients(AccessibleEvents, Int32)

Avertit les applications clientes d'accessibilité des AccessibleEvents spécifiés pour le contrôle enfant spécifié.

NotifyClients(AccessibleEvents, Int32, Int32)

Avertit les applications clientes d'accessibilité de AccessibleEvents spécifié pour le contrôle enfant spécifié, en donnant l'identification de AccessibleObject.

RaiseAutomationNotification(AutomationNotificationKind, AutomationNotificationProcessing, String)

Déclenche l’événement de notification d’UI Automation.

(Hérité de AccessibleObject)
RaiseLiveRegionChanged()

Déclenche l’événement UI Automation LiveRegionChanged.

RaiseLiveRegionChanged()

Déclenche l’événement UI Automation LiveRegionChanged.

(Hérité de AccessibleObject)
Select(AccessibleSelection)

Modifie la sélection ou déplace le focus clavier de l'objet accessible.

(Hérité de AccessibleObject)
ToString()

Retourne une chaîne qui représente l'objet actuel.

UseStdAccessibleObjects(IntPtr)

Associe un objet à une instance d'un AccessibleObject basé sur le handle de l'objet.

(Hérité de AccessibleObject)
UseStdAccessibleObjects(IntPtr, Int32)

Associe un objet à une instance d'un AccessibleObject basé sur le handle et l'ID d'objet de l'objet.

(Hérité de AccessibleObject)

Implémentations d’interfaces explicites

IAccessible.accChildCount

Obtient le nombre d'interfaces enfants qui appartiennent à cet objet. Pour obtenir une description de ce membre, consultez accChildCount.

(Hérité de AccessibleObject)
IAccessible.accDoDefaultAction(Object)

Exécute l'action par défaut de l'objet spécifié. Les objets n'ont pas tous une action par défaut. Pour obtenir une description de ce membre, consultez accDoDefaultAction(Object).

(Hérité de AccessibleObject)
IAccessible.accFocus

Obtient l'objet qui a le focus clavier. Pour obtenir une description de ce membre, consultez accFocus.

(Hérité de AccessibleObject)
IAccessible.accHitTest(Int32, Int32)

Obtient l'objet enfant qui est situé aux coordonnées d'écran spécifiées. Pour obtenir une description de ce membre, consultez accHitTest(Int32, Int32).

(Hérité de AccessibleObject)
IAccessible.accLocation(Int32, Int32, Int32, Int32, Object)

Obtient l'emplacement d'affichage actuel de l'objet. Pour obtenir une description de ce membre, consultez accLocation(Int32, Int32, Int32, Int32, Object).

(Hérité de AccessibleObject)
IAccessible.accNavigate(Int32, Object)

Navigue vers un objet accessible relatif à l'objet actuel. Pour obtenir une description de ce membre, consultez accNavigate(Int32, Object).

(Hérité de AccessibleObject)
IAccessible.accParent

Obtient l'objet accessible aux parents de cet objet. Pour obtenir une description de ce membre, consultez accParent.

(Hérité de AccessibleObject)
IAccessible.accSelect(Int32, Object)

Modifie la sélection ou déplace le focus clavier de l'objet accessible. Pour obtenir une description de ce membre, consultez accSelect(Int32, Object).

(Hérité de AccessibleObject)
IAccessible.accSelection

Obtient les objets enfants sélectionnés d'un objet accessible. Pour obtenir une description de ce membre, consultez accSelection.

(Hérité de AccessibleObject)
IReflect.GetField(String, BindingFlags)

Obtient l'objet FieldInfo correspondant au champ et à l'indicateur de liaison spécifiés. Pour obtenir une description de ce membre, consultez GetField(String, BindingFlags).

(Hérité de AccessibleObject)
IReflect.GetFields(BindingFlags)

Obtient un tableau d'objets FieldInfo correspondant à tous les champs de la classe en cours. Pour obtenir une description de ce membre, consultez GetFields(BindingFlags).

(Hérité de AccessibleObject)
IReflect.GetMember(String, BindingFlags)

Obtient un tableau d'objets MemberInfo représentant tous les membres publics ou tous les membres qui correspondent à un nom spécifié. Pour obtenir une description de ce membre, consultez GetMember(String, BindingFlags).

(Hérité de AccessibleObject)
IReflect.GetMembers(BindingFlags)

Obtient un tableau d'objets MemberInfo correspondant à tous les membres publics ou à tous les membres de la classe en cours. Pour obtenir une description de ce membre, consultez GetMembers(BindingFlags).

(Hérité de AccessibleObject)
IReflect.GetMethod(String, BindingFlags)

Obtient un objet MethodInfo correspondant à une méthode spécifiée avec les contraintes de recherche données. Pour obtenir une description de ce membre, consultez GetMethod(String, BindingFlags).

(Hérité de AccessibleObject)
IReflect.GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[])

Obtient un objet MethodInfo correspondant à une méthode spécifiée en sélectionnant une des méthodes surchargées à l'aide d'un tableau Type. Pour obtenir une description de ce membre, consultez GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[]).

(Hérité de AccessibleObject)
IReflect.GetMethods(BindingFlags)

Obtient un tableau d'objets MethodInfo contenant toutes les méthodes publiques ou toutes les méthodes de la classe en cours. Pour obtenir une description de ce membre, consultez GetMethods(BindingFlags).

(Hérité de AccessibleObject)
IReflect.GetProperties(BindingFlags)

Obtient un tableau d'objets PropertyInfo correspondant à toutes les propriétés publiques ou à toutes les propriétés de la classe en cours. Pour obtenir une description de ce membre, consultez GetProperties(BindingFlags).

(Hérité de AccessibleObject)
IReflect.GetProperty(String, BindingFlags)

Obtient un objet PropertyInfo correspondant à une propriété spécifiée avec les contraintes de recherche données. Pour obtenir une description de ce membre, consultez GetProperty(String, BindingFlags).

(Hérité de AccessibleObject)
IReflect.GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])

Obtient un objet PropertyInfo correspondant à une propriété spécifiée avec les contraintes de recherche données. Pour obtenir une description de ce membre, consultez GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[]).

(Hérité de AccessibleObject)
IReflect.InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[])

Appelle un membre spécifié. Pour obtenir une description de ce membre, consultez InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]).

(Hérité de AccessibleObject)
IReflect.UnderlyingSystemType

Obtient le type sous-jacent qui représente l'objet IReflect. Pour obtenir une description de ce membre, consultez UnderlyingSystemType.

(Hérité de AccessibleObject)

S’applique à

Voir aussi