AFX_GLOBAL_DATA::DrawTextOnGlass

Artikel
02/26/2013

Zeichnet den angegebenen Text im visuellen Stil des angegebenen Designs.

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

Parameter

[in] hTheme
Handle für den Designwörterbüchern von Daten eines Fensters oder NULL.Das Framework verwendet das angegebene Design, um den Text zu zeichnen, wenn dieser Parameter nicht NULL ist und Designs unterstützt werden.Andernfalls verwendet das Framework Design nicht zum Zeichnen des Texts.

Verwenden Sie die OpenThemeData-Methode, um HTHEME zu erstellen.
[in] pDC
Ein Zeiger auf einen Gerätekontext.
[in] iPartId
Das Steuerteil, die die gewünschte Aussehen hat Text.Weitere Informationen finden Sie in der Parts in Teile und Zustände Spalte der Tabelle.Wenn dieser Wert 0 ist, wird der Text in der Schriftart oder in einer Standardschriftart, die in den Gerätekontext ausgewählt ist, gezeichnet.
[in] iStateId
Der Steuerelementzustand, der die gewünschte Aussehen hat Text.Weitere Informationen finden Sie unter der Spalte Status der Tabelle in Teile und Zustände.
[in] strText
Der zu zeichnende Text.
[in] rect
Die Grenze des Bereichs, in dem der angegebene Text gezeichnet werden soll.
[in] dwFlags
Eine bitweise Kombination (OR) von Flags, die angeben, wie der angegebene Text gezeichnet wird.

Wenn der hTheme-Parameter NULL ist oder wenn sich Designs nicht unterstützt und aktiviert sind, werden die Parameter der nFormatCDC::DrawText-Methode zulässigen Flags.Wenn Designs unterstützt werden, beschrieben wird der dwFlags-Parameter der DrawThemeTextEx-Methode zulässigen Flags.
[in] nGlowSize
Die Größe eines Leuchteffekts im Hintergrund gezeichnet wird, bevor der angegebenen Text zeichnet.Der Standardwert ist 0.
[in] clrText
Die Farbe, in der der angegebene Text gezeichnet wird.Der Standardwert ist die Standardfarbe.

Rückgabewert

TRUE, wenn ein Design verwendet wird, um den angegebenen Text zu zeichnen; andernfalls FALSE.

Hinweise

Ein Design definiert den visuellen Stil einer Anwendung.Weitere Informationen finden Sie unter Visuelle Stile und Designs.Ein Design wird nicht verwendet, um den Text zu zeichnen, wenn der hTheme-Parameter NULL ist oder wenn die DrawThemeTextEx-Methode nicht unterstützt wird oder wenn die Komposition Desktopfenster-Manager (DWM) deaktiviert ist.