共用方式為

uxtheme.h (uxtheme.h) DTTOPTS 結構

  • 發行項

定義 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