Open a form based upon its unique FormKey.

<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>

Syntax

ISForms.Open(formKey, [id], [page], [gotoRecord], [avoidForm], [deferMain], [alwaysAttemptReuse], [forceNew], [pseudoModalParent], [applicationShortcut], [forcePseudoModalParent], [otherArgs])

Parameters

NameTypeOptionalByRefDescription
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.

Return Value

ISFormBase

The opened ISForm or Nothing.

Member of:
ISForms
Namespace:
Intersoft.ISUserInterface6
Assembly:
ISUserInterface6, Version=6.0.3
Target Framework:
.NET 9.0