AccessibleObject.DefaultAction Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets a string that describes the default action of the object. Not all objects have a default action.
public:
virtual property System::String ^ DefaultAction { System::String ^ get(); };public virtual string DefaultAction { get; }public virtual string? DefaultAction { get; }member this.DefaultAction : stringPublic Overridable ReadOnly Property DefaultAction As StringProperty Value
A description of the default action for an object, or null if this object has no default action.
Exceptions
The default action for the control cannot be retrieved.
Remarks
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.
