DrawShadowText 函式 (commctrl.h)

  • 發行項

繪製具有陰影的文字。

語法

int DrawShadowText(
  HDC      hdc,
  LPCWSTR  pszText,
  UINT     cch,
  RECT     *prc,
  DWORD    dwFlags,
  COLORREF crText,
  COLORREF crShadow,
  int      ixOffset,
  int      iyOffset
);

參數

hdc

類型： HDC

HDC。

pszText

類型： LPCWSTR

字串的指標，其中包含要繪製的文字。

cch

類型： UINT

UINT，指定要繪製之字串中的字元數。

prc

類型：const RECT*

RECT結構的指標，其中包含要繪製文字的矩形，以邏輯座標表示。

dwFlags

類型： DWORD

DWORD，指定如何繪製文字。 如需可能的參數值 ，請參閱格式 值。

crText

類型： COLORREF

包含文字色彩的 COLORREF 結構。

crShadow

類型： COLORREF

包含文字陰影色彩的 COLORREF 結構。

ixOffset

類型： int

int類型的值，指定文字開始位置的 X 座標。

iyOffset

類型： int

int類型的值，指定文字開始位置的 Y 座標。

傳回值

類型： int

如果函式成功，則會以邏輯單位傳回文字的高度，否則會傳回零。

備註

若要使用 DrawShadowText，請在資訊清單中指定第 6 版 Comctl32.dll。 如需資訊清單的詳細資訊，請參閱 啟用視覺化樣式。

規格需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 commctrl.h
程式庫 Comctl32.lib
Dll ComCtl32.dll (6 版或更新版本)