DataGridViewCell.DataGridViewCellAccessibleObject Class

Reference

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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 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 : System.Windows.Forms.AccessibleObject

Protected Class DataGridViewCell.DataGridViewCellAccessibleObject
Inherits AccessibleObject

Inheritance: Object

MarshalByRefObject

StandardOleMarshalObject

AccessibleObject
DataGridViewCell.DataGridViewCellAccessibleObject

Derived: System.Windows.Forms.DataGridViewButtonCell.DataGridViewButtonCellAccessibleObject

System.Windows.Forms.DataGridViewCheckBoxCell.DataGridViewCheckBoxCellAccessibleObject

System.Windows.Forms.DataGridViewColumnHeaderCell.DataGridViewColumnHeaderCellAccessibleObject

System.Windows.Forms.DataGridViewComboBoxCell.DataGridViewComboBoxCellAccessibleObject

System.Windows.Forms.DataGridViewImageCell.DataGridViewImageCellAccessibleObject

More…

Attributes: ComVisibleAttribute

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.

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.
Help	Gets a description of what the object does or how the object is used. (Inherited from AccessibleObject)
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()	Obsolete. 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()	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.
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)
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

Share via