NewGizmo

NewGizmo [ /FG=(gLeft, gTop, gRight, gBottom) /HOST=hcSpec /I /N=name /T=titleStr /K=k /W=(left,top,right,bottom)]

The NewGizmo operation creates a new Gizmo display window.

Flags

/FG=(gLeft, gTop, gRight, gBottom )
	Specifies the frame guide to which the outer frame of the subwindow is attached inside the host window.
	The standard frame guide names are FL, FR, FT, and FB for the left, right, top, and bottom frame guides, respectively, or user-defined guide names as defined by the host. Use * to specify a default guide name.
	Guides may override the numeric positioning set by /W.
/HOST=hcSpec	Embeds the new Gizmo in the host window or subwindow specified by hcSpec.
	When identifying a subwindow with hcSpec, see Subwindow Syntax for details on forming the window hierarchy.
/I	Opens the info window.
	The info window may be opened by default if that option is set in Gizmo section of the Miscellaneous Settings dialog.
/K=k	Specifies window behavior when the user attempts to close it.
	k =0: Normal with dialog (default) k =1: Kills without dialog k =2: Disables killing k =3: Hides the window k =4: Kills with no dialog and is not saved with the experiment.
	If you use /K=2 or /K=3, you can still kill the window using the KillWindow operation.
/N=name	Requests that the created Gizmo window have the specified name, if it is not in use. If it is in use, then name0, name1, etc. are tried until an unused window name is found. In a function or macro, the output string variable S_name is set to the chosen window name.
	A function or macro with the same name will cause a name conflict.
/T=titleStr	titleStr is a string expression containing the title of the new Gizmo window.
/W=(left,top,right,bottom)
	Sets the initial coordinates of the Gizmo window in points. The coordinates may be clipped depending on the dimensions of the connected display.
	When used with the /HOST flag, the specified location coordinates can have one of two possible meanings:
	1. When all values are less than 1, coordinates are assumed to be fractional relative to the host frame size. 2. When any value is greater than 1, coordinates are taken to be fixed locations measured in points, or control panel units for control panel hosts, relative to the top left corner of the host frame. When the subwindow position is fully specified using guides (using the /HOST or /FG flags), the /W flag may still be used although it is not needed.

Details

The NewGizmo operation will fail if the graphics hardware or drivers are incompatible with Gizmo. In some cases this problem can be resolved by updating the graphics drivers.

See Also

3D Graphics, AppendToGizmo, ExportGizmo, GetGizmo, GizmoInfo, ModifyGizmo, RemoveFromGizmo