Struttura DTTOPTS (uxtheme.h)

  • Articolo

Definisce le opzioni per la funzione DrawThemeTextEx .

Sintassi

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;

Members

dwSize

Tipo: DWORD

Dimensioni della struttura.

dwFlags

Tipo: DWORD

Combinazione di flag che specificano se sono stati specificati determinati valori della struttura DTTOPTS e come interpretare questi valori. Questo membro può essere una combinazione dei seguenti.

Valore Significato
DTT_TEXTCOLOR
 Il valore del membro crText è valido.
DTT_BORDERCOLOR
 Il valore del membro crBorder è valido.
DTT_SHADOWCOLOR
 Il valore del membro crShadow è valido.
DTT_SHADOWTYPE
 Il valore membro iTextShadowType è valido.
DTT_SHADOWOFFSET
 Il valore membro ptShadowOffset è valido.
DTT_BORDERSIZE
 Il valore membro iBorderSize è valido.
DTT_FONTPROP
 Il valore membro iFontPropId è valido.
DTT_COLORPROP
 Il valore membro iColorPropId è valido.
DTT_STATEID
 Il valore membro iStateId è valido.
DTT_CALCRECT
 Il parametro pRect della funzione DrawThemeTextEx che usa questa struttura verrà usato come parametro in e out. Dopo aver restituito la funzione, il parametro pRect conterrà il rettangolo che corrisponde all'area calcolata per essere disegnato.
DTT_APPLYOVERLAY
 Il valore del membro fApplyOverlay è valido.
DTT_GLOWSIZE
 Il valore membro iGlowSize è valido.
DTT_CALLBACK
 Il valore membro pfnDrawTextCallback è valido.
DTT_COMPOSITED
 Disegna il testo con alfa antialiased. L'uso di questo flag richiede una sezione DIB superiore. Questo flag funziona solo se l'HDC passato alla funzione DrawThemeTextEx ha una sezione DIB superiore attualmente selezionata. Per altre informazioni, vedere Bitmap indipendenti dal dispositivo.
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

Tipo: COLORREF

Specifica il colore del testo che verrà disegnato.

crBorder

Tipo: COLORREF

Specifica il colore della struttura che verrà disegnato intorno al testo.

crShadow

Tipo: COLORREF

Specifica il colore dell'ombreggiatura che verrà disegnato dietro il testo.

iTextShadowType

Tipo: int

Specifica il tipo dell'ombreggiatura che verrà disegnata dietro il testo. Questo membro può avere uno dei valori seguenti.

Valore Significato
TST_NONE
 Nessuna ombreggiatura verrà disegnata.
TST_SINGLE
 L'ombreggiatura verrà disegnata per apparire dettagliata sotto il testo.
TST_CONTINUOUS
 L'ombreggiatura verrà disegnata per apparire sfocata sotto il testo.

ptShadowOffset

Tipo: POINT

Specifica la quantità di offset, nelle coordinate logiche, tra l'ombreggiatura e il testo.

iBorderSize

Tipo: int

Specifica il raggio della struttura che verrà disegnata intorno al testo.

iFontPropId

Tipo: int

Specifica una proprietà del tipo di carattere alternativo da usare durante il disegno del testo. Per un elenco di valori possibili, vedere GetThemeSysFont.

iColorPropId

Tipo: int

Specifica una proprietà di colore alternativa da usare durante il disegno del testo. Se questo valore è valido e il flag corrispondente è impostato in dwFlags, questo valore eseguirà l'override del valore di crText. Vedere i valori elencati in GetSysColor per il parametro nIndex .

iStateId

Tipo: int

Specifica uno stato alternativo da usare. Questo membro non viene usato da DrawThemeTextEx.

fApplyOverlay

Tipo: BOOL

Se TRUE, il testo verrà disegnato sopra gli effetti ombreggiatura e struttura. Se FALSE, verranno disegnati solo gli effetti ombreggiatura e struttura.

iGlowSize

Tipo: int

Specifica le dimensioni di un bagliore che verrà disegnato sullo sfondo prima di qualsiasi testo disegnato.

pfnDrawTextCallback

Tipo: DTT_CALLBACK_PROC

Puntatore alla funzione di callback per DrawThemeTextEx.

lParam

Tipo: LPARAM

Parametro per la funzione back di callback specificata da pfnDrawTextCallback.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Intestazione uxtheme.h