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

Статья
08/22/2023

Функция DrawStatusText рисует указанный текст в стиле окна состояния с границами.

Синтаксис

void DrawStatusTextA(
  HDC     hDC,
  LPCRECT lprc,
  LPCSTR  pszText,
  UINT    uFlags
);

Параметры

hDC

Тип: HDC

Обработка контекста отображения для окна.

lprc

Тип: LPCRECT

Указатель на структуру RECT , содержащую позицию в клиентских координатах прямоугольника, в котором рисуется текст. Функция рисует границы непосредственно внутри краев указанного прямоугольника.

pszText

Тип: LPCTSTR

Указатель на строку, завершающуюся значением NULL, которая указывает отображаемый текст. Символы табуляции в строке определяют, выровнена ли строка по левому краю, по правому краю или по центру.

uFlags

Тип: UINT

Флаги рисования текста. Этот параметр может быть сочетанием следующих значений:

Значение	Значение
SBT_NOBORDERS	Запрещает рисование границ вокруг указанного текста.
SBT_POPOUT	Рисует выделенные границы, которые выделяют текст.
SBT_RTLREADING	Указывает, что строка, на которую указывает pszText, будет отображаться в направлении, противоположном тексту в родительском окне.

Возвращаемое значение

None

Remarks

Обычные окна отображают текст слева направо (LTR). Windows можно зеркально отображать на таких языках, как иврит или арабский, которые читают справа налево (RTL). Обычно строка pszText отображается в том же направлении, что и текст в родительском окне. Если задано SBT_RTLREADING, строка pszText будет считываться в противоположном направлении от текста в родительском окне.

Примечание

Заголовок commctrl.h определяет DrawStatusText в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	commctrl.h
Библиотека	Comctl32.lib
DLL	Comctl32.dll

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