Partager via


AFX_GLOBAL_DATA : : DrawTextOnGlass

Dessine le texte spécifié dans le style visuel du thème spécifié.

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

Paramètres

  • [in] hTheme
    Descripteur sur données de thème d'une fenêtre, ou NULL. L'infrastructure utilise le thème spécifié pour ajouter le texte si ce paramètre n'est pas NULL et les thèmes suivants sont pris en charge. Sinon, l'infrastructure n'utilise pas un thème pour ajouter du texte.

    Utilisez la méthode OpenThemeData pour créer un HTHEME.

  • [in] pDC
    Pointeur vers un contexte de périphérique.

  • [in] iPartId
    La partie commande ayant l'apparence souhaitée de texte. Pour plus d'informations, consultez les parties la colonne de la table dans Pièces et états. Si cette valeur est 0, le texte est tracé dans la police par défaut, ou une police sélectionnée dans le contexte de périphérique.

  • [in] iStateId
    L'état commande ayant l'apparence souhaitée de texte. Pour plus d'informations, consultez la colonne états de la table dans Pièces et états.

  • [in] strText
    Texte à dessiner.

  • [in] rect
    La limite de la zone dans laquelle le texte spécifié est tracé.

  • [in] dwFlags
    Combinaison d'opérations de bits (OR) d'indicateurs qui spécifient comment le texte spécifié est tracé.

    Si le paramètre hTheme est NULL ou si les thèmes ne sont pas pris en charge et ne sont pas activés, le paramètre nFormat de la méthode de CDC::DrawText décrit les indicateurs valides. Si les thèmes suivants sont pris en charge, le paramètre dwFlags de la méthode DrawThemeTextEx décrit les indicateurs valides.

  • [in] nGlowSize
    La taille d'un effet de lueur qui est dessiné sur l'arrière-plan avant de dessin le texte spécifié. La valeur par défaut est 0.

  • [in] clrText
    La couleur dans laquelle le texte spécifié est tracé. La valeur par défaut est la couleur par défaut.

Valeur de retour

TRUE si un thème est utilisé pour ajouter le texte spécifié ; sinon, FALSE.

Notes

Un thème définit le style visuel d'une application. Pour plus d'informations sur les styles visuels, consultez Thèmes et styles visuels. Un thème n'est pas utilisé pour ajouter le texte si le paramètre est hTheme NULL, ou si la méthode DrawThemeTextEx n'est pas prise en charge, ou si la publication en Gestionnaire de fenêtrage (master) est désactivée.

Configuration requise

En-tête : afxglobals.h

Voir aussi

Référence

structure d'AFX_GLOBAL_DATA

Graphique de la hiérarchie

Thèmes et styles visuels

COLORREF

Pièces et états

CDC::DrawText

DrawThemeTextEx

Gestionnaire de fenêtrage

Activer et contrôler la publication du Gestionnaire de fenêtrage