CREATE SCREEN Command

Included for backward compatibility. Use CREATE FORM instead.

This command is undocumented in the original VFP9 help file,
but the following documentation was found in the FoxPro for Windows 2.6 help, and may still be valid:

Opens a Screen Design window.

CREATE SCREEN [file | ?]
	[NOWAIT] [SAVE]
	[[WINDOW window name1]
	[IN [WINDOW] window name2 
	| IN SCREEN | IN MACDESKTOP]]

Parameters

file
 Issuing CREATE SCREEN without any additional arguments opens a new Screen Design window. The name UNTITLED is assigned to the screen definition. When you exit the Screen Design window, you are prompted to save the screen definition with a different name.

 If a file name is included, the screen is saved under that name. An .SCX extension is automatically assigned. If a screen file with that name already exists, you are asked if you want to overwrite the existing file (if SET SAFETY is ON).

?
 The Open dialog appears when the question mark (?) is included. A list of existing screen files is displayed. Choose one of the existing screens or enter the name of a new screen to create.

NOWAIT
 When CREATE SCREEN is issued in a program, a Screen Design window is opened and program execution pauses until the Screen Design window is closed.

 The NOWAIT option continues program execution after the Screen Design window has been opened. The program doesn't wait for the Screen Design window to be closed, but continues execution on the program line immediately following the line that contains CREATE SCREEN NOWAIT. Including the NOWAIT option has no effect on the CREATE SCREEN command when it is issued in the Command window.

SAVE
 During program execution, SAVE leaves the Screen Design window open after another window is brought forward. Including the SAVE option has no effect when issued from the Command window.

 In FoxPro for MS-DOS, you can close a Screen Design window opened with the SAVE option by pressing Ctrl+W, Ctrl+End, Ctrl+Q or Esc, by clicking the close box or by choosing the Close option from the File menu.

 In FoxPro for Windows, you can close a Screen Design window opened with the SAVE option by pressing Ctrl+W, Ctrl+End or Esc, by clicking the close box or by choosing Close from the Screen Design window Control menu or the File menu.

 In FoxPro for Macintosh, you can close a Screen Design window opened with the SAVE option by pressing Ctrl+W, Ctrl+End or Esc, by clicking the close box or by choosing Close from the File menu.

WINDOW window name1
 If you include WINDOW window name1, the Screen Design window takes on the characteristics of the specified window. For example, if the window is created with the FLOAT option of DEFINE WINDOW, the Screen Design window can be moved. The window need not be active or visible, but it must be defined.

 The Screen Design window has a default size that can be larger than the window from which it takes its characteristics. In this case, the Screen Design window still assumes the characteristics of the window in which it is placed. The upper-left corner of the Screen Design window is placed at the same coordinates as the upper-left corner of the window, and can extend beyond the window's borders.

IN [WINDOW] window name2
 If IN WINDOW window name2 is included, the Screen Design window is opened within a parent window. It doesn't assume the characteristics of the parent window in which it is placed. A Screen Design window activated inside a parent window cannot be moved outside the parent window. If the parent window is moved, the Screen Design window moves with it.

 The parent window must first be defined with DEFINE WINDOW, and must be active and visible to access the Screen Design window.

IN SCREEN
 You can place a Screen Design window in the main FoxPro window by including IN SCREEN. This clause lets you explicitly place a Screen Design window in the main FoxPro window when a user-defined window is active. Screen Design windows are placed in the main FoxPro window by default.

IN MACDESKTOP
 MACDESKTOP is available in FoxPro for Macintosh only.

 Include the MACDESKTOP clause to place a Screen Design window on the Macintosh desktop. The Screen Design window resides at the same level as the main FoxPro window. The Screen Design window can be moved outside of the main FoxPro window and the main FoxPro window can be brought forward over the top of it. When you include the MACDESKTOP clause the Screen Design window behaves in the same manner as windows in FoxBASE+ for Macintosh.

 Including the MACDESKTOP clause overrides the current SET MACDESKTOP setting. SET MACDESKTOP determines if Screen Design windows are placed on the main FoxPro window or the Macintosh desktop when the SCREEN or MACDESKTOP clause is not included. For more information about placing Screen Design windows on the main FoxPro window or the Macintosh desktop, see SET MACDESKTOP.

Expand imageRemarks

Expand imageSee Also


© , 1996-2020 • Updated: 11/10/20
Comment or report problem with topic