This topic has not yet been rated - Rate this topic

DataGridViewCell.DataGridViewCellAccessibleObject Class

Provides information about a DataGridViewCell to accessibility client applications.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)
[ComVisibleAttribute(true)]
protected class DataGridViewCellAccessibleObject : AccessibleObject

The DataGridViewCell.DataGridViewCellAccessibleObject type exposes the following members.

  Name Description
Public method DataGridViewCell.DataGridViewCellAccessibleObject() Initializes a new instance of the DataGridViewCell.DataGridViewCellAccessibleObject class without initializing the Owner property.
Public method DataGridViewCell.DataGridViewCellAccessibleObject(DataGridViewCell) Initializes a new instance of the DataGridViewCell.DataGridViewCellAccessibleObject class, setting the Owner property to the specified DataGridViewCell.
Top
  Name Description
Public property Bounds Gets the location and size of the accessible object. (Overrides AccessibleObject.Bounds.)
Public property DefaultAction Gets a string that describes the default action of the DataGridViewCell. (Overrides AccessibleObject.DefaultAction.)
Public property Description Gets a string that describes the visual appearance of the specified object. Not all objects have a description. (Inherited from AccessibleObject.)
Public property Help Gets the names of the owning cell's type and base type. (Overrides AccessibleObject.Help.)
Public property KeyboardShortcut Gets the shortcut key or access key for the accessible object. (Inherited from AccessibleObject.)
Public property Name Gets the name of the DataGridViewCell.DataGridViewCellAccessibleObject. (Overrides AccessibleObject.Name.)
Public property Owner Gets or sets the cell that owns the DataGridViewCell.DataGridViewCellAccessibleObject.
Public property Parent Gets the parent of the DataGridViewCell.DataGridViewCellAccessibleObject. (Overrides AccessibleObject.Parent.)
Public property Role Gets the role of the DataGridViewCell.DataGridViewCellAccessibleObject. (Overrides AccessibleObject.Role.)
Public property State Gets the state of the DataGridViewCell.DataGridViewCellAccessibleObject. (Overrides AccessibleObject.State.)
Public property Value Gets or sets a string representing the formatted value of the owning cell. (Overrides AccessibleObject.Value.)
Top
  Name Description
Public method CreateObjRef Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject.)
Public method DoDefaultAction Performs the default action associated with the DataGridViewCell.DataGridViewCellAccessibleObject. (Overrides AccessibleObject.DoDefaultAction().)
Public method Equals(Object) Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected method Finalize Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public method GetChild Returns the accessible object corresponding to the specified index. (Overrides AccessibleObject.GetChild(Int32).)
Public method GetChildCount Returns the number of children that belong to the DataGridViewCell.DataGridViewCellAccessibleObject. (Overrides AccessibleObject.GetChildCount().)
Public method GetFocused Returns the child accessible object that has keyboard focus. (Overrides AccessibleObject.GetFocused().)
Public method GetHashCode Serves as a hash function for a particular type. (Inherited from Object.)
Public method GetHelpTopic Gets an identifier for a Help topic identifier and the path to the Help file associated with this accessible object. (Inherited from AccessibleObject.)
Public method GetLifetimeService Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
Public method GetSelected Returns the child accessible object that is currently selected. (Overrides AccessibleObject.GetSelected().)
Public method GetType Gets the Type of the current instance. (Inherited from Object.)
Public method HitTest Retrieves the child object at the specified screen coordinates. (Inherited from AccessibleObject.)
Public method InitializeLifetimeService Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
Protected method MemberwiseClone() Creates a shallow copy of the current Object. (Inherited from Object.)
Protected method MemberwiseClone(Boolean) Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject.)
Public method Navigate Navigates to another accessible object. (Overrides AccessibleObject.Navigate(AccessibleNavigation).)
Public method Select Modifies the selection or moves the keyboard focus of the accessible object. (Overrides AccessibleObject.Select(AccessibleSelection).)
Public method ToString Returns a string that represents the current object. (Inherited from Object.)
Protected method UseStdAccessibleObjects(IntPtr) Infrastructure. Associates an object with an instance of an AccessibleObject based on the handle of the object. (Inherited from AccessibleObject.)
Protected method UseStdAccessibleObjects(IntPtr, Int32) Infrastructure. Associates an object with an instance of an AccessibleObject based on the handle and the object id of the object. (Inherited from AccessibleObject.)
Top
  Name Description
