Share via

Structure DTTOPTS (uxtheme.h)

  • Article

Définit les options de la fonction DrawThemeTextEx .

Syntaxe

typedef struct _DTTOPTS {
  DWORD             dwSize;
  DWORD             dwFlags;
  COLORREF          crText;
  COLORREF          crBorder;
  COLORREF          crShadow;
  int               iTextShadowType;
  POINT             ptShadowOffset;
  int               iBorderSize;
  int               iFontPropId;
  int               iColorPropId;
  int               iStateId;
  BOOL              fApplyOverlay;
  int               iGlowSize;
  DTT_CALLBACK_PROC pfnDrawTextCallback;
  LPARAM            lParam;
} DTTOPTS, *PDTTOPTS;

Membres

dwSize

Type : DWORD

Taille de la structure.

dwFlags

Type : DWORD

Combinaison d’indicateurs qui spécifient si certaines valeurs de la structure DTTOPTS ont été spécifiées et comment interpréter ces valeurs. Ce membre peut être une combinaison des éléments suivants.

Valeur Signification
DTT_TEXTCOLOR
 La valeur du membre crText est valide.
DTT_BORDERCOLOR
 La valeur du membre crBorder est valide.
DTT_SHADOWCOLOR
 La valeur du membre crShadow est valide.
DTT_SHADOWTYPE
 La valeur du membre iTextShadowType est valide.
DTT_SHADOWOFFSET
 La valeur du membre ptShadowOffset est valide.
DTT_BORDERSIZE
 La valeur du membre iBorderSize est valide.
DTT_FONTPROP
 La valeur du membre iFontPropId est valide.
DTT_COLORPROP
 La valeur du membre iColorPropId est valide.
DTT_STATEID
 La valeur du membre iStateId est valide.
DTT_CALCRECT
 Le paramètre pRect de la fonction DrawThemeTextEx qui utilise cette structure sera utilisé comme paramètre in et out. Une fois la fonction retournée, le paramètre pRect contient le rectangle qui correspond à la région calculée à dessiner.
DTT_APPLYOVERLAY
 La valeur du membre fApplyOverlay est valide.
DTT_GLOWSIZE
 La valeur du membre iGlowSize est valide.
DTT_CALLBACK
 La valeur du membre pfnDrawTextCallback est valide.
DTT_COMPOSITED
 Dessine le texte avec un alpha anti-attirail. L’utilisation de cet indicateur nécessite une section DIB descendante. Cet indicateur fonctionne uniquement si le HDC passé à la fonction DrawThemeTextEx comporte une section DIB descendante actuellement sélectionnée. Pour plus d’informations, consultez Bitmaps indépendantes de l’appareil.
DTT_VALIDBITS
 DTT_TEXTCOLOR | DTT_BORDERCOLOR | DTT_SHADOWCOLOR | DTT_SHADOWTYPE | DTT_SHADOWOFFSET | DTT_BORDERSIZE | DTT_FONTPROP | DTT_COLORPROP | DTT_STATEID | DTT_CALCRECT | DTT_APPLYOVERLAY | DTT_GLOWSIZE | DTT_COMPOSITED.

crText

Type : COLORREF

Spécifie la couleur du texte qui sera dessiné.

crBorder

Type : COLORREF

Spécifie la couleur du plan qui sera dessiné autour du texte.

crShadow

Type : COLORREF

Spécifie la couleur de l’ombre qui sera dessinée derrière le texte.

iTextShadowType

Type : int

Spécifie le type de l’ombre qui sera dessinée derrière le texte. Ce membre peut avoir l’une des valeurs suivantes.

Valeur Signification
TST_NONE
 Aucune ombre ne sera dessinée.
TST_SINGLE
 L’ombre sera dessinée pour apparaître détaillée sous le texte.
TST_CONTINUOUS
 L’ombre sera dessinée pour apparaître floue sous le texte.

ptShadowOffset

Type : POINT

Spécifie la quantité de décalage, en coordonnées logiques, entre l’ombre et le texte.

iBorderSize

Type : int

Spécifie le rayon du plan qui sera dessiné autour du texte.

iFontPropId

Type : int

Spécifie une autre propriété de police à utiliser lors du dessin de texte. Pour obtenir la liste des valeurs possibles, consultez GetThemeSysFont.

iColorPropId

Type : int

Spécifie une autre propriété de couleur à utiliser lors du dessin de texte. Si cette valeur est valide et que l’indicateur correspondant est défini dans dwFlags, cette valeur remplace la valeur crText. Consultez les valeurs répertoriées dans GetSysColor pour le paramètre nIndex .

iStateId

Type : int

Spécifie un autre état à utiliser. Ce membre n’est pas utilisé par DrawThemeTextEx.

fApplyOverlay

Type : BOOL

Si la valeur EST TRUE, le texte est dessiné au-dessus des effets d’ombre et de contour. Si la valeur est FALSE, seuls les effets d’ombre et de contour seront dessinés.

iGlowSize

Type : int

Spécifie la taille d’une lueur qui sera dessinée sur l’arrière-plan avant tout texte dessiné.

pfnDrawTextCallback

Type : DTT_CALLBACK_PROC

Pointeur vers la fonction de rappel pour DrawThemeTextEx.

lParam

Type : LPARAM

Paramètre pour la fonction de rappel spécifiée par pfnDrawTextCallback.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
En-tête uxtheme.h