DTTOPTS 结构 (uxtheme.h)

  • 项目

定义 DrawThemeTextEx 函数的选项。

语法

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;

成员

dwSize

类型： DWORD

结构的大小。

dwFlags

类型： DWORD

标志的组合，这些标志指定是否指定了 DTTOPTS 结构的某些值以及如何解释这些值。 此成员可以是以下各项的组合。

值 含义
DTT_TEXTCOLOR
 crText 成员值有效。
DTT_BORDERCOLOR
 crBorder 成员值有效。
DTT_SHADOWCOLOR
 crShadow 成员值有效。
DTT_SHADOWTYPE
 iTextShadowType 成员值有效。
DTT_SHADOWOFFSET
 ptShadowOffset 成员值有效。
DTT_BORDERSIZE
 iBorderSize 成员值有效。
DTT_FONTPROP
 iFontPropId 成员值有效。
DTT_COLORPROP
 iColorPropId 成员值有效。
DTT_STATEID
 iStateId 成员值有效。
DTT_CALCRECT
 使用此结构的 DrawThemeTextEx 函数的 pRect 参数将用作 in 和 out 参数。 函数返回后， pRect 参数将包含对应于计算要绘制的区域的矩形。
DTT_APPLYOVERLAY
 fApplyOverlay 成员值有效。
DTT_GLOWSIZE
 iGlowSize 成员值有效。
DTT_CALLBACK
 pfnDrawTextCallback 成员值有效。
DTT_COMPOSITED
 使用抗锯齿 alpha 绘制文本。 使用此标志需要自上而下的 DIB 部分。 仅当传递给 函数 DrawThemeTextEx 的 HDC 当前选择了一个自上而下 DIB 部分时，此标志才有效。 有关详细信息，请参阅 与设备无关的位图。
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

类型： COLORREF

指定要绘制的文本的颜色。

crBorder

类型： COLORREF

指定将在文本周围绘制的轮廓的颜色。

crShadow

类型： COLORREF

指定将在文本后面绘制的阴影的颜色。

iTextShadowType

类型： int

指定将在文本后面绘制的阴影的类型。 此成员可以具有以下值之一。

值 含义
TST_NONE
 不会绘制任何阴影。
TST_SINGLE
 将绘制阴影，以在文本下方显示详细。
TST_CONTINUOUS
 将绘制阴影，以在文本下方显示为模糊。

ptShadowOffset

类型： POINT

指定阴影和文本之间的偏移量（以逻辑坐标为单位）。

iBorderSize

类型： int

指定将在文本周围绘制的轮廓的半径。

iFontPropId

类型： int

指定绘制文本时要使用的备用字体属性。 有关可能值的列表，请参阅 GetThemeSysFont。

iColorPropId

类型： int

指定绘制文本时要使用的备用颜色属性。 如果此值有效，并且相应的标志在 dwFlags 中设置，则此值将替代 crText 的值。 有关 nIndex 参数，请参阅 GetSysColor 中列出的值。

iStateId

类型： int

指定要使用的备用状态。 DrawThemeTextEx 不使用此成员。

fApplyOverlay

类型： BOOL

如果 为 TRUE，则将在阴影和轮廓效果的顶部绘制文本。 如果 为 FALSE，则仅绘制阴影和轮廓效果。

iGlowSize

类型： int

指定在绘制任何文本之前将在背景上绘制的发光的大小。

pfnDrawTextCallback

类型： DTT_CALLBACK_PROC

指向 DrawThemeTextEx 的回调函数的指针。

lParam

类型： LPARAM

pfnDrawTextCallback 指定的回调回叫函数的参数。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
标头 uxtheme.h