|Opens a screen file with various options.|
|Syntax:||Set GefScreen = object.OpenEx ( OpenType, FileName, Project, Visible, ParentScreen, ObjectToEdit, VariableValues )|
OpenType As GefOpenTypeEnum - The type of open to perform.
FileName As String - The name of the screen to open. If this is a relative pathname, it is qualified by the DefaultFilePath.
Project As String - If specified, determines the project used to qualify unqualified point IDs in the screen.
Visible As Boolean - If specified as False, the screen will be opened but will not be displayed. Use the Visible property of the GefScreen to change the visibility. The default is True.
ParentScreen As GefScreen - The screen that this new screen will be captive to. No input will be allowed in the parent screen until the new screen is closed. This is used only for the modal open types: gefOpenTypeModalChild and gefOpenTypeModalDialog. You may specify an object set to Nothing if it is not needed.
ObjectToEdit As GefObject - If specified, this is the object that is being "edited" by the new screen. "Edited" means that it will receive the values from the public variables on the screen object. This is used only for the gefOpenTypeModalDialog open type. You may specify an object set to Nothing if it is not needed.
VariableValues As VARIANT - A CoCimSafeArray3 array of initial variable values for the newly opened screen. (Note: In VBScript and VBA/VB, you can use a native array of strings.)
|Description:||For dialog windows, the object that is being
edited is defined as GefScreen.ObjectToEdit on the
popup screen. The variables on the ObjectToEdit will be
exchanged with the public variables on the screen. If the
ObjectToEdit parameter is missing then no values will be
brought back to the parent screen. Note: GefScreen.CloseEx must be used to
close dialog windows.
The VariableValues parameter is a String array containing the initial values of variables in the new screen. If
This array may also be dimensioned as
in which case