DataGridViewCell.DataGridViewCellAccessibleObject Class

Definition

Provides information about a DataGridViewCell to accessibility client applications.

protected: ref class DataGridViewCell::DataGridViewCellAccessibleObject : System::Windows::Forms::AccessibleObject
[System.Runtime.InteropServices.ComVisible(true)]
protected class DataGridViewCell.DataGridViewCellAccessibleObject : System.Windows.Forms.AccessibleObject
Protected Class DataGridViewCell.DataGridViewCellAccessibleObject
Inherits AccessibleObject
Inheritance
DataGridViewCell.DataGridViewCellAccessibleObject
Derived
Attributes

Remarks

Windows Forms includes built-in accessibility support that allows your application to work with accessibility client applications. Examples of accessibility client applications include screen enlarger and reviewer utilities, voice input utilities, on-screen keyboards, alternative input devices, and keyboard enhancement utilities.

The DataGridViewCell.DataGridViewCellAccessibleObject class inherits from the AccessibleObject class to provide information about a DataGridViewCell to accessibility client applications. Each class that represents a visual part of the DataGridView - such as 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" in the MSDN library at https://msdn.microsoft.com/library.

Constructors

DataGridViewCell.DataGridViewCellAccessibleObject()

Initializes a new instance of the DataGridViewCell.DataGridViewCellAccessibleObject class without initializing the Owner property.

DataGridViewCell.DataGridViewCellAccessibleObject(DataGridViewCell)

Initializes a new instance of the DataGridViewCell.DataGridViewCellAccessibleObject class, setting the Owner property to the specified DataGridViewCell.

Properties

Bounds

Gets the location and size of the accessible object.

DefaultAction

Gets a string that describes the default action of the DataGridViewCell.

Description

Gets a string that describes the visual appearance of the specified object. Not all objects have a description.

(Inherited from AccessibleObject)
Help

Gets the names of the owning cell's type and base type.

KeyboardShortcut

Gets the shortcut key or access key for the accessible object.

(Inherited from AccessibleObject)
Name

Gets the name of the DataGridViewCell.DataGridViewCellAccessibleObject.

Owner

Gets or sets the cell that owns the DataGridViewCell.DataGridViewCellAccessibleObject.

Parent

Gets the parent of the DataGridViewCell.DataGridViewCellAccessibleObject.

Role

Gets the role of the DataGridViewCell.DataGridViewCellAccessibleObject.

State

Gets the state of the DataGridViewCell.DataGridViewCellAccessibleObject.

Value

Gets or sets a string representing the formatted value of the owning cell.

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 the DataGridViewCell.DataGridViewCellAccessibleObject.

Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetChild(Int32)

Returns the accessible object corresponding to the specified index.

GetChildCount()

Returns the number of children that belong to the DataGridViewCell.DataGridViewCellAccessibleObject.

GetFocused()

Returns the child accessible object that has keyboard focus.

GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetHelpTopic(String)

Gets an identifier for a Help topic identifier and the path to the Help file associated with this accessible object.

(Inherited from AccessibleObject)
GetLifetimeService()

Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetSelected()

Returns the child accessible object that is currently selected.

GetType()

Gets the Type of the current instance.

(Inherited from Object)
HitTest(Int32, Int32)

Retrieves the child object at the specified screen coordinates.

(Inherited from AccessibleObject)
InitializeLifetimeService()

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.

RaiseAutomationNotification(AutomationNotificationKind, AutomationNotificationProcessing, String)

Raises the UI automation notification event.

(Inherited from AccessibleObject)
RaiseLiveRegionChanged()

Raises the LiveRegionChanged UI automation event.

(Inherited from AccessibleObject)
Select(AccessibleSelection)

Modifies the selection or moves the keyboard focus of the accessible object.

ToString()

Returns a string that represents the current object.

(Inherited from Object)
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)
IAccessible.get_accChild(Object)

Retrieves a specified child object.

(Inherited from AccessibleObject)
IAccessible.get_accDefaultAction(Object)

Returns a string that indicates the specified object's default action.

(Inherited from AccessibleObject)
IAccessible.get_accDescription(Object)

Returns a string that describes the visual appearance of the specified accessible object.

(Inherited from AccessibleObject)
IAccessible.get_accHelp(Object)

Retrieves the full path of the WinHelp file that is associated with the specified accessible object.

(Inherited from AccessibleObject)
IAccessible.get_accHelpTopic(String, Object)

Retrieves the full path of a WinHelp file that is associated with the specified object along with the identifier of a specific topic in the file.

(Inherited from AccessibleObject)
IAccessible.get_accKeyboardShortcut(Object)

Retrieves the specified object's keyboard shortcut or access key.

(Inherited from AccessibleObject)
IAccessible.get_accName(Object)

Retrieves the name of the specified object.

(Inherited from AccessibleObject)
IAccessible.get_accRole(Object)

Retrieves information that describes the role of the specified object.

(Inherited from AccessibleObject)
IAccessible.get_accState(Object)

Retrieves the current state of the specified accessible object.

(Inherited from AccessibleObject)
IAccessible.get_accValue(Object)

Retrieves the value of the specified accessible object. Not all objects have a value.

(Inherited from AccessibleObject)
IAccessible.set_accName(Object, String)

Assigns a new accessible name to the specified element.

(Inherited from AccessibleObject)
IAccessible.set_accValue(Object, String)

Assigns a new value to the specified element.

(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)

Applies to

See also