AccessibleObject::DefaultAction Property
Gets a string that describes the default action of the object. Not all objects have a default action.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Property Value
Type: System::String^A description of the default action for an object, or null if this object has no default action.
| Exception | Condition |
|---|---|
| COMException | The default action for the control cannot be retrieved. |
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.
Notes to Inheritors:
The default implementation returns the accessible object's default action if the object wraps a system control that has a default action; otherwise, it returns null. Only controls that perform actions should support this method. Not all objects have default actions, and some objects might have a default action that is related to its Value property, such as in the following examples: A selected check box has a default action of "Uncheck" and a value of "Checked." A cleared check box has a default action of "Check" and a value of "Unchecked." A button labeled "Print" has a default action of "Press," with no value. A static text control or an edit control that shows "Printer" has no default action, but would have a value of "Printer." An object's DefaultAction property should be a verb or a short verb phrase.
Available since 1.1