AFX_GLOBAL_DATA::DrawTextOnGlass

Статья
06/10/2015

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

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, или если объединение Диспетчер окон рабочего стола (диспетчер окон рабочего стола) запрещена.