AFX_GLOBAL_DATA::DrawTextOnGlass

Статья
02/20/2013

Прорисовывает указываемый текст в визуальном стиле конкретной темы.

BOOL DrawTextOnGlass(
   HTHEME hTheme, 
   CDC* pDC, 
   int iPartId, 
   int iStateId, 
   CString strText, 
   CRect rect, 
   DWORD dwFlags, 
   int nGlowSize = 0, 
   COLORREF clrText = (COLORREF)-1
);

Параметры

[входящий] hTheme
Дескриптор к данным в разделах окна или NULL.Инфраструктура использует указанную тему для рисования текста. если этот параметр не NULL и темы поддерживаются.В противном случае платформа не используют тему для отрисовки текста.

Используйте метод OpenThemeData для создания HTHEME.
[входящий] pDC
Указатель на контекст устройства.
[входящий] iPartId
Контрольная часть, содержащую нужный внешний вид текста.Дополнительные сведения см. в разделе столбец таблицы в части и состояния частей.Если это значение равно 0, то текст отображается в шрифте по умолчанию или шрифте, выбранном в контекст устройства.
[входящий] iStateId
Состояние элемента управления, содержащего нужный внешний вид текста.Дополнительные сведения см. в разделе столбец таблицы состояний в части и состояния.
[входящий] strText
Текст для прорисовки.
[входящий] rect
Граница области, в которой указанный текст отображается.
[входящий] dwFlags
Побитовое сочетание флагов (ИЛИ), которые определяют, как указанный текст отображается.

Если параметр hThemeNULL или если не поддерживаются и не включены разделы, то параметр nFormat метода CDC::DrawText описывает допустимые флаги.Если разделах поддерживаются, то параметр dwFlags метода DrawThemeTextEx описывает допустимые флаги.
[входящий] nGlowSize
Размер эффекта свечения, который рисуется на фоне, прежде чем выпишущ заданный текст.Значение по умолчанию — 0.
[входящий] clrText
Цвет, в котором заданный текст отображается.По умолчанию цвет по умолчанию.

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

TRUE, если тема используется для рисования указанный текст; в противном случае – значение FALSE.

Заметки

Тема задает визуальный стиль приложения.Дополнительные сведения см. в разделе темы и стили форматирования.Раздел не используется для рисования текста, если параметр hThemeNULL или если не поддерживается метод DrawThemeTextEx или если композиция Диспетчер окон рабочего стола (диспетчер окон рабочего стола) заблокирована.