AcceptButton Property

Applies To
Form

Description
Gets or sets the button on the form that is clicked when the user presses the ENTER key.

Usage

GGet Form.AcceptButton, var  
GSet  Form.AcceptButton, value  

Form

Name of a form or string variable containing a form name.

var

String variable that will contain the value of the property.

value

String expression for the new value of the property.

Values
The name of any button on the form.
Default: None

Remarks
This property allows you to designate a default action to occur when the user presses the ENTER key in your application. The button assigned to this property must be a Button that is on the current form or located within a container on the current form.
You can use this property to allow the user to quickly navigate a simple form by allowing them to simply press the ENTER key when they are finished instead of manually clicking the accept button with their mouse.
The accept button might not be activated if the currently selected control on the form intercepts the ENTER key and processes it. For example, a multiline text box control allows the ENTER key to be pressed when it is selected to insert a new line character in the control.

See Also
Form, Button, CancelButton

Example

GSet frmMain.AcceptButton, "btnOK"