CreateStatusWindowA 函数 (commctrl.h)

创建状态窗口，该窗口通常用于显示应用程序的状态。 该窗口通常显示在父窗口的底部，并且包含指定的文本。

注意 此函数已过时。 请改用 CreateWindow 。

 

语法

HWND CreateStatusWindowA(
  LONG   style,
  LPCSTR lpszText,
  HWND   hwndParent,
  UINT   wID
);

参数

style

类型： LONG

状态窗口的窗口样式。 此参数必须包含 WS_CHILD 样式，并且还应包含 WS_VISIBLE 样式。

lpszText

类型： LPCTSTR

指向以 null 结尾的字符串的指针，该字符串指定第一部分的状态文本。

hwndParent

类型： HWND

父窗口的句柄。

wID

类型： UINT

状态窗口的控制标识符。 窗口过程使用此值来标识它发送到父窗口的消息。

返回值

类型： HWND

如果成功，则返回状态窗口的句柄，否则返回 NULL 。 若要检索扩展的错误信息，请调用 GetLastError。

注解

CreateStatusWindow 函数调用 CreateWindow 函数来创建窗口。 它将参数传递给 而不进行修改，并将位置、宽度和高度参数设置为 CreateWindow 默认值。

注意

commctrl.h 标头将 CreateStatusWindow 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	commctrl.h
Library	Comctl32.lib
DLL	Comctl32.dll