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

Статья
11/18/2024

Функция 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, будет отображаться в противоположном направлении к тексту в родительском окне.

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

Никакой

Замечания

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

Заметка

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

Требования

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

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