Edit

Share via

BUTTON_IMAGELIST structure (commctrl.h)

  • Article

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