AfxShowWindowState

描述

设置指定窗口的显示状态。

PowerBasic 语法

FUNCTION AfxShowWindowState ( _

BYVAL hwnd AS DWORD, _

BYVAL nShowState AS LONG _

) AS LONG

参数

hwnd

[in]窗口的句柄。

nShowState

[in]控制如何显示窗口。如果启动应用程序的程序提供STARTUPINFO结构，则此应用程序首次调用AfxShowWindowState时将忽略此参数。否则，第一次调用AfxShowWindowState，该值应为WinMain参数中WinMain函数获取的值。在后续调用中，此参数可以是以下值之一。

Value	Meaning
SW_FORCEMINIMIZE 11	即使拥有该窗口的线程没有响应，也最小化一个窗口。该标志只能在最小化不同线程的窗口时使用。
SW_HIDE 0	隐藏窗口并激活另一个窗口。
SW_MAXIMIZE 3	最大化指定的窗口。
SW_MINIMIZE 6	最小化指定的窗口，并以Z顺序激活下一个顶级窗口。
SW_RESTORE 9	激活并显示窗口。如果窗口最小化或最大化，系统将其恢复到原来的大小和位置。应用程序在恢复最小化的窗口时应该指定此标志。
SW_SHOW 5	激活窗口并将其显示为当前的大小和位置。
SW_SHOWDEFAULT 10	根据启动应用程序的程序，传递给CreateProcess函数的STARTUPINFO结构中指定的SW_值设置显示状态。
SW_SHOWMAXIMIZED 3	激活窗口并将其显示为最大化的窗口。
SW_SHOWMINIMIZED 2	激活窗口并将其显示为最小化窗口。
SW_SHOWMINNOACTIVE 7	将窗口显示为最小化窗口。此值与SW_SHOWMINIMIZED类似，但窗口未激活。
SW_SHOWNA 8	以当前大小和位置显示窗口。此值与SW_SHOW类似，但窗口未激活。
SW_SHOWNOACTIVATE 4	显示最新尺寸和位置的窗口。该值与SW_SHOWNORMAL类似，但窗口未激活。
SW_SHOWNORMAL 1	激活并显示窗口。如果窗口最小化或最大化，系统将其恢复到原来的大小和位置。应用程序在首次显示窗口时应指定此标志。

返回值

如果窗口以前可见，则返回值不为零。

如果窗口以前被隐藏，返回值为零。

备注

要在显示或隐藏窗口时执行某些特殊效果，请使用AnimateWindow.

应用程序首次调用AfxShowWindowState时，应使用nCmdShow函数的nCmdShow参数作为其nCmdShow参数。对AfxShowWindowState的后续调用必须使用给定列表中的一个值，而不是WinMain函数的nCmdShow参数指定的值。

如nCmdShow参数的讨论中所述，如果启动应用程序的程序在结构中指定启动信息，则在首次调用AfxShowWindowState时将忽略nCmdShow值。在这种情况下，AfxShowWindowState使用STARTUPINFO结构中指定的信息显示窗口。在后续呼叫中，应用程序必须调用AfxShowWindowState nCmdShow设置为SW_SHOWDEFAULT以使用启动应用程序的程序提供的启动信息。此行为是针对以下情况而设计的：

·	应用程序通过调用CreateWindow设置WS_VISIBLE标志来创建主窗口。

·	应用程序通过调用CreateWindow清除WS_VISIBLE标志来创建主窗口，稍后调用AfxShowWindowState，设置SW_SHOW标志使其可见。

引用文件 #INCLUDE Once

AfxWin.inc