Bewerken

Delen via


DataGridView.DataGridViewTopRowAccessibleObject Class

Definition

Provides information about a row of DataGridViewColumnHeaderCell objects to accessibility client applications.

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

Remarks

Windows Forms includes built-in accessibility support that allows your program 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 DataGridView.DataGridViewTopRowAccessibleObject class inherits from the AccessibleObject class to provide information about a row of DataGridViewColumnHeaderCell objects 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

DataGridView.DataGridViewTopRowAccessibleObject()

Initializes a new instance of the DataGridView.DataGridViewTopRowAccessibleObject class without setting the Owner property.

DataGridView.DataGridViewTopRowAccessibleObject(DataGridView)

Initializes a new instance of the DataGridView.DataGridViewTopRowAccessibleObject class, setting the Owner property to the specified value.

Properties

Bounds

Gets the location and size of the accessible object.

DefaultAction

Gets a string that describes the default action of the object. Not all objects have a default action.

(Inherited from AccessibleObject)
Description

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

(Inherited from AccessibleObject)
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 accessible object.

Owner

Gets the DataGridView that contains the row of column headers.

Parent

Gets the parent of the DataGridView.DataGridViewTopRowAccessibleObject.

Role

Gets the role of the accessible object.

State

Gets the state of this accessible object.

(Inherited from AccessibleObject)
Value

Gets the value of an accessible object.

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 children belonging to the accessible object.

GetFocused()

Retrieves the object that has the keyboard focus.

(Inherited from AccessibleObject)
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()

Retrieves the currently selected child.

(Inherited from AccessibleObject)
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.

(Inherited from AccessibleObject)
ToString()

Returns a string that represents the current object.

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