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
 アンチエイリアシングされたアルファを含むテキストを描画します。 このフラグを使用するには、トップダウン 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 [デスクトップ アプリのみ]
Header uxtheme.h