Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
GetThemeBool
Collapse the table of content
Expand the table of content

GetThemeBool function

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

hTheme [in]

Type: HTHEME

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

iPartId [in]

Type: int

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

iStateId [in]

Type: int

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

iPropId [in]

Type: int

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

ValueMeaning
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.

 

pfVal [out]

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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Uxtheme.h

Library

UxTheme.lib

DLL

UxTheme.dll

See also

Property Identifiers

 

 

Community Additions

ADD
Show:
© 2015 Microsoft