Explicit interface implemetation Private property IAccessible.accChildCount Infrastructure. Gets the number of child interfaces that belong to this object. For a description of this member, see IAccessible.accChildCount. (Inherited from AccessibleObject.)
Explicit interface implemetation Private method IAccessible.accDoDefaultAction Infrastructure. Performs the specified object's default action. Not all objects have a default action. For a description of this member, see IAccessible.accDoDefaultAction. (Inherited from AccessibleObject.)
Explicit interface implemetation Private property IAccessible.accFocus Infrastructure. Gets the object that has the keyboard focus. For a description of this member, see IAccessible.accFocus. (Inherited from AccessibleObject.)
Explicit interface implemetation Private method IAccessible.accHitTest Infrastructure. Gets the child object at the specified screen coordinates. For a description of this member, see IAccessible.accHitTest. (Inherited from AccessibleObject.)
Explicit interface implemetation Private method IAccessible.accLocation Infrastructure. Gets the object's current screen location. For a description of this member, see IAccessible.accLocation. (Inherited from AccessibleObject.)
Explicit interface implemetation Private method IAccessible.accNavigate Infrastructure. Navigates to an accessible object relative to the current object. For a description of this member, see IAccessible.accNavigate. (Inherited from AccessibleObject.)
Explicit interface implemetation Private property IAccessible.accParent Infrastructure. Gets the parent accessible object of this object. For a description of this member, see IAccessible.accParent. (Inherited from AccessibleObject.)
Explicit interface implemetation Private method IAccessible.accSelect Infrastructure. Modifies the selection or moves the keyboard focus of the accessible object. For a description of this member, see IAccessible.accSelect. (Inherited from AccessibleObject.)
Explicit interface implemetation Private property IAccessible.accSelection Infrastructure. Gets the selected child objects of an accessible object. For a description of this member, see IAccessible.accSelection. (Inherited from AccessibleObject.)
Explicit interface implemetation Private method IReflect.GetField Infrastructure. Gets the System.Reflection.FieldInfo object corresponding to the specified field and binding flag. For a description of this member, see IReflect.GetField. (Inherited from AccessibleObject.)
Explicit interface implemetation Private method IReflect.GetFields Infrastructure. Gets an array of System.Reflection.FieldInfo objects corresponding to all fields of the current class. For a description of this member, see IReflect.GetFields. (Inherited from AccessibleObject.)
Explicit interface implemetation Private method IReflect.GetMember Infrastructure. Gets an array of System.Reflection.MemberInfo objects corresponding to all public members or to all members that match a specified name. For a description of this member, see IReflect.GetMember. (Inherited from AccessibleObject.)
Explicit interface implemetation Private method IReflect.GetMembers Infrastructure. Gets an array of System.Reflection.MemberInfo objects corresponding either to all public members or to all members of the current class. For a description of this member, see IReflect.GetMembers. (Inherited from AccessibleObject.)
Explicit interface implemetation Private method IReflect.GetMethod(String, BindingFlags) Infrastructure. Gets a System.Reflection.MethodInfo object corresponding to a specified method under specified search constraints. For a description of this member, see IReflect.GetMethod. (Inherited from AccessibleObject.)
Explicit interface implemetation Private method IReflect.GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[]) Infrastructure. Gets a System.Reflection.MethodInfo object corresponding to a specified method, using a Type array to choose from among overloaded methods. For a description of this member, see IReflect.GetMethod. (Inherited from AccessibleObject.)
Explicit interface implemetation Private method IReflect.GetMethods Infrastructure. Gets an array of System.Reflection.MethodInfo objects with all public methods or all methods of the current class. For a description of this member, see IReflect.GetMethods. (Inherited from AccessibleObject.)
Explicit interface implemetation Private method IReflect.GetProperties Infrastructure. Gets an array of System.Reflection.PropertyInfo objects corresponding to all public properties or to all properties of the current class. For a description of this member, see IReflect.GetProperties. (Inherited from AccessibleObject.)
Explicit interface implemetation Private method IReflect.GetProperty(String, BindingFlags) Infrastructure. Gets a System.Reflection.PropertyInfo object corresponding to a specified property under specified search constraints. For a description of this member, see IReflect.GetProperty. (Inherited from AccessibleObject.)
Explicit interface implemetation Private method IReflect.GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[]) Infrastructure. Gets a System.Reflection.PropertyInfo object corresponding to a specified property with specified search constraints. For a description of this member, see IReflect.GetProperty. (Inherited from AccessibleObject.)
Explicit interface implemetation Private method IReflect.InvokeMember Infrastructure. Invokes a specified member. For a description of this member, see IReflect.InvokeMember. (Inherited from AccessibleObject.)
Explicit interface implemetation Private property IReflect.UnderlyingSystemType Infrastructure. Gets the underlying type that represents the IReflect object. For a description of this member, see IReflect.UnderlyingSystemType. (Inherited from AccessibleObject.)
Top

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 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 http://msdn.microsoft.com/library.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