DTTOPTS-Struktur (uxtheme.h)

Definiert die Optionen für die DrawThemeTextEx-Funktion .

Syntax

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;

Member

dwSize

Typ: DWORD

Größe der Struktur.

dwFlags

Typ: DWORD

Eine Kombination von Flags, die angeben, ob bestimmte Werte der DTTOPTS-Struktur angegeben wurden und wie diese Werte interpretiert werden sollen. Bei diesem Member kann es sich um eine Kombination aus folgendem Element handelt.

Wert	Bedeutung
DTT_TEXTCOLOR	Der CrText-Memberwert ist gültig.
DTT_BORDERCOLOR	Der CrBorder-Memberwert ist gültig.
DTT_SHADOWCOLOR	Der CrShadow-Memberwert ist gültig.
DTT_SHADOWTYPE	Der iTextShadowType-Memberwert ist gültig.
DTT_SHADOWOFFSET	Der ptShadowOffset-Memberwert ist gültig.
DTT_BORDERSIZE	Der iBorderSize-Memberwert ist gültig.
DTT_FONTPROP	Der iFontPropId-Memberwert ist gültig.
DTT_COLORPROP	Der iColorPropId-Memberwert ist gültig.
DTT_STATEID	Der iStateId-Memberwert ist gültig.
DTT_CALCRECT	Der pRect-Parameter der DrawThemeTextEx-Funktion , die diese Struktur verwendet, wird sowohl als ein ein- als auch ein out-Parameter verwendet. Nachdem die Funktion zurückgegeben wurde, enthält der pRect-Parameter das Rechteck, das dem für das Zeichnen berechneten Bereich entspricht.
DTT_APPLYOVERLAY	Der fApplyOverlay-Memberwert ist gültig.
DTT_GLOWSIZE	Der iGlowSize-Memberwert ist gültig.
DTT_CALLBACK	Der PfnDrawTextCallback-Memberwert ist gültig.
DTT_COMPOSITED	Zeichnet Text mit antialiasiertem Alpha. Die Verwendung dieses Flags erfordert einen DIB-Abschnitt von oben nach unten. Dieses Flag funktioniert nur, wenn für die an die Funktion DrawThemeTextEx übergebene HDC ein DIB-Abschnitt von oben nach unten ausgewählt ist. Weitere Informationen finden Sie unter Geräteunabhängige Bitmaps.
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

Typ: COLORREF

Gibt die Farbe des Texts an, der gezeichnet wird.

crBorder

Typ: COLORREF

Gibt die Farbe der Gliederung an, die um den Text herum gezeichnet wird.

crShadow

Typ: COLORREF

Gibt die Farbe des Schattens an, der hinter dem Text gezeichnet wird.

iTextShadowType

Typ: int

Gibt den Typ des Schattens an, der hinter dem Text gezeichnet wird. Dieser Member kann über einen der folgenden Werte verfügen.

Wert	Bedeutung
TST_NONE	Es wird kein Schatten gezeichnet.
TST_SINGLE	Der Schatten wird so gezeichnet, dass er detailliert unter dem Text angezeigt wird.
TST_CONTINUOUS	Der Schatten wird so gezeichnet, dass er unscharf unter dem Text erscheint.

ptShadowOffset

Typ: POINT

Gibt die Menge des Offsets in logischen Koordinaten zwischen Schatten und Text an.

iBorderSize

Typ: int

Gibt den Radius der Gliederung an, die um den Text herum gezeichnet wird.

iFontPropId

Typ: int

Gibt eine alternative Schriftarteigenschaft an, die beim Zeichnen von Text verwendet werden soll. Eine Liste der möglichen Werte finden Sie unter GetThemeSysFont.

iColorPropId

Typ: int

Gibt eine alternative Farbeigenschaft an, die beim Zeichnen von Text verwendet werden soll. Wenn dieser Wert gültig ist und das entsprechende Flag in dwFlags festgelegt ist, überschreibt dieser Wert den Wert von crText. Sehen Sie sich die in GetSysColor aufgeführten Werte für den nIndex-Parameter an .

iStateId

Typ: int

Gibt einen alternativen Zustand an, der verwendet werden soll. Dieses Element wird von DrawThemeTextEx nicht verwendet.

fApplyOverlay

Typ: BOOL

Bei TRUE wird Text über die Schatten- und Gliederungseffekte gezeichnet. Bei FALSE werden nur die Schatten- und Gliederungseffekte gezeichnet.

iGlowSize

Typ: int

Gibt die Größe eines Leuchtens an, das im Hintergrund gezeichnet wird, bevor Text gezeichnet wird.

pfnDrawTextCallback

Typ: DTT_CALLBACK_PROC

Zeiger auf Rückruffunktion für DrawThemeTextEx.

lParam

Typ: LPARAM

Parameter für rückruffunktion angegeben durch pfnDrawTextCallback.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	uxtheme.h