BUTTON_IMAGELIST structure (commctrl.h)

Contains information about an image list that is used with a button control.

Syntax

typedef struct {
  HIMAGELIST himl;
  RECT       margin;
  UINT       uAlign;
} BUTTON_IMAGELIST, *PBUTTON_IMAGELIST;

Members

himl

Type: HIMAGELIST

A handle to the image list. The provider retains ownership of the image list and is ultimately responsible for its disposal. Under Windows Vista, you can pass BCCL_NOGLYPH in this parameter to indicate that no glyph should be displayed.

margin

Type: RECT

A RECT that specifies the margin around the icon.

uAlign

Type: UINT

A UINT that specifies the alignment to use. This parameter can be one of the following values.

Value	Meaning
BUTTON_IMAGELIST_ALIGN_LEFT	Align the image with the left margin.
BUTTON_IMAGELIST_ALIGN_RIGHT	Align the image with the right margin.
BUTTON_IMAGELIST_ALIGN_TOP	Align the image with the top margin
BUTTON_IMAGELIST_ALIGN_BOTTOM	Align the image with the bottom margin
BUTTON_IMAGELIST_ALIGN_CENTER	Center the image.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Header	commctrl.h

See also

BCM_GETIMAGELIST

BCM_SETIMAGELIST

Button_GetImageList

Button_SetImageList

Buttons

Conceptual

Reference