# Function Reference

# _WinAPI_GetThemeBitmap

Retrieves the bitmap associated with a particular theme, part, state, and property

#include <WinAPITheme.au3>
_WinAPI_GetThemeBitmap ( $hTheme, $iPartID, $iStateID, $iPropID [, $iFlag = $GBF_DIRECT] )

## Parameters

$hTheme | Handle to a window's specified theme data.
$iPartID | The part that contains the bitmap.
$iStateID | The state of the part.
$iPropID | The property to retrieve. Set this parameter to 0 to automatically select the first available bitmap for this part and state, or use one of the following values. $TMT_DIBDATA $TMT_GLYPHDIBDATA $TMT_HBITMAP
$iFlag | [optional] This parameter can be one of the following values. $GBF_DIRECT (Default) $GBF_COPY $GBF_VALIDBITS

## Return Value

Success: | Handle to the requested bitmap.
Failure: | Sets the @error flag to non-zero, @extended flag may contain the HRESULT error code.

## Remarks

If $iFlag is set to $GBF_COPY, release the bitmap returned by this function when no longer needed by calling
_WinAPI_DeleteObject().
This function requires Windows Vista or later.

## Related

_WinAPI_DeleteObject

## See Also

Search GetThemeBitmap in MSDN Library.