Redigera

Dela via


DataGridView.DataGridViewAccessibleObject Class

Definition

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.ControlAccessibleObject
protected class DataGridView.DataGridViewAccessibleObject : System.Windows.Forms.Control.ControlAccessibleObject
Protected Class DataGridView.DataGridViewAccessibleObject
Inherits Control.ControlAccessibleObject
Inheritance
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, 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)
NotifyClients(AccessibleEvents, Int32)

Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control.

(Inherited from Control.ControlAccessibleObject)
NotifyClients(AccessibleEvents)

Notifies accessibility client applications of the specified AccessibleEvents.

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

Associates an object with an instance of an AccessibleObject based on the handle and the object id of the object.

(Inherited from AccessibleObject)
UseStdAccessibleObjects(IntPtr)

Associates an object with an instance of an AccessibleObject based on the handle 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, 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.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.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, 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.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.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