Action Tab (FormManager Properties Dialog Box)

See Also      Tasks

Sets options for the FormManager design-time control that define the actions that will move the form from one mode to another, and the actions that occur before each transition.

For the FormManager control, you can define the different transitions that the form will make (for example, from Browse mode to Edit mode) and the events that cause them (for example, a button's onclick event). For each transition, you may specify one or more actions (property settings or method calls) that will happen before the mode transition occurs.

Options

Form Mode Transitions

These settings determine how the user will move from one form mode to another. When you design the form, you determine when mode transitions occur by selecting an object on the form and an event for that object (for example, a button's onclick event). When the user triggers this event; for example, by clicking the button on the form, the mode transition occurs. The settings in this field determine which control events cause which transitions.

Current Mode

Select the name of a mode you've defined for the form.

Object

Select the name of a control on the form you want to use to change modes. For example, on a data entry form, you might want the New button to move you from Edit mode to Insert mode.

Event

Select the control event you want to use to move from mode to mode. For example, you might select the onclick event of a button on the form.

Next Mode

Select the name of the mode you want to move to when the control event occurs.

Actions Performed Before Transition

These settings determine what action happens when a control event occurs that changes modes, but before the mode actually changes. For example, when you press an Update button, you typically want to update the data in your recordset (using the updateRecord method) before you change modes. These settings are enabled when you've selected a mode in the Form Mode Transitions grid, and apply to that mode.

Object

Select a control on the form.

Member

Select the property whose value you want to set or the method you want to run for this form mode.

Value

Enter the value you want to use for the property setting. You can enter a text value up to 255 characters, or use an expression to set this property. For methods, enter any parameters for the method within the parentheses.

If you're setting a property, the Value field will show <value>. Replace this with the property setting. If the setting is a string, use quotation marks.

If you're running a method, the Value field will show empty parentheses. Put any parameters for the method inside the parentheses. In the drop-down list in the Member field, the methods are listed with their parameters.

Note   The property settings and parameters you enter in the Value field are case-sensitive. For example, to set a property to true or false, you must enter true or false, not True or False.