DataGridView.DataGridViewAccessibleObject Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Provides information about the DataGridView control to accessibility client applications.
protected: ref class DataGridView::DataGridViewAccessibleObject : System::Windows::Forms::Control::ControlAccessibleObject[System.Runtime.InteropServices.ComVisible(true)]
protected class DataGridView.DataGridViewAccessibleObject : System.Windows.Forms.Control.ControlAccessibleObjectprotected class DataGridView.DataGridViewAccessibleObject : System.Windows.Forms.Control.ControlAccessibleObjectProtected Class DataGridView.DataGridViewAccessibleObject
Inherits Control.ControlAccessibleObject- Inheritance
-
DataGridView.DataGridViewAccessibleObject
- Attributes
Remarks
Windows Forms has accessibility support built in and provides information about your application that allows it to work with accessibility client applications. Examples of accessibility client applications are screen enlarger and reviewer utilities, voice input utilities, on-screen keyboards, alternative input devices, and keyboard enhancement utilities.
The DataGridView.DataGridViewAccessibleObject class inherits from the AccessibleObject class to provide information about the DataGridView control to accessibility client applications. Each class that represents a visual part of the DataGridView - DataGridViewColumnHeaderCell, DataGridViewRowHeaderCell, DataGridViewRow, and DataGridViewCell - also contains a class that inherits from AccessibleObject to provide information about the containing class and perform actions on behalf of accessibility client applications.
There are instances when you will want to provide additional information, such as the name or description of the DataGridView control, to accessibility client applications. There are two ways of providing this additional information. To provide limited accessibility information for existing controls, set the control's AccessibleName and AccessibleDescription property values, which will be reported to accessibility client applications.
Note
You should change the AccessibleDefaultActionDescription and AccessibleRole property values only in rare situations, such as if you make a DataGridView look like a list.
Occasionally, you might require more accessibility information or different accessibility actions to be included with your custom DataGridView or DataGridViewCell. To customize accessibility, you can write your own class that derives from the DataGridView.DataGridViewAccessibleObject or DataGridViewCell.DataGridViewCellAccessibleObject classes and override the CreateAccessibilityInstance method. For example, if you are writing a custom row header cell that implements unique custom actions, such as special hit testing within your cell, you should create a class that inherits from the DataGridViewRowHeaderCell.DataGridViewRowHeaderCellAccessibleObject class and override the CreateAccessibilityInstance method.
The DataGridView exposes its data structure by using AccessibleRole values to define the data table hierarchy. For more information on exposing data tables to Microsoft Active Accessibility, see Exposing Data Tables through Microsoft Active Accessibility.
Constructors
| DataGridView.DataGridViewAccessibleObject(DataGridView) |
Initializes a new instance of the DataGridView.DataGridViewAccessibleObject class. |
Properties
| Bounds |
Gets the location and size of the accessible object. (Inherited from AccessibleObject) |
| DefaultAction |
Gets a string that describes the default action of the object. Not all objects have a default action. (Inherited from Control.ControlAccessibleObject) |
| Description |
Gets the description of the Control.ControlAccessibleObject. (Inherited from Control.ControlAccessibleObject) |
| Handle |
Gets or sets the handle of the accessible object. (Inherited from Control.ControlAccessibleObject) |
| Help |
Gets the description of what the object does or how the object is used. (Inherited from Control.ControlAccessibleObject) |
| KeyboardShortcut |
Gets the object shortcut key or access key for an accessible object. (Inherited from Control.ControlAccessibleObject) |
| Name |
Gets or sets the accessible object name. |
| Name |
Gets or sets the accessible object name. (Inherited from Control.ControlAccessibleObject) |
| Owner |
Gets the owner of the accessible object. (Inherited from Control.ControlAccessibleObject) |
| Parent |
Gets the parent of an accessible object. (Inherited from Control.ControlAccessibleObject) |
| Role |
Gets the role of the DataGridView.DataGridViewAccessibleObject. |
| State |
Gets the state of this accessible object. (Inherited from AccessibleObject) |
| Value |
Gets or sets the value of an accessible object. (Inherited from AccessibleObject) |
Methods
| CreateObjRef(Type) |
Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject) |
| DoDefaultAction() |
Performs the default action associated with this accessible object. (Inherited from AccessibleObject) |
| Equals(Object) |
Determines whether the specified object is equal to the current object. (Inherited from Object) |
| GetChild(Int32) |
Returns the child accessible object corresponding to the specified index. |
| GetChildCount() |
Returns the number of child objects belonging to an accessible object. |
| GetFocused() |
Returns the accessible object of the DataGridViewCell that has the keyboard focus. |
| GetHashCode() |
Serves as the default hash function. (Inherited from Object) |
| GetHelpTopic(String) |
Gets an identifier for a Help topic and the path to the Help file associated with this accessible object. (Inherited from Control.ControlAccessibleObject) |
| GetLifetimeService() |
Obsolete.
Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject) |
| GetSelected() |
Returns an AccessibleObject that represents the selected cells in the DataGridView control. |
| GetType() |
Gets the Type of the current instance. (Inherited from Object) |
| HitTest(Int32, Int32) |
Retrieves the child object at the specified screen coordinates. |
| InitializeLifetimeService() |
Obsolete.
Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject) |
| MemberwiseClone() |
Creates a shallow copy of the current Object. (Inherited from Object) |
| MemberwiseClone(Boolean) |
Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject) |
| Navigate(AccessibleNavigation) |
Navigates to another accessible object. |
| NotifyClients(AccessibleEvents) |
Notifies accessibility client applications of the specified AccessibleEvents. (Inherited from Control.ControlAccessibleObject) |
| NotifyClients(AccessibleEvents, Int32) |
Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control. (Inherited from Control.ControlAccessibleObject) |
| NotifyClients(AccessibleEvents, Int32, Int32) |
Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control, giving the identification of the AccessibleObject. (Inherited from Control.ControlAccessibleObject) |
| RaiseAutomationNotification(AutomationNotificationKind, AutomationNotificationProcessing, String) |
Raises the UI automation notification event. (Inherited from AccessibleObject) |
| RaiseLiveRegionChanged() |
Raises the LiveRegionChanged UI automation event. (Inherited from Control.ControlAccessibleObject) |
| Select(AccessibleSelection) |
Modifies the selection or moves the keyboard focus of the accessible object. (Inherited from AccessibleObject) |
| ToString() |
Returns a string that represents the current object. (Inherited from Control.ControlAccessibleObject) |
| UseStdAccessibleObjects(IntPtr) |
Associates an object with an instance of an AccessibleObject based on the handle of the object. (Inherited from AccessibleObject) |
| UseStdAccessibleObjects(IntPtr, Int32) |
Associates an object with an instance of an AccessibleObject based on the handle and the object id of the object. (Inherited from AccessibleObject) |
Explicit Interface Implementations
| IAccessible.accChildCount |
Gets the number of child interfaces that belong to this object. For a description of this member, see accChildCount. (Inherited from AccessibleObject) |
| IAccessible.accDoDefaultAction(Object) |
Performs the specified object's default action. Not all objects have a default action. For a description of this member, see accDoDefaultAction(Object). (Inherited from AccessibleObject) |
| IAccessible.accFocus |
Gets the object that has the keyboard focus. For a description of this member, see accFocus. (Inherited from AccessibleObject) |
| IAccessible.accHitTest(Int32, Int32) |
Gets the child object at the specified screen coordinates. For a description of this member, see accHitTest(Int32, Int32). (Inherited from AccessibleObject) |
| IAccessible.accLocation(Int32, Int32, Int32, Int32, Object) |
Gets the object's current screen location. For a description of this member, see accLocation(Int32, Int32, Int32, Int32, Object). (Inherited from AccessibleObject) |
| IAccessible.accNavigate(Int32, Object) |
Navigates to an accessible object relative to the current object. For a description of this member, see accNavigate(Int32, Object). (Inherited from AccessibleObject) |
| IAccessible.accParent |
Gets the parent accessible object of this object. For a description of this member, see accParent. (Inherited from AccessibleObject) |
| IAccessible.accSelect(Int32, Object) |
Modifies the selection or moves the keyboard focus of the accessible object. For a description of this member, see accSelect(Int32, Object). (Inherited from AccessibleObject) |
| IAccessible.accSelection |
Gets the selected child objects of an accessible object. For a description of this member, see accSelection. (Inherited from AccessibleObject) |
| IReflect.GetField(String, BindingFlags) |
Gets the FieldInfo object corresponding to the specified field and binding flag. For a description of this member, see GetField(String, BindingFlags). (Inherited from AccessibleObject) |
| IReflect.GetFields(BindingFlags) |
Gets an array of FieldInfo objects corresponding to all fields of the current class. For a description of this member, see GetFields(BindingFlags). (Inherited from AccessibleObject) |
| IReflect.GetMember(String, BindingFlags) |
Gets an array of MemberInfo objects corresponding to all public members or to all members that match a specified name. For a description of this member, see GetMember(String, BindingFlags). (Inherited from AccessibleObject) |
| IReflect.GetMembers(BindingFlags) |
Gets an array of MemberInfo objects corresponding either to all public members or to all members of the current class. For a description of this member, see GetMembers(BindingFlags). (Inherited from AccessibleObject) |
| IReflect.GetMethod(String, BindingFlags) |
Gets a MethodInfo object corresponding to a specified method under specified search constraints. For a description of this member, see GetMethod(String, BindingFlags). (Inherited from AccessibleObject) |
| IReflect.GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[]) |
Gets a MethodInfo object corresponding to a specified method, using a Type array to choose from among overloaded methods. For a description of this member, see GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[]). (Inherited from AccessibleObject) |
| IReflect.GetMethods(BindingFlags) |
Gets an array of MethodInfo objects with all public methods or all methods of the current class. For a description of this member, see GetMethods(BindingFlags). (Inherited from AccessibleObject) |
| IReflect.GetProperties(BindingFlags) |
Gets an array of PropertyInfo objects corresponding to all public properties or to all properties of the current class. For a description of this member, see GetProperties(BindingFlags). (Inherited from AccessibleObject) |
| IReflect.GetProperty(String, BindingFlags) |
Gets a PropertyInfo object corresponding to a specified property under specified search constraints. For a description of this member, see GetProperty(String, BindingFlags). (Inherited from AccessibleObject) |
| IReflect.GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[]) |
Gets a PropertyInfo object corresponding to a specified property with specified search constraints. For a description of this member, see GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[]). (Inherited from AccessibleObject) |
| IReflect.InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]) |
Invokes a specified member. For a description of this member, see InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]). (Inherited from AccessibleObject) |
| IReflect.UnderlyingSystemType |
Gets the underlying type that represents the IReflect object. For a description of this member, see UnderlyingSystemType. (Inherited from AccessibleObject) |
