System.Windows.Forms
1.0.5000.0
2.0.0.0
System.Runtime.InteropServices.StandardOleMarshalObject
Accessibility.IAccessible
System.Reflection.IReflect
System.Runtime.InteropServices.ComVisible(true)
Accessibility applications can adjust features of the application to improve usability for users with disabilities.
For users who are visually impaired, you can adjust software and operating system features to comply with their needs. For example, you can enlarge text and images and render them with a contrast. In addition, you can accommodate color-blindness with the appropriate use of colors. For users who are severely visually impaired, computers are accessible with screen review aids that translate on-screen text to speech or to a dynamic, refreshable, Braille display.
For users who are hard of hearing, you can design programs that use visual cues, such as a flashing toolbar; or you can display spoken messages as text. For example, when turned on, the SoundSentry feature, an accessibility option in Control Panel, provides a visual warning whenever the system makes an alarm sound.
For users with motion disabilities, you can design controls that refine or eliminate keyboard and mouse use, thereby improving computer accessibility. Control Panel offers assistance. For example, one alternative is to use the numeric keypad instead of the mouse for navigation. Another option, called StickyKeys, enables users who cannot hold down two or more keys at a time (such as CTRL+P) to get the same result by typing one key at a time.
For users with cognitive and language disabilities, you can design software programs to better accommodate their needs. For example, using conspicuous or cued sequencing, uncomplicated displays, fewer words, and a reading level targeted to elementary school standards can benefit these users.
For users with seizure disorders, you can design software programs to eliminate seizure provoking patterns.
For more information about accessibility, including information about accessibility applications, see the documentation for Microsoft Accessibility in the MSDN library or at the Microsoft Web site.
To use the , you must add a reference to the Accessibility assembly installed with the dnprdnshort. Windows Forms only supports Active Accessibility 2.0.
Provides information that accessibility applications use to adjust an application's user interface (UI) for users with impairments.
Constructor
Typically, when you use this method to create an accessible object, you are providing your own implementations of the properties and methods of the class to provide functionality specific to your application.
Initializes a new instance of the class.
1.0.5000.0
2.0.0.0
Property
1.0.5000.0
2.0.0.0
System.Int32
To be added.
This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.
Gets the number of child interfaces that belong to this object. For a description of this member, see .
Method
1.0.5000.0
2.0.0.0
System.Void
This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.
Performs the specified object's default action. Not all objects have a default action. For a description of this member, see .
The child ID in the interface/child ID pair that represents the accessible object.
Property
1.0.5000.0
2.0.0.0
System.Object
To be added.
The return value type of the property depends on the object that has keyboard focus. The following table describes the object types that the property returns.
-
Type
Description
-
null
This object does not have the keyboard focus itself and does not contain a child that has the keyboard focus.
-
integer
0 if the current object has keyboard focus; otherwise, the child ID of the child accessible object with keyboard focus.
-
The child accessible object that has the keyboard focus.
This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.
Gets the object that has the keyboard focus. For a description of this member, see .
Method
1.0.5000.0
2.0.0.0
System.Object
The following table describes the object types that the method can return.
-
Type
Description
-
The accessible object at the specified direction.
-
integer
0 if the point specified is either the current object or outside the object’s boundaries; otherwise, the child ID that identifies the accessible object at the specified direction.
This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.
Gets the child object at the specified screen coordinates. For a description of this member, see .
The accessible object at the point specified by and .
The horizontal coordinate.
The vertical coordinate.
Method
1.0.5000.0
2.0.0.0
System.Void
To be added.
To be added.
To be added.
To be added.
To be added.
To be added.
To be added.
Method
1.0.5000.0
2.0.0.0
System.Object
The following table describes the object types that the method can return.
-
Type
Description
-
null
There is not an accessible object at the specified direction.
-
The accessible object at the specified direction.
-
integer
The child ID that identifies the accessible object at the specified direction. Use the parent and the child ID to access the accessible object.
This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.
Navigates to an accessible object relative to the current object. For a description of this member, see .
The accessible object positioned at the value specified by .
One of the enumerations that specifies the direction to navigate.
The ID number of the accessible object. This parameter is 0 to start from the object, or a child ID to start from one of the object's child objects.
Property
1.0.5000.0
2.0.0.0
System.Object
To be added.
This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface..
Gets the parent accessible object of this object. For a description of this member, see .
Method
1.0.5000.0
2.0.0.0
System.Void
The following describes which values to specify when calling Select to perform complex selection operations.
-
Operation
Flag Combination
-
To simulate a click
OR
-
To select a target item by simulating CTRL+click
OR
-
To cancel selection of a target item by simulating CTRL+click
OR
-
To simulate SHIFT+click
OR
-
To select a range of objects and put focus on the last object
Specify on the starting object to set the selection anchor. Then call Select again and specify OR on the last object.
-
To deselect all objects
Specify on any object. This flag deselects all selected objects except the one just selected. Then call Select again and specify on the same object.
This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.
Modifies the selection or moves the keyboard focus of the accessible object. For a description of this member, see .
A bitwise combination of the values.
The ID number of the accessible object on which to perform the selection. This parameter is 0 to select the object, or a child ID to select one of the object's child objects.
Property
1.0.5000.0
2.0.0.0
System.Object
To be added.
The following table describes the object types that the property returns
-
Type
Description
-
null
No child objects are selected.
-
The child accessible object that is selected.
-
integer
The child ID that identifies the accessible object that is selected. Use the parent and the child ID to access the accessible object.
-
IEnumVARIANT
A list of child objects that are selected.
This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.
Gets the selected child objects of an accessible object. For a description of this member, see .
Method
1.0.5000.0
2.0.0.0
System.Object
To be added.
To be added.
To be added.
To be added.
Method
1.0.5000.0
2.0.0.0
System.String
To be added.
To be added.
To be added.
To be added.
Method
1.0.5000.0
2.0.0.0
System.String
To be added.
To be added.
To be added.
To be added.
Method
1.0.5000.0
2.0.0.0
System.String
To be added.
To be added.
To be added.
To be added.
Method
1.0.5000.0
2.0.0.0
System.Int32
To be added.
To be added.
To be added.
To be added.
To be added.
Method
1.0.5000.0
2.0.0.0
System.String
To be added.
To be added.
To be added.
To be added.
Method
1.0.5000.0
2.0.0.0
System.String
To be added.
To be added.
To be added.
To be added.
Method
1.0.5000.0
2.0.0.0
System.Object
To be added.
To be added.
To be added.
To be added.
Method
1.0.5000.0
2.0.0.0
System.Object
To be added.
To be added.
To be added.
To be added.
Method
1.0.5000.0
2.0.0.0
System.String
To be added.
To be added.
To be added.
To be added.
Method
1.0.5000.0
2.0.0.0
System.Void
To be added.
To be added.
To be added.
To be added.
Method
1.0.5000.0
2.0.0.0
System.Void
To be added.
To be added.
To be added.
To be added.
Property
System.Drawing.Rectangle
To be added.
The property retrieves the object's bounding rectangle in screen coordinates. If the object has a nonrectangular shape, then this property represents the smallest rectangle that completely encompasses the entire object region. Therefore, for nonrectangular objects such as list view items, the coordinates of the object's bounding rectangle can fail, if tested, by calling the method, because determines the object's boundaries on a pixel-by-pixel basis.
Gets the location and size of the accessible object.
1.0.5000.0
2.0.0.0
Property
System.String
To be added.
The string describes the action that is performed on an object, not what the object does as a result. That is, a toolbar button that prints a document has a default action of "Press" rather than "Prints the current document." Do not confuse an object's default action with its value.
Gets a string that describes the default action of the object. Not all objects have a default action.
1.0.5000.0
2.0.0.0
Property
System.String
To be added.
This property describes the object's visual appearance to the user.
Gets a string that describes the visual appearance of the specified object. Not all objects have a description.
1.0.5000.0
2.0.0.0
Method
System.Void
Clients can retrieve the object's default action by inspecting an object's property. A client can use automation (if supported) instead of to perform an object's default action. However, provides an easy way to perform an object's most commonly used action.
Performs the default action associated with this accessible object.
1.0.5000.0
2.0.0.0
Method
System.Windows.Forms.AccessibleObject
To be added.
Retrieves the accessible child corresponding to the specified index.
An that represents the accessible child corresponding to the specified index.
The zero-based index of the accessible child.
1.0.5000.0
2.0.0.0
Method
System.Int32
To be added.
Retrieves the number of children belonging to an accessible object.
The number of children belonging to an accessible object.
1.0.5000.0
2.0.0.0
Method
System.Windows.Forms.AccessibleObject
The concept of keyboard focus is related to that of an active window. An active window is the foreground window in which the user is working. The object with the keyboard focus is either the active window or a child object of the active window.
Only one object or item within a container can have the focus at any one time. The object with the keyboard focus is not necessarily the selected object.
Retrieves the object that has the keyboard focus.
An that specifies the currently focused child. This method returns the calling object if the object itself is focused. Returns null if no object has focus.
1.0.5000.0
2.0.0.0
Method
System.Int32
To be added.
To be added.
To be added.
To be added.
1.0.5000.0
2.0.0.0
Method
System.Windows.Forms.AccessibleObject
To be added.
Retrieves the currently selected child.
An that represents the currently selected child. This method returns the calling object if the object itself is selected. Returns null if is no child is currently selected and the object itself does not have focus.
1.0.5000.0
2.0.0.0
Property
System.String
To be added.
To be added.
Gets a description of what the object does or how the object is used.
1.0.5000.0
2.0.0.0
Method
System.Windows.Forms.AccessibleObject
For nonrectangular objects such as list view items, the coordinates of the object's bounding rectangle retrieved by can fail if tested with , because determines the object's boundaries on a pixel-by-pixel basis.
Retrieves the child object at the specified screen coordinates.
An that represents the child object at the given screen coordinates. This method returns the calling object if the object itself is at the location specified. Returns null if no object is at the tested location.
The horizontal screen coordinate.
The vertical screen coordinate.
1.0.5000.0
2.0.0.0
Property
System.String
To be added.
An access key, also known as a mnemonic, is an underlined character in the text of a menu, menu item, label of a button, or some other control. For example, a user can display a menu by pressing the ALT key while also pressing the indicated underlined key, such as ALT+F, to open the File menu. To use the access key of a menu item, the menu containing the item must be active. Controls such as toolbar buttons and menu items often have an associated shortcut key. A menu item can have both an access key and a shortcut key associated with it. If the value of the property is a single character, you can assume it is an access key.
Gets the shortcut key or access key for the accessible object.
1.0.5000.0
2.0.0.0
Property
System.String
To be added.
The property is a string used by clients to identify, find, or announce an object for the user. To access the name of a child object, you must first call with the index of the child whose name you are retrieving.
Gets or sets the object name.
1.0.5000.0
2.0.0.0
Method
System.Windows.Forms.AccessibleObject
Navigation, both spatial and logical, is always restricted to the user interface elements within a container. With spatial navigation, clients can navigate only to a sibling of the starting object. Depending on the navigational flag used with logical navigation, clients can navigate to either a child or to a sibling of the starting object. This method does not change the selection or focus. To change the focus or to select an object, use . The method retrieves only user interface elements that have a defined screen location.
Navigates to another accessible object.
An that represents one of the values.
One of the values.
1.0.5000.0
2.0.0.0
Property
System.Windows.Forms.AccessibleObject
To be added.
To be added.
Gets the parent of an accessible object.
1.0.5000.0
2.0.0.0
Property
System.Windows.Forms.AccessibleRole
To be added.
The role of the object helps describe the function of the object.
Gets the role of this accessible object.
1.0.5000.0
2.0.0.0
Method
System.Void
Applications can use this method to perform complex selection operations.
The following describes which values to specify when calling to perform complex selection operations.
-
Operation
Flag Combination
-
To simulate a click
OR
This combination will not select the desired control if called from within your own application. It will have the desired effect, however, if called from an external application.
-
To select a target item by simulating CTRL + click
OR
-
To cancel selection of a target item by simulating CTRL + click
OR
-
To simulate SHIFT + click
OR
-
To select a range of objects and put focus on the last object
Specify on the starting object to set the selection anchor. Then call again and specify OR on the last object.
-
To deselect all objects
Specify on any object. This flag deselects all selected objects except the one just selected. Then call again and specify on the same object.
Modifies the selection or moves the keyboard focus of the accessible object.
One of the values.
1.0.5000.0
2.0.0.0
Property
System.Windows.Forms.AccessibleStates
To be added.
To be added.
Gets the state of this accessible object.
1.0.5000.0
2.0.0.0
Method
1.0.5000.0
2.0.0.0
System.Reflection.FieldInfo
This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.
Gets the object corresponding to the specified field and binding flag. For a description of this member, see .
A object containing the field information for the named object that meets the search constraints specified in .
The name of the field to find.
The binding attributes used to control the search.
Method
1.0.5000.0
2.0.0.0
System.Reflection.FieldInfo[]
Each field must have a unique name. The flag specifies that nonpublic fields are included in the search. The flag specifies that public fields are included in the search.
This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.
Gets an array of objects corresponding to all fields of the current class. For a description of this member, see .
An array of objects containing all the field information for this reflection object that meets the search constraints specified in .
The binding attributes used to control the search.
Method
1.0.5000.0
2.0.0.0
System.Reflection.MemberInfo[]
This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.
Gets an array of objects corresponding to all public members or to all members that match a specified name. For a description of this member, see .
An array of objects matching the name parameter.
The name of the member to find.
The binding attributes used to control the search.
Method
1.0.5000.0
2.0.0.0
System.Reflection.MemberInfo[]
This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.
Gets an array of objects corresponding either to all public members or to all members of the current class. For a description of this member, see .
An array of objects containing all the member information for this reflection object.
The binding attributes used to control the search.
Method
1.0.5000.0
2.0.0.0
System.Reflection.MethodInfo
This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.
Gets a object corresponding to a specified method under specified search constraints. For a description of this member, see .
A object containing the method information, with the match being based on the method name and search constraints specified in .
The name of the member to find.
The binding attributes used to control the search.
Method
1.0.5000.0
2.0.0.0
System.Reflection.MethodInfo
The return value is a match based on the method name, the enumeration, the kind of type conversion specified by the parameter, the overload, and the that describes the signature of the method.
This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.
Gets a object corresponding to a specified method, using a Type array to choose from among overloaded methods. For a description of this member, see .
The requested method that matches all the specified parameters.
The name of the member to find.
The binding attributes used to control the search.
An object that implements , containing properties related to this method.
An array used to choose among overloaded methods.
An array of parameter modifiers used to make binding work with parameter signatures in which the types have been modified.
Method
1.0.5000.0
2.0.0.0
System.Reflection.MethodInfo[]
This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.
Gets an array of objects with all public methods or all methods of the current class. For a description of this member, see .
An array of objects containing all the methods defined for this reflection object that meet the search constraints specified in bindingAttr.
The binding attributes used to control the search.
Method
1.0.5000.0
2.0.0.0
System.Reflection.PropertyInfo[]
This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.
Gets an array of objects corresponding to all public properties or to all properties of the current class. For a description of this member, see .
An array of objects for all the properties defined on the reflection object.
The binding attribute used to control the search.
Method
1.0.5000.0
2.0.0.0
System.Reflection.PropertyInfo
This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.
Gets a object corresponding to a specified property under specified search constraints. For a description of this member, see .
A object for the located property that meets the search constraints specified in , or null if the property was not located.
The name of the property to find.
The binding attributes used to control the search.
Method
1.0.5000.0
2.0.0.0
System.Reflection.PropertyInfo
This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.
Gets a object corresponding to a specified property with specified search constraints. For a description of this member, see .
A object for the located property, if a property with the specified name was located in this reflection object, or null if the property was not located.
The name of the member to find.
The binding attributes used to control the search.
An object that implements Binder, containing properties related to this method.
An array used to choose among overloaded methods.
An array of parameter modifiers used to make binding work with parameter signatures in which the types have been modified.
An array used to choose the parameter modifiers.
Method
1.0.5000.0
2.0.0.0
System.Object
The parameter may be a constructor, method, property, or field. A suitable invocation attribute must be specified. Invoke the default member of a class by passing the empty string ("") as the name of the member.
The parameter has the same length as the parameter, representing the invoked member's argument attributes in the metadata. A parameter can have the following attributes: pdIn, pdOut, pdRetval, pdOptional, and pdHasDefault. These represent [In], [Out], [retval], [optional], and a default parameter, respectively.
This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.
Invokes a specified member. For a description of this member, see .
The specified member.
The name of the member to find.
One of the invocation attributes.
One of the bit flags. Implements Binder, containing properties related to this method.
The object on which to invoke the specified member. This parameter is ignored for static members.
An array of objects that contains the number, order, and type of the parameters of the member to be invoked. This is an empty array if there are no parameters.
An array of objects.
An instance of used to govern the coercion of types.
A String array of parameters.
Property
1.0.5000.0
2.0.0.0
System.Type
To be added.
This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.
Gets the underlying type that represents the object. For a description of this member, see .
Method
System.Void
Server applications can call this function when they contain a custom UI object that is similar to a system-provided object. Server applications call CreateStdAccessibleObject and override the methods and properties as needed to match their custom object. This approach saves server developers the work of fully implementing all the properties and methods. This function is similar to CreateStdAccessibleProxy, except that CreateStdAccessibleProxy enables you to specify the class name as a parameter, whereas CreateStdAccessibleObject uses the class name associated with the hwnd.
Calling this version of the UseStdAccessible is the same as calling the two parameter version with an objid of CLIENT.
Associates an object with an instance of an based on the handle of the object.
An that contains the handle of the object.
1.0.5000.0
2.0.0.0
Method
System.Void
Creates an accessible object with the methods and properties for the specified type of system-provided user interface element.
Server applications can call this function when they contain a custom UI object that is similar to a system-provided object. Server applications call CreateStdAccessibleObject and override the methods and properties as needed to match their custom object. This approach saves server developers the work of fully implementing all the properties and methods.
Valid values.
-
Object
Value
Description
-
ALERT
0xFFFFFFF6
Refers to a message associated with a window or application.
-
CARET
0xFFFFFFF8
Refers to the text insertion bar (caret) in the window.
-
CLIENT
0xFFFFFFFC
Refers to the window's client area. In most cases, the operating system controls the frame elements, and the client object contains all elements that the application controls.
-
CURSOR
0xFFFFFFF7
Refers to the mouse pointer. There is only one mouse pointer in the system and it is not a child of a window.
-
HSCROLL
0xFFFFFFFA
Refers to the window's horizontal scroll bar.
-
MENU
0xFFFFFFFD
Refers to the window's menu bar.
-
SIZEGRIP
0xFFFFFFF9
Refers to the window's size grip, an optional frame component located at the lower right corner of the window frame.
-
SOUND
0xFFFFFFF5
Refers to a sound object. Sound objects do not have screen locations or children, but do have name and state attributes. They are children of the application playing the sound.
-
SYSMENU
0xFFFFFFFF
Refers to the window's system menu.
-
TITLEBAR
0xFFFFFFFE
Refers to the window's title bar.
-
VSCROLL
0xFFFFFFFB
Refers to the window's vertical scroll bar.
-
WINDOW
0x00000000
Refers to the window itself rather than to a child object.
Associates an object with an instance of an based on the handle and the object id of the object.
An that contains the handle of the object.
An Int that defines the type of object that the parameter refers to.
1.0.5000.0
2.0.0.0
Property
System.String
To be added.
Typically, the property represents visual information contained by the object. Not all objects support the property.
In most cases, the property is used to tell the client about what visual information an object contains. For example, the value for an edit control is the text it contains, but a menu item has no value.
The property can provide hierarchical information in cases such as a tree view control. Although the parent object in the tree view control does not provide information in the property, each item within the control has a zero-based value that represents its level within the hierarchy. Top-level items have a value of zero, second-level items have a value of one, and so on.
The values returned from scroll bar and trackbar accessible objects indicate percentages, so they are integers between 0 and 100, inclusive.
Gets or sets the value of an accessible object.
1.0.5000.0
2.0.0.0