MODIFY SCREEN Command

Included for backward compatibility. Use MODIFY 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 the Screen Design window and enables you to create or modify a screen.

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

Parameters

file
 You can modify an existing screen by specifying the name of the screen definition file. If the file you specify doesn't exist or can't be found, a new screen is created.

?
 If you include the ? clause or omit the screen filename, the Open dialog appears and displays a list of existing screen files to choose from. You can also choose New to create a new screen file. If you choose New, the name Untitled is assigned to the Screen Design window. You can save the screen file with a different name when you close the Screen Design window.

WINDOW window name1
 If you include WINDOW window name1, the Screen Design window takes on the characteristics of the window you specify. For example, if the window is defined with the FLOAT clause of DEFINE WINDOW, the Screen Design window can be moved. The window you specify doesn't have to be active or visible, but it must be defined.

IN [WINDOW] window name2
 If you include IN WINDOW window name2, the Screen Design window is opened within a parent window without assuming the characteristics of the parent window. A Screen Design window activated inside a parent window can't be moved outside the parent window. If the parent window is moved, the Screen Design window moves with it.

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

IN SCREEN
 By including IN SCREEN, you can explicitly place a Screen Design window in the main FoxPro window when a user-defined window is active. The Screen Design window is 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.

NOENVIRONMENT
 When you close the Screen Design window, you are prompted to save the current FoxPro environment with the screen definition file. Saving the FoxPro environment places an additional record in the screen definition table. This record contains the names of all open table and index files, the index order, and any relationships between the tables.

 MODIFY SCREEN automatically restores the environment saved with the screen definition file if you saved the FoxPro environment. If you include NOENVIRONMENT, the environment isn't restored. Include NOENVIRONMENT to prevent changes to the current environment.

NOWAIT
 When you issue MODIFY SCREEN from within a program, the Screen Design window is opened and program execution pauses until the Screen Design window is closed. Include NOWAIT to continue program execution after the Screen Design window is opened. The program continues executing on the program line immediately following MODIFY SCREEN NOWAIT.

 NOWAIT is available only from within a program. Including NOWAIT has no effect on MODIFY SCREEN when it is issued in the Command window.

SAVE
 Include SAVE to keep an image of the Screen Design window in the main FoxPro window or a user-defined window after the Screen Design window closed. After you close the Screen Design window, it is normally removed from the main FoxPro window or a user-defined window. Use CLEAR to erase the Screen Design window from the main FoxPro window or a user-defined window.

 SAVE is available only from within a program. Including SAVE has no effect when it is issued in the Command window.

Expand imageRemarks

Expand imageSee Also


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