Displays one or more user-defined windows or Visual FoxPro system windows without activating them.
SHOW WINDOW WindowName1 [, WindowName2 ...] | ALL | SCREEN [IN [WINDOW] WindowName3 [REFRESH] [TOP | BOTTOM | SAME] [SAVE] |
Parameters
- WindowName1 [, WindowName2...]
- Specifies the name of one or more windows to display.
- ALL
- Displays all user-defined windows.
- SCREEN
- Displays the main Visual FoxPro window when it is hidden. You can also choose Screen from the Window menu to display the main Visual FoxPro window. You can hide the main Visual FoxPro window by clicking its close box or issuing DEACTIVATEВ WINDOWВ SCREEN, HIDEВ WINDOWВ SCREEN, or В RELEASEВ WINDOWВ SCREEN.
- IN [WINDOW] WindowName3
- Displays the window inside a parent window specified with WindowName3. The window does not assume the characteristics of the parent window. A window displayed inside a parent window cannot be moved outside the parent window. If the parent window is moved, the child window moves with it. The parent window specified with WindowName3 must first be created with DEFINEВ WINDOW.
- IN SCREEN
- Explicitly displays the window in the main Visual FoxPro window instead of in another window. Windows are placed in the main Visual FoxPro window by default.
- REFRESH
- Redraws a Browse window. This option is useful on a network to ensure that you are browsing the most current version of a table. The work area for the Browse window table is selected. Memo-editing windows are refreshed with changes made to the memo field by other users on a network. SETВ REFRESH determines the interval between memo-editing-window refreshes. Refer to SETВ REFRESH for additional information on how data is refreshed in tables opened for shared use on a network.
- TOP
- Places the specified window in front of all other windows.
- BOTTOM
- Places the specified window behind all other windows.
- SAME
- Places the specified window back into a stack of windows in the same position the window occupied before it was deactivated. SAME affects only windows that have been previously displayed or activated and then cleared from the main Visual FoxPro window with DEACTIVATEВ WINDOW.
- SAVE
- Keeps an image of the window in the main Visual FoxPro window or in another window after the window is released. Normally, windows are removed from the main Visual FoxPro window after they are released. The window image can be cleared from the main Visual FoxPro window or a window with CLEAR.
Remarks
SHOWВ WINDOW controls the display and front-to-back screen placement of windows. If a window is hidden or has not been activated, SHOWВ WINDOW displays the window without activating it. If one or more windows are currently displayed, SHOWВ WINDOW lets you change the front-to-back order of the windows.
You can also display system windows, such as the Command window.
In Visual FoxPro, you can use SHOWВ WINDOWВ to display the Visual FoxPro toolbars. Use HIDEВ WINDOW to remove a toolbar from the FoxPro window. Toolbars must be active before they can be displayed. The following table lists the Visual FoxPro toolbars names to use in SHOWВ WINDOW and HIDEВ WINDOW. Enclose the toolbar name in quotation marks.
Toolbar Names | В | В |
---|---|---|
Color Palette |
Layout |
Report Designer |
Database Designer |
Print Preview |
Standard |
Form Controls |
Query Designer |
View Designer |
Form Designer |
Report Controls |
В |
To show a system window, enclose the entire system window name in quotation marks.
You cannot specify where output is directed to user-defined windows with SHOWВ WINDOW. Use ACTIVATEВ WINDOW to direct output to a user-defined window created with DEFINEВ WINDOW.
Historically in prior versions of Visual FoxPro, the Data Session window has always been referred to as the View window. Additionally, language used to control this window, such as HIDEВ WINDOW, ACTIVATEВ WINDOW, WONTOP(В ), also refers to this window as the View window. Visual FoxPro continues to refer to the View window for the SHOWВ WINDOW command.
Example
The following example, a window named wOutput1
is created and displayed. Since SHOWВ WINDOW is used to display the window, output cannot be directed to the window until it is activated.
В | Copy Code |
---|---|
CLEAR DEFINE WINDOW wOutput1 FROM 2,1 TO 13,75 TITLE 'Output' ; CLOSE FLOAT GROW ZOOM SHOW WINDOW wOutput1 |