|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| Yes
| Import Library
| user32.lib
| Header File
| winuser.h
| Unicode
| No
| Platform Notes
| None
|
|
|
ShowWindow
The ShowWindow function sets the specified window's show state.
BOOL ShowWindow(
HWND hWnd,
| // handle of window
| int nCmdShow
| // show state of window
| );
|
|
Parameters
hWnd
Identifies the window.
nCmdShow
Specifies how the window is to be shown. This parameter is ignored the first
time an application calls ShowWindow, if the program that launched the application provides a STARTUPINFO structure. Otherwise, the first time ShowWindow is called, the value should be the value obtained by the WinMain function in its nCmdShow parameter. In subsequent calls, this parameter can be one of the following
values:
Value
| Meaning
| SW_HIDE
| Hides the window and activates another window.
| SW_MAXIMIZE
| Maximizes the specified window.
| SW_MINIMIZE
| Minimizes the specified window and activates the next top-level window in the
Z order.
| SW_RESTORE
| Activates and displays the window. If the window is minimized or maximized,
Windows restores it to its original size and position. An application should
specify this flag when restoring a minimized window.
| SW_SHOW
| Activates the window and displays it in its current size and position.
| SW_SHOWDEFAULT
| Sets the show state based on the SW_ flag specified in the STARTUPINFO structure passed to the CreateProcess function by the program that started the application.
| SW_SHOWMAXIMIZED
| Activates the window and displays it as a maximized window.
| SW_SHOWMINIMIZED
| Activates the window and displays it as a minimized window.
| SW_SHOWMINNOACTIVE
| Displays the window as a minimized window. The active window remains active.
| SW_SHOWNA
| Displays the window in its current state. The active window remains active.
| SW_SHOWNOACTIVATE
| Displays a window in its most recent size and position. The active window
remains active.
| SW_SHOWNORMAL
| Activates and displays a window. If the window is minimized or maximized,
Windows restores it to its original size and position. An application should
specify this flag when displaying the window for the first time.
|
Return Values
If the window was previously visible, the return value is nonzero.
If the window was previously hidden, the return value is zero.
Remarks
The first time a program calls ShowWindow, it uses the WinMain function's nCmdShow parameter as its nCmdShow parameter. Subsequent calls to ShowWindow must use one of the values in the given list, instead of the one specified by
the WinMain function's nCmdShow parameter.
As noted in the discussion of the nCmdShow parameter, the nCmdShow value is ignored in the first call to ShowWindow if the program that launched the application specifies startup information in
the STARTUPINFO structure. In this case, ShowWindow uses the information specified in the STARTUPINFO structure to show the window. On subsequent calls, the application must call ShowWindow with nCmdShow set to SW_SHOWDEFAULT to use the startup information provided by the program
that launched the application. For example, Program Manager specifies that
applications start with a minimized main window. This behavior is designed for the
following situations:
- Applications create their main window by calling CreateWindow with the WS_VISIBLE flag set.
- Applications create their main window by calling CreateWindow with the WS_VISIBLE flag cleared, and later call ShowWindow with the SW_SHOW flag set to make it visible.
See Also
CreateProcess, CreateWindow, ShowOwnedPopups, STARTUPINFO, WinMain
| Last news from Greatis Software |
 |
|
Nostalgia .Net |
|
.Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More » |
| Recommended software for developers |
 |
|
Ultimate Pack |
|
Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More » |
 |
|
Form Designer .Net |
|
Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More » |
 |
|
Print Suite .Net |
|
Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More » |
 |
|
Gradient Controls .Net |
|
Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More » |
 |
|
Greatis iGrid |
|
iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More » |
All the contacts and projectsDmitry Vasiliev (just.dmitry)
Related LinksSoftware for Visual Studio .NET developers
Software for Delphi and C++ Builder developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET More Online Helps Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages
|
