Edit

GetThemeBool function (uxtheme.h)

  • Article

Retrieves the value of a BOOL property from the SysMetrics section of theme data.

Syntax

HRESULT GetThemeBool(
  [in]  HTHEME hTheme,
  [in]  int    iPartId,
  [in]  int    iStateId,
  [in]  int    iPropId,
  [out] BOOL   *pfVal
);

Parameters

[in] hTheme

Type: HTHEME

Handle to a window's specified theme data. Use OpenThemeData to create an HTHEME.

[in] iPartId

Type: int

Value of type int that specifies the part containing the BOOL property. See Parts and States.

[in] iStateId

Type: int

Value of type int that specifies the state of the part. See Parts and States.

[in] iPropId

Type: int

Value of type int that specifies the property to retrieve. May be one of the following values.

Value Meaning
TMT_TRANSPARENT
 TRUE if the image associated with the part and state have transparent areas. See GetThemeColor for the definition of the TMT_TRANSPARENTCOLOR value that defines the transparent color.
TMT_AUTOSIZE
 TRUE if the nonclient caption area associated with the part and state vary with text width.
TMT_BORDERONLY
 TRUE if the image associated with the part and state should only have its border drawn.
TMT_COMPOSITED
 TRUE if the control associated with the part and state will handle its own compositing of images.
TMT_BGFILL
 TRUE if true-sized images associated with this part and state are to be drawn on the background fill.
TMT_GLYPHTRANSPARENT
 TRUE if the glyph associated with this part and state have transparent areas. See GetThemeColor for the definition of the TMT_GLYPHCOLOR value that defines the transparent color.
TMT_GLYPHONLY
 TRUE if the glyph associated with this part and state should be drawn without a background.
TMT_ALWAYSSHOWSIZINGBAR
 TRUE if the sizing bar associated with this part and state should always be shown.
TMT_MIRRORIMAGE
 TRUE if the image associated with this part and state should be flipped if the window is being viewed in right-to-left reading mode.
TMT_UNIFORMSIZING
 TRUE if the image associated with this part and state must have equal height and width.
TMT_INTEGRALSIZING
 TRUE if the truesize image or border associated with this part and state must be sized to a factor of 2.
TMT_SOURCEGROW
 TRUE if the image associated with this part and state will scale larger in size if necessary.
TMT_SOURCESHRINK
 TRUE if the image associated with this part and state will scale smaller in size if necessary.
TMT_USERPICTURE
 TRUE if the image associated with this part and state is based on the current user.

[out] pfVal

Type: BOOL*

Pointer to a BOOL that receives the retrieved property value.

Return value

Type: HRESULT

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header uxtheme.h
Library UxTheme.lib
DLL UxTheme.dll

See also

Property Identifiers