EnumThemeColors(3w)

EnumThemeColors3w

Usage

HRESULT EnumThemeColors
(
LPWSTR pszThemeFileName,
LPWSTR pszSizeName,
DWORD dwColorNum,
PTHEMENAMES pszColorNames
)

Overview

Enumerate theme colors available with a particular size.

Params

pszThemeFileName Path to a msstyles theme file

pszSizeName Theme size to enumerate available colors

If NULL the default theme size is used

dwColorNum Color index to retrieve, increment from 0

pszColorNames Output color names.

Returns

S_OK on success E_PROP_ID_UNSUPPORTED when dwColorName does not refer to a color or when pszSizeName does not refer to a valid size.

Notes

XP fails with E_POINTER when pszColorNames points to a buffer smaller than sizeof(THEMENAMES).

Not very efficient that I'm opening & validating the theme every call, but this is undocumented and almost never called.. (and this is how Windows(tm) works too)

Implementation

Exported by ordinal only. Use GetProcAddress(3w) to obtain a pointer to the function.

Implemented in "dlls/uxtheme/system.c".

Debug channel "uxtheme".

Releases

4 releases since Debian 4.0 (Etch); the text changed 3 times.

  1. 4.0
  2. 5.0
  3. 6.0
  4. 7

From libwine-dev 1.4.1-4 in Debian 7 (Wheezy). Parsed by carta from the page's man source.