Control.ControlAccessibleObject Classe
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
- Héritage
- Dérivé
- Attributs
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
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.
Control. |
Initialise une nouvelle instance de la classe Control.ControlAccessibleObject. |
Bounds |
Obtient l'emplacement et la taille de l'objet accessible. (Hérité de AccessibleObject) |
Default |
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é. |
Keyboard |
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) |
Create |
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) |
Do |
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) |
Get |
Récupère l’enfant accessible correspondant à l’index spécifié. (Hérité de AccessibleObject) |
Get |
Récupère le nombre d’enfants qui appartiennent à un objet accessible. (Hérité de AccessibleObject) |
Get |
Récupère l'objet qui a le focus clavier. (Hérité de AccessibleObject) |
Get |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
Get |
Obtient un identificateur d'une rubrique d'aide et le chemin d'accès du fichier d'aide associé à l'objet accessible. |
Get |
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) |
Get |
Récupère l'enfant actuellement sélectionné. (Hérité de AccessibleObject) |
Get |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
Hit |
Récupère l'objet enfant qui est situé aux coordonnées d'écran spécifiées. (Hérité de AccessibleObject) |
Initialize |
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) |
Memberwise |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
Memberwise |
Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject) |
Navigate(Accessible |
Navigue vers un autre objet accessible. (Hérité de AccessibleObject) |
Notify |
Avertit les applications clientes d'accessibilité des AccessibleEvents spécifiés. |
Notify |
Avertit les applications clientes d'accessibilité des AccessibleEvents spécifiés pour le contrôle enfant spécifié. |
Notify |
Avertit les applications clientes d'accessibilité de AccessibleEvents spécifié pour le contrôle enfant spécifié, en donnant l'identification de AccessibleObject. |
Raise |
Déclenche l’événement de notification d’UI Automation. (Hérité de AccessibleObject) |
Raise |
Déclenche l’événement UI Automation LiveRegionChanged. |
Raise |
Déclenche l’événement UI Automation LiveRegionChanged. (Hérité de AccessibleObject) |
Select(Accessible |
Modifie la sélection ou déplace le focus clavier de l'objet accessible. (Hérité de AccessibleObject) |
To |
Retourne une chaîne qui représente l'objet actuel. |
Use |
Associe un objet à une instance d'un AccessibleObject basé sur le handle de l'objet. (Hérité de AccessibleObject) |
Use |
Associe un objet à une instance d'un AccessibleObject basé sur le handle et l'ID d'objet de l'objet. (Hérité de AccessibleObject) |
IAccessible. |
Obtient le nombre d'interfaces enfants qui appartiennent à cet objet. Pour obtenir une description de ce membre, consultez accChildCount. (Hérité de AccessibleObject) |
IAccessible. |
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. |
Obtient l'objet qui a le focus clavier. Pour obtenir une description de ce membre, consultez accFocus. (Hérité de AccessibleObject) |
IAccessible. |
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. |
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. |
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. |
Obtient l'objet accessible aux parents de cet objet. Pour obtenir une description de ce membre, consultez accParent. (Hérité de AccessibleObject) |
IAccessible. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
Obtient le type sous-jacent qui représente l'objet IReflect. Pour obtenir une description de ce membre, consultez UnderlyingSystemType. (Hérité de AccessibleObject) |
Produit | Versions |
---|---|
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
Commentaires sur .NET
.NET est un projet open source. Sélectionnez un lien pour fournir des commentaires :