<para> Depending on the type of form and whether the form is already open, this may simply activate an existing form. </para> <para> Menu permission keys are taken into account. </para>
| Name | Type | Optional | ByRef | Description |
|---|---|---|---|---|
| formKey | String | The FormKey of the Form to open. | ||
| id | String | Optional | The Id of the record to view or '*' if you want to ensure that the form is only opened if it is not currently in use i.e. Adding, Editing or Viewing a record. | |
| page | String | Optional | The caption of the page to switch to (can contain an '*' wildcard, e.g. 'Logs*'). | |
| gotoRecord | Boolean | Optional | Indicates whether to Go To the record specified in Id. If False then the Id will simply be used to ensure multiple Forms with the same record (E.g. a Client Log) are not opened. If omitted, a value of True is assumed. | |
| avoidForm | ISFormBase | Optional | When a form, e.g. Clients can be opened multiple times, it may be desirable to specify not to open a new record in this Form. If this is the case then specify the opening Form. If omitted, a value of Nothing is assumed. | |
| deferMain | Boolean | Optional | Indicates whether to Defer calling the Main method of a Form if applicable. This gives the opener the chance to call the Main method itself which may be useful, e.g. for passing across extra information. If omitted, a value of False is assumed. | |
| alwaysAttemptReuse | Boolean | Optional | Indicates wether to always attempt to resuse an existing instance of this Form. If omitted, a value of False is assumed. | |
| forceNew | Boolean | Optional | Indicates whether to never attempt to reuse and existing instance of this Form and Force a New instance to be opened. If omitted, a value of False is assumed. | |
| pseudoModalParent | ISFormBase | Optional | The Pseudo-Modal parent. This must be used in conjunction with 'forceNew'. If omitted, a value of Nothing is assumed. | |
| applicationShortcut | ISApplicationShortcut | Optional | If omitted, a value of Nothing is assumed. | |
| forcePseudoModalParent | Boolean | Optional | If omitted, a value of False is assumed. | |
| otherArgs | ISKeyValueList | Optional | If omitted, a value of Nothing is assumed. |
The opened ISForm or Nothing.