开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > Windows编程 > 界面编程 > 对话框与窗口 > 查看源码
Uxtheme.h
资源名称：Xtreme.ToolkitPro.v12.0.0.rar　[点击查看]
上传用户：szled88
上传日期：2015-04-09
资源大小：43957k
文件大小：47k
源码类别：

对话框与窗口

开发平台：

Visual C++

Uxtheme.h：源码内容
  1. //---------------------------------------------------------------------------
  2. // Copyright (c) Microsoft Corporation. All rights reserved.
  3. //
  4. // File   : uxtheme.h
  5. // Version: 1.0
  6. //---------------------------------------------------------------------------
  7. #ifndef _UXTHEME_H_
  8. #define _UXTHEME_H_
  9. //---------------------------------------------------------------------------
  10. #include <commctrl.h>
  11. //---------------------------------------------------------------------------
  12. //#if (_WIN32_WINNT >= 0x0500)     // only available on XP
  13. //---------------------------------------------------------------------------
  14. // Define API decoration for direct importing of DLL references.
  15. #ifndef THEMEAPI
  16. #if !defined(_UXTHEME_)
  17. #define THEMEAPI          EXTERN_C DECLSPEC_IMPORT HRESULT STDAPICALLTYPE
  18. #define THEMEAPI_(type)   EXTERN_C DECLSPEC_IMPORT type STDAPICALLTYPE
  19. #else
  20. #define THEMEAPI          STDAPI
  21. #define THEMEAPI_(type)   STDAPI_(type)
  22. #endif
  23. #endif // THEMEAPI
  24. //---------------------------------------------------------------------------
  25. typedef HANDLE HTHEME;          // handle to a section of theme data for class
  27. //---------------------------------------------------------------------------
  28. // NOTE: PartId's and StateId's used in the theme API are defined in the
  29. //       hdr file <tmschema.h> using the TM_PART and TM_STATE macros.  For
  30. //       example, "TM_PART(BP, PUSHBUTTON)" defines the PartId "BP_PUSHBUTTON".
  32. //---------------------------------------------------------------------------
  33. //  OpenThemeData()     - Open the theme data for the specified HWND and
  34. //                        semi-colon separated list of class names.
  35. //
  36. //                        OpenThemeData() will try each class name, one at
  37. //                        a time, and use the first matching theme info
  38. //                        found.  If a match is found, a theme handle
  39. //                        to the data is returned.  If no match is found,
  40. //                        a "NULL" handle is returned.
  41. //
  42. //                        When the window is destroyed or a WM_THEMECHANGED
  43. //                        msg is received, "CloseThemeData()" should be
  44. //                        called to close the theme handle.
  45. //
  46. //  hwnd                - window handle of the control/window to be themed
  47. //
  48. //  pszClassList        - class name (or list of names) to match to theme data
  49. //                        section.  if the list contains more than one name,
  50. //                        the names are tested one at a time for a match.
  51. //                        If a match is found, OpenThemeData() returns a
  52. //                        theme handle associated with the matching class.
  53. //                        This param is a list (instead of just a single
  54. //                        class name) to provide the class an opportunity
  55. //                        to get the "best" match between the class and
  56. //                        the current theme.  For example, a button might
  57. //                        pass L"OkButton, Button" if its ID=ID_OK.  If
  58. //                        the current theme has an entry for OkButton,
  59. //                        that will be used.  Otherwise, we fall back on
  60. //                        the normal Button entry.
  61. //---------------------------------------------------------------------------
  62. THEMEAPI_(HTHEME) OpenThemeData(HWND hwnd, LPCWSTR pszClassList);
  64. //---------------------------------------------------------------------------
  65. //  CloseTHemeData()    - closes the theme data handle.  This should be done
  66. //                        when the window being themed is destroyed or
  67. //                        whenever a WM_THEMECHANGED msg is received
  68. //                        (followed by an attempt to create a new Theme data
  69. //                        handle).
  70. //
  71. //  hTheme              - open theme data handle (returned from prior call
  72. //                        to OpenThemeData() API).
  73. //---------------------------------------------------------------------------
  74. THEMEAPI CloseThemeData(HTHEME hTheme);
  76. //---------------------------------------------------------------------------
  77. //    functions for basic drawing support
  78. //---------------------------------------------------------------------------
  79. // The following methods are the theme-aware drawing services.
  80. // Controls/Windows are defined in drawable "parts" by their author: a
  81. // parent part and 0 or more child parts.  Each of the parts can be
  82. // described in "states" (ex: disabled, hot, pressed).
  83. //---------------------------------------------------------------------------
  84. // For the list of all themed classes and the definition of all
  85. // parts and states, see the file "tmschmea.h".
  86. //---------------------------------------------------------------------------
  87. // Each of the below methods takes a "iPartId" param to specify the
  88. // part and a "iStateId" to specify the state of the part.
  89. // "iStateId=0" refers to the root part.  "iPartId" = "0" refers to
  90. // the root class.
  91. //-----------------------------------------------------------------------
  92. // Note: draw operations are always scaled to fit (and not to exceed)
  93. // the specified "Rect".
  94. //-----------------------------------------------------------------------
  96. //------------------------------------------------------------------------
  97. //  DrawThemeBackground()
  98. //                      - draws the theme-specified border and fill for
  99. //                        the "iPartId" and "iStateId".  This could be
  100. //                        based on a bitmap file, a border and fill, or
  101. //                        other image description.
  102. //
  103. //  hTheme              - theme data handle
  104. //  hdc                 - HDC to draw into
  105. //  iPartId             - part number to draw
  106. //  iStateId            - state number (of the part) to draw
  107. //  pRect               - defines the size/location of the part
  108. //  pClipRect           - optional clipping rect (don't draw outside it)
  109. //------------------------------------------------------------------------
  110. THEMEAPI DrawThemeBackground(HTHEME hTheme, HDC hdc,
  111. int iPartId, int iStateId, const RECT *pRect, OPTIONAL const RECT *pClipRect);
  113. //---------------------------------------------------------------------------
  114. //----- DrawThemeText() flags ----
  116. #define DTT_GRAYED      0x1         // draw a grayed-out string
  118. //-------------------------------------------------------------------------
  119. //  DrawThemeText()     - draws the text using the theme-specified
  120. //                        color and font for the "iPartId" and
  121. //                        "iStateId".
  122. //
  123. //  hTheme              - theme data handle
  124. //  hdc                 - HDC to draw into
  125. //  iPartId             - part number to draw
  126. //  iStateId            - state number (of the part) to draw
  127. //  pszText             - actual text to draw
  128. //  dwCharCount         - number of chars to draw (-1 for all)
  129. //  dwTextFlags         - same as DrawText() "uFormat" param
  130. //  dwTextFlags2        - additional drawing options
  131. //  pRect               - defines the size/location of the part
  132. //-------------------------------------------------------------------------
  133. THEMEAPI DrawThemeText(HTHEME hTheme, HDC hdc, int iPartId,
  134. int iStateId, LPCWSTR pszText, int iCharCount, DWORD dwTextFlags,
  135. DWORD dwTextFlags2, const RECT *pRect);
  137. //-------------------------------------------------------------------------
  138. //  GetThemeBackgroundContentRect()
  139. //                      - gets the size of the content for the theme-defined
  140. //                        background.  This is usually the area inside
  141. //                        the borders or Margins.
  142. //
  143. //      hTheme          - theme data handle
  144. //      hdc             - (optional) device content to be used for drawing
  145. //      iPartId         - part number to draw
  146. //      iStateId        - state number (of the part) to draw
  147. //      pBoundingRect   - the outer RECT of the part being drawn
  148. //      pContentRect    - RECT to receive the content area
  149. //-------------------------------------------------------------------------
  150. THEMEAPI GetThemeBackgroundContentRect(HTHEME hTheme, OPTIONAL HDC hdc,
  151. int iPartId, int iStateId,  const RECT *pBoundingRect,
  152. OUT RECT *pContentRect);
  154. //-------------------------------------------------------------------------
  155. //  GetThemeBackgroundExtent() - calculates the size/location of the theme-
  156. //                               specified background based on the
  157. //                               "pContentRect".
  158. //
  159. //      hTheme          - theme data handle
  160. //      hdc             - (optional) device content to be used for drawing
  161. //      iPartId         - part number to draw
  162. //      iStateId        - state number (of the part) to draw
  163. //      pContentRect    - RECT that defines the content area
  164. //      pBoundingRect   - RECT to receive the overall size/location of part
  165. //-------------------------------------------------------------------------
  166. THEMEAPI GetThemeBackgroundExtent(HTHEME hTheme, OPTIONAL HDC hdc,
  167. int iPartId, int iStateId, const RECT *pContentRect,
  168. OUT RECT *pExtentRect);
  170. //-------------------------------------------------------------------------
  171. typedef enum THEMESIZE
  172. {
  173. TS_MIN,             // minimum size
  174. TS_TRUE,            // size without stretching
  175. TS_DRAW,            // size that theme mgr will use to draw part
  176. };
  177. //-------------------------------------------------------------------------
  178. //  GetThemePartSize() - returns the specified size of the theme part
  179. //
  180. //  hTheme              - theme data handle
  181. //  hdc                 - HDC to select font into & measure against
  182. //  iPartId             - part number to retrieve size for
  183. //  iStateId            - state number (of the part)
  184. //  prc                 - (optional) rect for part drawing destination
  185. //  eSize               - the type of size to be retreived
  186. //  psz                 - receives the specified size of the part
  187. //-------------------------------------------------------------------------
  188. THEMEAPI GetThemePartSize(HTHEME hTheme, HDC hdc, int iPartId, int iStateId,
  189. OPTIONAL RECT *prc, enum THEMESIZE eSize, OUT SIZE *psz);
  191. //-------------------------------------------------------------------------
  192. //  GetThemeTextExtent() - calculates the size/location of the specified
  193. //                         text when rendered in the Theme Font.
  194. //
  195. //  hTheme              - theme data handle
  196. //  hdc                 - HDC to select font & measure into
  197. //  iPartId             - part number to draw
  198. //  iStateId            - state number (of the part)
  199. //  pszText             - the text to be measured
  200. //  dwCharCount         - number of chars to draw (-1 for all)
  201. //  dwTextFlags         - same as DrawText() "uFormat" param
  202. //  pszBoundingRect     - optional: to control layout of text
  203. //  pszExtentRect       - receives the RECT for text size/location
  204. //-------------------------------------------------------------------------
  205. THEMEAPI GetThemeTextExtent(HTHEME hTheme, HDC hdc,
  206. int iPartId, int iStateId, LPCWSTR pszText, int iCharCount,
  207. DWORD dwTextFlags, OPTIONAL const RECT *pBoundingRect,
  208. OUT RECT *pExtentRect);
  210. //-------------------------------------------------------------------------
  211. //  GetThemeTextMetrics()
  212. //                      - returns info about the theme-specified font
  213. //                        for the part/state passed in.
  214. //
  215. //  hTheme              - theme data handle
  216. //  hdc                 - optional: HDC for screen context
  217. //  iPartId             - part number to draw
  218. //  iStateId            - state number (of the part)
  219. //  ptm                 - receives the font info
  220. //-------------------------------------------------------------------------
  221. THEMEAPI GetThemeTextMetrics(HTHEME hTheme, OPTIONAL HDC hdc,
  222. int iPartId, int iStateId, OUT TEXTMETRIC* ptm);
  224. //-------------------------------------------------------------------------
  225. //  GetThemeBackgroundRegion()
  226. //                      - computes the region for a regular or partially
  227. //                        transparent theme-specified background that is
  228. //                        bound by the specified "pRect".
  229. //                        If the rectangle is empty, sets the HRGN to NULL
  230. //                        and return S_FALSE.
  231. //
  232. //  hTheme              - theme data handle
  233. //  hdc                 - optional HDC to draw into (DPI scaling)
  234. //  iPartId             - part number to draw
  235. //  iStateId            - state number (of the part)
  236. //  pRect               - the RECT used to draw the part
  237. //  pRegion             - receives handle to calculated region
  238. //-------------------------------------------------------------------------
  239. THEMEAPI GetThemeBackgroundRegion(HTHEME hTheme, OPTIONAL HDC hdc,
  240. int iPartId, int iStateId, const RECT *pRect, OUT HRGN *pRegion);
  242. //-------------------------------------------------------------------------
  243. //----- HitTestThemeBackground, HitTestThemeBackgroundRegion flags ----
  245. //  Theme background segment hit test flag (default). possible return values are:
  246. //  HTCLIENT: hit test succeeded in the middle background segment
  247. //  HTTOP, HTLEFT, HTTOPLEFT, etc:  // hit test succeeded in the the respective theme background segment.
  248. #define HTTB_BACKGROUNDSEG          0x0000
  250. //  Fixed border hit test option.  possible return values are:
  251. //  HTCLIENT: hit test succeeded in the middle background segment
  252. //  HTBORDER: hit test succeeded in any other background segment
  253. #define HTTB_FIXEDBORDER            0x0002  // Return code may be either HTCLIENT or HTBORDER.
  255. //  Caption hit test option.  Possible return values are:
  256. //  HTCAPTION: hit test succeeded in the top, top left, or top right background segments
  257. //  HTNOWHERE or another return code, depending on absence or presence of accompanying flags, resp.
  258. #define HTTB_CAPTION                0x0004
  260. //  Resizing border hit test flags.  Possible return values are:
  261. //  HTCLIENT: hit test succeeded in middle background segment
  262. //  HTTOP, HTTOPLEFT, HTLEFT, HTRIGHT, etc:    hit test succeeded in the respective system resizing zone
  263. //  HTBORDER: hit test failed in middle segment and resizing zones, but succeeded in a background border segment
  264. #define HTTB_RESIZINGBORDER_LEFT    0x0010  // Hit test left resizing border,
  265. #define HTTB_RESIZINGBORDER_TOP     0x0020  // Hit test top resizing border
  266. #define HTTB_RESIZINGBORDER_RIGHT   0x0040  // Hit test right resizing border
  267. #define HTTB_RESIZINGBORDER_BOTTOM  0x0080  // Hit test bottom resizing border
  269. #define HTTB_RESIZINGBORDER         (HTTB_RESIZINGBORDER_LEFT | HTTB_RESIZINGBORDER_TOP | 
  270. HTTB_RESIZINGBORDER_RIGHT | HTTB_RESIZINGBORDER_BOTTOM)
  272. // Resizing border is specified as a template, not just window edges.
  273. // This option is mutually exclusive with HTTB_SYSTEMSIZINGWIDTH; HTTB_SIZINGTEMPLATE takes precedence
  274. #define HTTB_SIZINGTEMPLATE      0x0100
  276. // Use system resizing border width rather than theme content margins.
  277. // This option is mutually exclusive with HTTB_SIZINGTEMPLATE, which takes precedence.
  278. #define HTTB_SYSTEMSIZINGMARGINS 0x0200
  280. //-------------------------------------------------------------------------
  281. //  HitTestThemeBackground()
  282. //                      - returns a HitTestCode (a subset of the values
  283. //                        returned by WM_NCHITTEST) for the point "ptTest"
  284. //                        within the theme-specified background
  285. //                        (bound by pRect).  "pRect" and "ptTest" should
  286. //                        both be in the same coordinate system
  287. //                        (client, screen, etc).
  288. //
  289. //      hTheme          - theme data handle
  290. //      hdc             - HDC to draw into
  291. //      iPartId         - part number to test against
  292. //      iStateId        - state number (of the part)
  293. //      pRect           - the RECT used to draw the part
  294. //      hrgn            - optional region to use; must be in same coordinates as
  295. //                      -    pRect and pTest.
  296. //      ptTest          - the hit point to be tested
  297. //      dwOptions       - HTTB_xxx constants
  298. //      pwHitTestCode   - receives the returned hit test code - one of:
  299. //
  300. //                        HTNOWHERE, HTLEFT, HTTOPLEFT, HTBOTTOMLEFT,
  301. //                        HTRIGHT, HTTOPRIGHT, HTBOTTOMRIGHT,
  302. //                        HTTOP, HTBOTTOM, HTCLIENT
  303. //-------------------------------------------------------------------------
  304. THEMEAPI HitTestThemeBackground(HTHEME hTheme, OPTIONAL HDC hdc, int iPartId,
  305. int iStateId, DWORD dwOptions, const RECT *pRect, OPTIONAL HRGN hrgn,
  306. POINT ptTest, OUT WORD *pwHitTestCode);
  308. //------------------------------------------------------------------------
  309. //  DrawThemeEdge()     - Similar to the DrawEdge() API, but uses part colors
  310. //                        and is high-DPI aware
  311. //  hTheme              - theme data handle
  312. //  hdc                 - HDC to draw into
  313. //  iPartId             - part number to draw
  314. //  iStateId            - state number of part
  315. //  pDestRect           - the RECT used to draw the line(s)
  316. //  uEdge               - Same as DrawEdge() API
  317. //  uFlags              - Same as DrawEdge() API
  318. //  pContentRect        - Receives the interior rect if (uFlags & BF_ADJUST)
  319. //------------------------------------------------------------------------
  320. THEMEAPI DrawThemeEdge(HTHEME hTheme, HDC hdc, int iPartId, int iStateId,
  321.    const RECT *pDestRect, UINT uEdge, UINT uFlags, OPTIONAL OUT RECT *pContentRect);
  323. //------------------------------------------------------------------------
  324. //  DrawThemeIcon()     - draws an image within an imagelist based on
  325. //                        a (possible) theme-defined effect.
  326. //
  327. //  hTheme              - theme data handle
  328. //  hdc                 - HDC to draw into
  329. //  iPartId             - part number to draw
  330. //  iStateId            - state number of part
  331. //  pRect               - the RECT to draw the image within
  332. //  himl                - handle to IMAGELIST
  333. //  iImageIndex         - index into IMAGELIST (which icon to draw)
  334. //------------------------------------------------------------------------
  335. THEMEAPI DrawThemeIcon(HTHEME hTheme, HDC hdc, int iPartId,
  336. int iStateId, const RECT *pRect, HIMAGELIST himl, int iImageIndex);
  338. //---------------------------------------------------------------------------
  339. //  IsThemePartDefined() - returns TRUE if the theme has defined parameters
  340. //                         for the specified "iPartId" and "iStateId".
  341. //
  342. //  hTheme              - theme data handle
  343. //  iPartId             - part number to find definition for
  344. //  iStateId            - state number of part
  345. //---------------------------------------------------------------------------
  346. THEMEAPI_(BOOL) IsThemePartDefined(HTHEME hTheme, int iPartId,
  347. int iStateId);
  349. //---------------------------------------------------------------------------
  350. //  IsThemeBackgroundPartiallyTransparent()
  351. //                      - returns TRUE if the theme specified background for
  352. //                        the part/state has transparent pieces or
  353. //                        alpha-blended pieces.
  354. //
  355. //  hTheme              - theme data handle
  356. //  iPartId             - part number
  357. //  iStateId            - state number of part
  358. //---------------------------------------------------------------------------
  359. THEMEAPI_(BOOL) IsThemeBackgroundPartiallyTransparent(HTHEME hTheme,
  360. int iPartId, int iStateId);
  362. //---------------------------------------------------------------------------
  363. //    lower-level theme information services
  364. //---------------------------------------------------------------------------
  365. // The following methods are getter routines for each of the Theme Data types.
  366. // Controls/Windows are defined in drawable "parts" by their author: a
  367. // parent part and 0 or more child parts.  Each of the parts can be
  368. // described in "states" (ex: disabled, hot, pressed).
  369. //---------------------------------------------------------------------------
  370. // Each of the below methods takes a "iPartId" param to specify the
  371. // part and a "iStateId" to specify the state of the part.
  372. // "iStateId=0" refers to the root part.  "iPartId" = "0" refers to
  373. // the root class.
  374. //-----------------------------------------------------------------------
  375. // Each method also take a "iPropId" param because multiple instances of
  376. // the same primitive type can be defined in the theme schema.
  377. //-----------------------------------------------------------------------
  380. //-----------------------------------------------------------------------
  381. //  GetThemeColor()     - Get the value for the specified COLOR property
  382. //
  383. //  hTheme              - theme data handle
  384. //  iPartId             - part number
  385. //  iStateId            - state number of part
  386. //  iPropId             - the property number to get the value for
  387. //  pColor              - receives the value of the property
  388. //-----------------------------------------------------------------------
  389. THEMEAPI GetThemeColor(HTHEME hTheme, int iPartId,
  390. int iStateId, int iPropId, OUT COLORREF *pColor);
  392. //-----------------------------------------------------------------------
  393. //  GetThemeMetric()    - Get the value for the specified metric/size
  394. //                        property
  395. //
  396. //  hTheme              - theme data handle
  397. //  hdc                 - (optional) hdc to be drawn into (DPI scaling)
  398. //  iPartId             - part number
  399. //  iStateId            - state number of part
  400. //  iPropId             - the property number to get the value for
  401. //  piVal               - receives the value of the property
  402. //-----------------------------------------------------------------------
  403. THEMEAPI GetThemeMetric(HTHEME hTheme, OPTIONAL HDC hdc, int iPartId,
  404. int iStateId, int iPropId, OUT int *piVal);
  406. //-----------------------------------------------------------------------
  407. //  GetThemeString()    - Get the value for the specified string property
  408. //
  409. //  hTheme              - theme data handle
  410. //  iPartId             - part number
  411. //  iStateId            - state number of part
  412. //  iPropId             - the property number to get the value for
  413. //  pszBuff             - receives the string property value
  414. //  cchMaxBuffChars     - max. number of chars allowed in pszBuff
  415. //-----------------------------------------------------------------------
  416. THEMEAPI GetThemeString(HTHEME hTheme, int iPartId,
  417. int iStateId, int iPropId, OUT LPWSTR pszBuff, int cchMaxBuffChars);
  419. //-----------------------------------------------------------------------
  420. //  GetThemeBool()      - Get the value for the specified BOOL property
  421. //
  422. //  hTheme              - theme data handle
  423. //  iPartId             - part number
  424. //  iStateId            - state number of part
  425. //  iPropId             - the property number to get the value for
  426. //  pfVal               - receives the value of the property
  427. //-----------------------------------------------------------------------
  428. THEMEAPI GetThemeBool(HTHEME hTheme, int iPartId,
  429. int iStateId, int iPropId, OUT BOOL *pfVal);
  431. //-----------------------------------------------------------------------
  432. //  GetThemeInt()       - Get the value for the specified int property
  433. //
  434. //  hTheme              - theme data handle
  435. //  iPartId             - part number
  436. //  iStateId            - state number of part
  437. //  iPropId             - the property number to get the value for
  438. //  piVal               - receives the value of the property
  439. //-----------------------------------------------------------------------
  440. THEMEAPI GetThemeInt(HTHEME hTheme, int iPartId,
  441. int iStateId, int iPropId, OUT int *piVal);
  443. //-----------------------------------------------------------------------
  444. //  GetThemeEnumValue() - Get the value for the specified ENUM property
  445. //
  446. //  hTheme              - theme data handle
  447. //  iPartId             - part number
  448. //  iStateId            - state number of part
  449. //  iPropId             - the property number to get the value for
  450. //  piVal               - receives the value of the enum (cast to int*)
  451. //-----------------------------------------------------------------------
  452. THEMEAPI GetThemeEnumValue(HTHEME hTheme, int iPartId,
  453. int iStateId, int iPropId, OUT int *piVal);
  455. //-----------------------------------------------------------------------
  456. //  GetThemePosition()  - Get the value for the specified position
  457. //                        property
  458. //
  459. //  hTheme              - theme data handle
  460. //  iPartId             - part number
  461. //  iStateId            - state number of part
  462. //  iPropId             - the property number to get the value for
  463. //  pPoint              - receives the value of the position property
  464. //-----------------------------------------------------------------------
  465. THEMEAPI GetThemePosition(HTHEME hTheme, int iPartId,
  466. int iStateId, int iPropId, OUT POINT *pPoint);
  468. //-----------------------------------------------------------------------
  469. //  GetThemeFont()      - Get the value for the specified font property
  470. //
  471. //  hTheme              - theme data handle
  472. //  hdc                 - (optional) hdc to be drawn to (DPI scaling)
  473. //  iPartId             - part number
  474. //  iStateId            - state number of part
  475. //  iPropId             - the property number to get the value for
  476. //  pFont               - receives the value of the LOGFONT property
  477. //                        (scaled for the current logical screen dpi)
  478. //-----------------------------------------------------------------------
  479. THEMEAPI GetThemeFont(HTHEME hTheme, OPTIONAL HDC hdc, int iPartId,
  480. int iStateId, int iPropId, OUT LOGFONT *pFont);
  482. //-----------------------------------------------------------------------
  483. //  GetThemeRect()      - Get the value for the specified RECT property
  484. //
  485. //  hTheme              - theme data handle
  486. //  iPartId             - part number
  487. //  iStateId            - state number of part
  488. //  iPropId             - the property number to get the value for
  489. //  pRect               - receives the value of the RECT property
  490. //-----------------------------------------------------------------------
  491. THEMEAPI GetThemeRect(HTHEME hTheme, int iPartId,
  492. int iStateId, int iPropId, OUT RECT *pRect);
  494. //-----------------------------------------------------------------------
  495. typedef struct _MARGINS
  496. {
  497. int cxLeftWidth;      // width of left border that retains its size
  498. int cxRightWidth;     // width of right border that retains its size
  499. int cyTopHeight;      // height of top border that retains its size
  500. int cyBottomHeight;   // height of bottom border that retains its size
  501. } MARGINS, *PMARGINS;
  503. //-----------------------------------------------------------------------
  504. //  GetThemeMargins()   - Get the value for the specified MARGINS property
  505. //
  506. //      hTheme          - theme data handle
  507. //      hdc             - (optional) hdc to be used for drawing
  508. //      iPartId         - part number
  509. //      iStateId        - state number of part
  510. //      iPropId         - the property number to get the value for
  511. //      prc             - RECT for area to be drawn into
  512. //      pMargins        - receives the value of the MARGINS property
  513. //-----------------------------------------------------------------------
  514. THEMEAPI GetThemeMargins(HTHEME hTheme, OPTIONAL HDC hdc, int iPartId,
  515. int iStateId, int iPropId, OPTIONAL RECT *prc, OUT MARGINS *pMargins);
  517. //-----------------------------------------------------------------------
  518. #define MAX_INTLIST_COUNT 10
  520. typedef struct _INTLIST
  521. {
  522. int iValueCount;      // number of values in iValues
  523. int iValues[MAX_INTLIST_COUNT];
  524. } INTLIST, *PINTLIST;
  526. //-----------------------------------------------------------------------
  527. //  GetThemeIntList()   - Get the value for the specified INTLIST struct
  528. //
  529. //      hTheme          - theme data handle
  530. //      iPartId         - part number
  531. //      iStateId        - state number of part
  532. //      iPropId         - the property number to get the value for
  533. //      pIntList        - receives the value of the INTLIST property
  534. //-----------------------------------------------------------------------
  535. THEMEAPI GetThemeIntList(HTHEME hTheme, int iPartId,
  536. int iStateId, int iPropId, OUT INTLIST *pIntList);
  538. //-----------------------------------------------------------------------
  539. typedef enum PROPERTYORIGIN
  540. {
  541. PO_STATE,           // property was found in the state section
  542. PO_PART,            // property was found in the part section
  543. PO_CLASS,           // property was found in the class section
  544. PO_GLOBAL,          // property was found in [globals] section
  545. PO_NOTFOUND         // property was not found
  546. };
  548. //-----------------------------------------------------------------------
  549. //  GetThemePropertyOrigin()
  550. //                      - searches for the specified theme property
  551. //                        and sets "pOrigin" to indicate where it was
  552. //                        found (or not found)
  553. //
  554. //  hTheme              - theme data handle
  555. //  iPartId             - part number
  556. //  iStateId            - state number of part
  557. //  iPropId             - the property number to search for
  558. //  pOrigin             - receives the value of the property origin
  559. //-----------------------------------------------------------------------
  560. THEMEAPI GetThemePropertyOrigin(HTHEME hTheme, int iPartId,
  561. int iStateId, int iPropId, OUT enum PROPERTYORIGIN *pOrigin);
  563. //---------------------------------------------------------------------------
  564. //  SetWindowTheme()
  565. //                      - redirects an existing Window to use a different
  566. //                        section of the current theme information than its
  567. //                        class normally asks for.
  568. //
  569. //  hwnd                - the handle of the window (cannot be NULL)
  570. //
  571. //  pszSubAppName       - app (group) name to use in place of the calling
  572. //                        app's name.  If NULL, the actual calling app
  573. //                        name will be used.
  574. //
  575. //  pszSubIdList        - semicolon separated list of class Id names to
  576. //                        use in place of actual list passed by the
  577. //                        window's class.  if NULL, the id list from the
  578. //                        calling class is used.
  579. //---------------------------------------------------------------------------
  580. // The Theme Manager will remember the "pszSubAppName" and the
  581. // "pszSubIdList" associations thru the lifetime of the window (even
  582. // if themes are subsequently changed).  The window is sent a
  583. // "WM_THEMECHANGED" msg at the end of this call, so that the new
  584. // theme can be found and applied.
  585. //---------------------------------------------------------------------------
  586. // When "pszSubAppName" or "pszSubIdList" are NULL, the Theme Manager
  587. // removes the previously remember association.  To turn off theme-ing for
  588. // the specified window, you can pass an empty string (L"") so it
  589. // won't match any section entries.
  590. //---------------------------------------------------------------------------
  591. THEMEAPI SetWindowTheme(HWND hwnd, LPCWSTR pszSubAppName,
  592. LPCWSTR pszSubIdList);
  594. //---------------------------------------------------------------------------
  595. //  GetThemeFilename()  - Get the value for the specified FILENAME property.
  596. //
  597. //  hTheme              - theme data handle
  598. //  iPartId             - part number
  599. //  iStateId            - state number of part
  600. //  iPropId             - the property number to search for
  601. //  pszThemeFileName    - output buffer to receive the filename
  602. //  cchMaxBuffChars     - the size of the return buffer, in chars
  603. //---------------------------------------------------------------------------
  604. THEMEAPI GetThemeFilename(HTHEME hTheme, int iPartId,
  605. int iStateId, int iPropId, OUT LPWSTR pszThemeFileName, int cchMaxBuffChars);
  607. //---------------------------------------------------------------------------
  608. //  GetThemeSysColor()  - Get the value of the specified System color.
  609. //
  610. //  hTheme              - the theme data handle.  if non-NULL, will return
  611. //                        color from [SysMetrics] section of theme.
  612. //                        if NULL, will return the global system color.
  613. //
  614. //  iColorId            - the system color index defined in winuser.h
  615. //---------------------------------------------------------------------------
  616. THEMEAPI_(COLORREF) GetThemeSysColor(HTHEME hTheme, int iColorId);
  618. //---------------------------------------------------------------------------
  619. //  GetThemeSysColorBrush()
  620. //                      - Get the brush for the specified System color.
  621. //
  622. //  hTheme              - the theme data handle.  if non-NULL, will return
  623. //                        brush matching color from [SysMetrics] section of
  624. //                        theme.  if NULL, will return the brush matching
  625. //                        global system color.
  626. //
  627. //  iColorId            - the system color index defined in winuser.h
  628. //---------------------------------------------------------------------------
  629. THEMEAPI_(HBRUSH) GetThemeSysColorBrush(HTHEME hTheme, int iColorId);
  631. //---------------------------------------------------------------------------
  632. //  GetThemeSysBool()   - Get the boolean value of specified System metric.
  633. //
  634. //  hTheme              - the theme data handle.  if non-NULL, will return
  635. //                        BOOL from [SysMetrics] section of theme.
  636. //                        if NULL, will return the specified system boolean.
  637. //
  638. //  iBoolId             - the TMT_XXX BOOL number (first BOOL
  639. //                        is TMT_FLATMENUS)
  640. //---------------------------------------------------------------------------
  641. THEMEAPI_(BOOL) GetThemeSysBool(HTHEME hTheme, int iBoolId);
  643. //---------------------------------------------------------------------------
  644. //  GetThemeSysSize()   - Get the value of the specified System size metric.
  645. //                        (scaled for the current logical screen dpi)
  646. //
  647. //  hTheme              - the theme data handle.  if non-NULL, will return
  648. //                        size from [SysMetrics] section of theme.
  649. //                        if NULL, will return the global system metric.
  650. //
  651. //  iSizeId             - the following values are supported when
  652. //                        hTheme is non-NULL:
  653. //
  654. //                          SM_CXBORDER   (border width)
  655. //                          SM_CXVSCROLL  (scrollbar width)
  656. //                          SM_CYHSCROLL  (scrollbar height)
  657. //                          SM_CXSIZE     (caption width)
  658. //                          SM_CYSIZE     (caption height)
  659. //                          SM_CXSMSIZE   (small caption width)
  660. //                          SM_CYSMSIZE   (small caption height)
  661. //                          SM_CXMENUSIZE (menubar width)
  662. //                          SM_CYMENUSIZE (menubar height)
  663. //
  664. //                        when hTheme is NULL, iSizeId is passed directly
  665. //                        to the GetSystemMetrics() function
  666. //---------------------------------------------------------------------------
  667. THEMEAPI_(int) GetThemeSysSize(HTHEME hTheme, int iSizeId);
  669. //---------------------------------------------------------------------------
  670. //  GetThemeSysFont()   - Get the LOGFONT for the specified System font.
  671. //
  672. //  hTheme              - the theme data handle.  if non-NULL, will return
  673. //                        font from [SysMetrics] section of theme.
  674. //                        if NULL, will return the specified system font.
  675. //
  676. //  iFontId             - the TMT_XXX font number (first font
  677. //                        is TMT_CAPTIONFONT)
  678. //
  679. //  plf                 - ptr to LOGFONT to receive the font value.
  680. //                        (scaled for the current logical screen dpi)
  681. //---------------------------------------------------------------------------
  682. THEMEAPI GetThemeSysFont(HTHEME hTheme, int iFontId, OUT LOGFONT* plf);
  684. //---------------------------------------------------------------------------
  685. //  GetThemeSysString() - Get the value of specified System string metric.
  686. //
  687. //  hTheme              - the theme data handle (required)
  688. //
  689. //  iStringId           - must be one of the following values:
  690. //
  691. //                          TMT_CSSNAME
  692. //                          TMT_XMLNAME
  693. //
  694. //  pszStringBuff       - the buffer to receive the string value
  695. //
  696. //  cchMaxStringChars   - max. number of chars that pszStringBuff can hold
  697. //---------------------------------------------------------------------------
  698. THEMEAPI GetThemeSysString(HTHEME hTheme, int iStringId,
  699. OUT LPWSTR pszStringBuff, int cchMaxStringChars);
  701. //---------------------------------------------------------------------------
  702. //  GetThemeSysInt() - Get the value of specified System int.
  703. //
  704. //  hTheme              - the theme data handle (required)
  705. //
  706. //  iIntId              - must be one of the following values:
  707. //
  708. //                          TMT_DPIX
  709. //                          TMT_DPIY
  710. //                          TMT_MINCOLORDEPTH
  711. //
  712. //  piValue             - ptr to int to receive value
  713. //---------------------------------------------------------------------------
  714. THEMEAPI GetThemeSysInt(HTHEME hTheme, int iIntId, int* piValue);
  716. //---------------------------------------------------------------------------
  717. //  IsThemeActive()     - can be used to test if a system theme is active
  718. //                        for the current user session.
  719. //
  720. //                        use the API "IsAppThemed()" to test if a theme is
  721. //                        active for the calling process.
  722. //---------------------------------------------------------------------------
  723. THEMEAPI_(BOOL) IsThemeActive();
  725. //---------------------------------------------------------------------------
  726. //  IsAppThemed()       - returns TRUE if a theme is active and available to
  727. //                        the current process
  728. //---------------------------------------------------------------------------
  729. THEMEAPI_(BOOL) IsAppThemed();
  732. //---------------------------------------------------------------------------
  733. //  GetWindowTheme()    - if window is themed, returns its most recent
  734. //                        HTHEME from OpenThemeData() - otherwise, returns
  735. //                        NULL.
  736. //
  737. //      hwnd            - the window to get the HTHEME of
  738. //---------------------------------------------------------------------------
  739. THEMEAPI_(HTHEME) GetWindowTheme(HWND hwnd);
  742. //---------------------------------------------------------------------------
  743. //  EnableThemeDialogTexture()
  744. //
  745. //  - Enables/disables dialog background theme.  This method can be used to
  746. //    tailor dialog compatibility with child windows and controls that
  747. //    may or may not coordinate the rendering of their client area backgrounds
  748. //    with that of their parent dialog in a manner that supports seamless
  749. //    background texturing.
  750. //
  751. //      hdlg         - the window handle of the target dialog
  752. //      dwFlags      - ETDT_ENABLE to enable the theme-defined dialog background texturing,
  753. //                     ETDT_DISABLE to disable background texturing,
  754. //                     ETDT_ENABLETAB to enable the theme-defined background
  755. //                          texturing using the Tab texture
  756. //---------------------------------------------------------------------------
  758. #define ETDT_DISABLE        0x00000001
  759. #define ETDT_ENABLE         0x00000002
  760. #define ETDT_USETABTEXTURE  0x00000004
  761. #define ETDT_ENABLETAB      (ETDT_ENABLE  | ETDT_USETABTEXTURE)
  763. THEMEAPI EnableThemeDialogTexture(HWND hwnd, DWORD dwFlags);
  766. //---------------------------------------------------------------------------
  767. //  IsThemeDialogTextureEnabled()
  768. //
  769. //  - Reports whether the dialog supports background texturing.
  770. //
  771. //      hdlg         - the window handle of the target dialog
  772. //---------------------------------------------------------------------------
  773. THEMEAPI_(BOOL) IsThemeDialogTextureEnabled(HWND hwnd);
  776. //---------------------------------------------------------------------------
  777. //---- flags to control theming within an app ----
  779. #define STAP_ALLOW_NONCLIENT    (1 << 0)
  780. #define STAP_ALLOW_CONTROLS     (1 << 1)
  781. #define STAP_ALLOW_WEBCONTENT   (1 << 2)
  783. //---------------------------------------------------------------------------
  784. //  GetThemeAppProperties()
  785. //                      - returns the app property flags that control theming
  786. //---------------------------------------------------------------------------
  787. THEMEAPI_(DWORD) GetThemeAppProperties();
  789. //---------------------------------------------------------------------------
  790. //  SetThemeAppProperties()
  791. //                      - sets the flags that control theming within the app
  792. //
  793. //      dwFlags         - the flag values to be set
  794. //---------------------------------------------------------------------------
  795. THEMEAPI_(void) SetThemeAppProperties(DWORD dwFlags);
  797. //---------------------------------------------------------------------------
  798. //  GetCurrentThemeName()
  799. //                      - Get the name of the current theme in-use.
  800. //                        Optionally, return the ColorScheme name and the
  801. //                        Size name of the theme.
  802. //
  803. //  pszThemeFileName    - receives the theme path & filename
  804. //  cchMaxNameChars     - max chars allowed in pszNameBuff
  805. //
  806. //  pszColorBuff        - (optional) receives the canonical color scheme name
  807. //                        (not the display name)
  808. //  cchMaxColorChars    - max chars allowed in pszColorBuff
  809. //
  810. //  pszSizeBuff         - (optional) receives the canonical size name
  811. //                        (not the display name)
  812. //  cchMaxSizeChars     - max chars allowed in pszSizeBuff
  813. //---------------------------------------------------------------------------
  814. THEMEAPI GetCurrentThemeName(
  815. OUT LPWSTR pszThemeFileName, int cchMaxNameChars,
  816. OUT OPTIONAL LPWSTR pszColorBuff, int cchMaxColorChars,
  817. OUT OPTIONAL LPWSTR pszSizeBuff, int cchMaxSizeChars);
  819. //---------------------------------------------------------------------------
  820. //  GetThemeDocumentationProperty()
  821. //                      - Get the value for the specified property name from
  822. //                        the [documentation] section of the themes.ini file
  823. //                        for the specified theme.  If the property has been
  824. //                        localized in the theme files string table, the
  825. //                        localized version of the property value is returned.
  826. //
  827. //  pszThemeFileName    - filename of the theme file to query
  828. //  pszPropertyName     - name of the string property to retreive a value for
  829. //  pszValueBuff        - receives the property string value
  830. //  cchMaxValChars      - max chars allowed in pszValueBuff
  831. //---------------------------------------------------------------------------
  832. #define SZ_THDOCPROP_DISPLAYNAME                L"DisplayName"
  833. #define SZ_THDOCPROP_CANONICALNAME              L"ThemeName"
  834. #define SZ_THDOCPROP_TOOLTIP                    L"ToolTip"
  835. #define SZ_THDOCPROP_AUTHOR                     L"author"
  837. THEMEAPI GetThemeDocumentationProperty(LPCWSTR pszThemeName,
  838. LPCWSTR pszPropertyName, OUT LPWSTR pszValueBuff, int cchMaxValChars);
  840. //---------------------------------------------------------------------------
  841. //  Theme API Error Handling
  842. //
  843. //      All functions in the Theme API not returning an HRESULT (THEMEAPI_)
  844. //      use the WIN32 function "SetLastError()" to record any call failures.
  845. //
  846. //      To retreive the error code of the last failure on the
  847. //      current thread for these type of API's, use the WIN32 function
  848. //      "GetLastError()".
  849. //
  850. //      All Theme API error codes (HRESULT's and GetLastError() values)
  851. //      should be normal win32 errors which can be formatted into
  852. //      strings using the Win32 API FormatMessage().
  853. //---------------------------------------------------------------------------
  855. //---------------------------------------------------------------------------
  856. // DrawThemeParentBackground()
  857. //                      - used by partially-transparent or alpha-blended
  858. //                        child controls to draw the part of their parent
  859. //                        that they appear in front of.
  860. //
  861. //  hwnd                - handle of the child control
  863. //  hdc                 - hdc of the child control
  865. //  prc                 - (optional) rect that defines the area to be
  866. //                        drawn (CHILD coordinates)
  867. //---------------------------------------------------------------------------
  868. THEMEAPI DrawThemeParentBackground(HWND hwnd, HDC hdc, OPTIONAL RECT* prc);
  870. //---------------------------------------------------------------------------
  871. //  EnableTheming()     - enables or disables themeing for the current user
  872. //                        in the current and future sessions.
  873. //
  874. //  fEnable             - if FALSE, disable theming & turn themes off.
  875. //                      - if TRUE, enable themeing and, if user previously
  876. //                        had a theme active, make it active now.
  877. //---------------------------------------------------------------------------
  878. THEMEAPI EnableTheming(BOOL fEnable);
  880. //------------------------------------------------------------------------
  881. //---- bits used in dwFlags of DTBGOPTS ----
  882. #define DTBG_CLIPRECT        0x00000001   // rcClip has been specified
  883. #define DTBG_DRAWSOLID       0x00000002   // draw transparent/alpha images as solid
  884. #define DTBG_OMITBORDER      0x00000004   // don't draw border of part
  885. #define DTBG_OMITCONTENT     0x00000008   // don't draw content area of part
  887. #define DTBG_COMPUTINGREGION 0x00000010   // TRUE if calling to compute region
  889. #define DTBG_MIRRORDC        0x00000020   // assume the hdc is mirrorred and
  890.                                           // flip images as appropriate (currently
  891.                                           // only supported for bgtype=imagefile)
  892. //------------------------------------------------------------------------
  893. typedef struct _DTBGOPTS
  894. {
  895. DWORD dwSize;           // size of the struct
  896. DWORD dwFlags;          // which options have been specified
  897. RECT rcClip;            // clipping rectangle
  898. }
  899. DTBGOPTS, *PDTBGOPTS;
  901. //------------------------------------------------------------------------
  902. //  DrawThemeBackgroundEx()
  903. //                      - draws the theme-specified border and fill for
  904. //                        the "iPartId" and "iStateId".  This could be
  905. //                        based on a bitmap file, a border and fill, or
  906. //                        other image description.  NOTE: This will be
  907. //                        merged back into DrawThemeBackground() after
  908. //                        BETA 2.
  909. //
  910. //  hTheme              - theme data handle
  911. //  hdc                 - HDC to draw into
  912. //  iPartId             - part number to draw
  913. //  iStateId            - state number (of the part) to draw
  914. //  pRect               - defines the size/location of the part
  915. //  pOptions            - ptr to optional params
  916. //------------------------------------------------------------------------
  917. THEMEAPI DrawThemeBackgroundEx(HTHEME hTheme, HDC hdc,
  918. int iPartId, int iStateId, const RECT *pRect, OPTIONAL const DTBGOPTS *pOptions);
  921. //---------------------------------------------------------------------------
  922. //#endif  /* (_WIN32_WINNT >= 0x0500) *//
  923. //---------------------------------------------------------------------------
  924. #endif // _UXTHEME_H_
  925. //---------------------------------------------------------------------------