Default Button (Magic xpa 4.x)
For forms that have numerous Push Button controls, it is advantageous to be able to designate a single button, such as OK, Next, or Finish, to be the default button that is pressed when the user presses the Enter key. For example, if the form is being designed as a wizard, you may decide that when the Enter key is pressed, the Next button is activated.
This property lets you specify the Default Button by selecting a Push Button control name for a task from the Control list. This list contains the names of Push Button controls that have a value set in the Event property. You can also specify an expression that determines the control name at runtime.
During runtime, if a push button is evaluated as the Default Button, it is displayed with a black border around the button, 1 pixel wide.
The Default Button property is ignored when the following behavior occurs:
-
When the end user is parked in an RTF Edit control or a Multi-line Edit control where the Enter key is used to insert data, the Default Button property is ignored.
-
If the control specified by the control name in the Default Button property evaluates to either a non-existent control or one that is not a push button, the property is ignored, and there is no default button.
-
If the control name entered in the Default Button property is used for more than one control, the control name for the Push Button control is activated. If more than one push button has the same control name, the first push button in the Z-order is activated.
-
If the Selection Table evaluates to Yes, the Default Button property takes precedence.
Note: In a program set to be a Selection table, if you set the default push button to raise the Select event, when you press Enter the default push button is not activated and the Select event is directly triggered by the Enter key as though you had not defined a default push button. This results in slightly modified behavior by which the flow will not reach the default push button as it does in other programs.
How Do I Set a Default Push Button for the Form?