DTTOPTS-Struktur (uxtheme.h)

  • Artikel

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