Функция CreateStatusWindowA (commctrl.h)

Статья
11/18/2024

Создает окно состояния, которое обычно используется для отображения состояния приложения. Обычно окно отображается в нижней части родительского окна и содержит указанный текст.

Примечание Эта функция устарела. Вместо этого используйте 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 как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	commctrl.h
библиотеки	Comctl32.lib
DLL	Comctl32.dll

Поделиться через