Options Tab (Magic xpa 3.x)
Use the Options properties to specify which modes of operation will be available on the task menu, for the end user to set at runtime. Setting Options properties also determines which modes of operation are valid as the Initial Mode for the task.
You can either specify Yes or No for most of the Options properties, or assign them the number of a logical expression to be evaluated at runtime. This way, the property can be made dependent on the result of a condition expression. A condition expression that evaluates to True is equivalent to a Yes value in this column, and a condition expression evaluating to False is equivalent to a No value in this column.
|
Note:
|
If the Initial Mode setting for the task is disabled by the corresponding Options property, at runtime, Magic xpa issues an error message to that effect. When the end user exits the message box, the task will terminate.
|
|
|
|
|
Allowed Modes:
The default value for these properties is Yes.
|
|
Options
|
No means all end-user options will be disabled; the task will run using its Initial Mode and the end user will not be able to change it.
This option is available for Online tasks.
|
|
Modify
|
No means the Modify option will be disabled. When this property is set to No, you will still be able to modify newly created records.
See also How Do I Prevent the End User from Modifying Existing Records?
|
|
Create
|
No means the Create option will be disabled.
See also How Do I Prevent the End User from Adding New Records?
|
|
Delete
|
No means the Delete option will be disabled.
See also How Do I Prevent the End User from Deleting Existing Records?
|
|
Query
|
No means the Query option will be disabled.
|
|
Locate
|
No means the Locate option will be disabled and the Locate a Record event will not be raised. In Query Mode, the automatic locate mechanism will not operate.
This option is available for Online and interactive Rich Client tasks. The Locate a Record event is not handled by the engine. If the User Functionality component is loaded and the Locate a Record event is raised, the component will handle this event and open a locate screen. (Rich Client – Since version: 1.9, Online – Since version: 2.0)
See also End User Functionality Component.
|
|
Range
|
No means the Range option will be disabled and the Range of Records event will not be raised.
This option is available for Online and interactive Rich Client tasks. The Range of Records event is not handled by the engine. If the User Functionality component is loaded and the Range of Records event is raised, the component will handle this event and open a range screen. (Rich Client – Since version: 1.9, Online – Since version: 2.0)
See also End User Functionality Component.
|
|
Allowed end-user Functionalities:
The default value for these properties is Yes, except for the Print Data property.
|
|
Index Change
|
The property is not handled by the engine. (Rich Client – Since version: 1.0, Online – Since version: 2.0)
|
|
Sorting
|
No means the Sorting option will be disabled and the Sort Records event will not be raised.
This option is available for Online and interactive Rich Client tasks. The Sort Records event is not handled by the engine If the User Functionality component is loaded and the Sort Records event is raised, the component will handle this event and open a sort screen. (Rich Client – Since version: 1.9, Online – Since version: 2.0)
See also End User Functionality Component.
|
|
I/O Redirection
|
No means the end user will not be allowed to redirect input or output operating system text files.
The Redirect Files event is not handled by the engine. (Since version: 2.0)
|
|
Index Optimization
|
Magic xpa checks to determine which variables are explicitly specified in the Locate/Range mask to determine the optimal index for the search. If any of the specified variables is an Index variable, and if the currently active index is not one of the specified variables, Magic xpa automatically makes the active index the first index whose primary variable is explicitly specified in the Locate/Range mask. The primary variable can be the only variable in the index.
No means the Index Optimization mechanism will be disabled.
Database specific: Index optimization is not supported for local data sources.
|
|
Locate in Query
|
No means the automatic locate mechanism will not operate in Query mode.
This option is available for Online and interactive Rich Client tasks. (Rich Client support – Since version: 1.9)
|
|
Print Data
|
No means the Print Data option will be disabled and the Print Data event will not be raised.
This option is available for Online and interactive Rich Client tasks with a selected Main Source. The Print Data event is not handled by the engine. If the User Functionality component is loaded and the Print Data event is raised, the component will handle this event and open the Print Data wizard. (Rich Client – Since version: 1.9, Online – Since version: 2.0)
See also End User Functionality Component.
|
How Do I Prevent the End User from Changing the Task Modes?
