REBARBANDINFOW structure (commctrl.h)

Contains information that defines a band in a rebar control.

Syntax

typedef struct tagREBARBANDINFOW {
  UINT     cbSize;
  UINT     fMask;
  UINT     fStyle;
  COLORREF clrFore;
  COLORREF clrBack;
  LPWSTR   lpText;
  UINT     cch;
  int      iImage;
  HWND     hwndChild;
  UINT     cxMinChild;
  UINT     cyMinChild;
  UINT     cx;
  HBITMAP  hbmBack;
  UINT     wID;
  UINT     cyChild;
  UINT     cyMaxChild;
  UINT     cyIntegral;
  UINT     cxIdeal;
  LPARAM   lParam;
  UINT     cxHeader;
  RECT     rcChevronLocation;
  UINT     uChevronState;
} REBARBANDINFOW, *LPREBARBANDINFOW;

Members

cbSize

Type: UINT

Size of this structure, in bytes. Your application must fill this member before sending any messages that use the address of this structure as a parameter.

fMask

Type: UINT

Flags that indicate which members of this structure are valid or must be filled. This value can be a combination of the following:

Value Meaning
RBBIM_BACKGROUND
The hbmBack member is valid or must be set.
RBBIM_CHILD
The hwndChild member is valid or must be set.
RBBIM_CHILDSIZE
The cxMinChild, cyMinChild, cyChild, cyMaxChild, and cyIntegral members are valid or must be set.
RBBIM_COLORS
The clrFore and clrBack members are valid or must be set.
RBBIM_HEADERSIZE

Version 4.71. The cxHeader member is valid or must be set.

RBBIM_IDEALSIZE

Version 4.71. The cxIdeal member is valid or must be set.

RBBIM_ID
The wID member is valid or must be set.
RBBIM_IMAGE
The iImage member is valid or must be set.
RBBIM_LPARAM

Version 4.71. The lParam member is valid or must be set.

RBBIM_SIZE
The cx member is valid or must be set.
RBBIM_STYLE
The fStyle member is valid or must be set.
RBBIM_TEXT
The lpText member is valid or must be set.
RBBIM_CHEVRONLOCATION
The rcChevronLocation member is valid or must be set.
RBBIM_CHEVRONSTATE
The uChevronState member is valid or must be set.

fStyle

Type: UINT

Flags that specify the band style. This value can be a combination of the following:

Value Meaning
RBBS_BREAK
The band is on a new line.
RBBS_CHILDEDGE
The band has an edge at the top and bottom of the child window.
RBBS_FIXEDBMP
The background bitmap does not move when the band is resized.
RBBS_FIXEDSIZE
The band can't be sized. With this style, the sizing grip is not displayed on the band.
RBBS_GRIPPERALWAYS

Version 4.71. The band will always have a sizing grip, even if it is the only band in the rebar.

RBBS_HIDDEN
The band will not be visible.
RBBS_NOGRIPPER

Version 4.71. The band will never have a sizing grip, even if there is more than one band in the rebar.

RBBS_USECHEVRON

Version 5.80. Show a chevron button if the band is smaller than cxIdeal.

RBBS_VARIABLEHEIGHT

Version 4.71. The band can be resized by the rebar control; cyIntegral and cyMaxChild affect how the rebar will resize the band.

RBBS_NOVERT
Do not show when vertical.
RBBS_HIDETITLE
Keep band title hidden.
RBBS_TOPALIGN
Keep band in top row.

clrFore

Type: COLORREF

Band foreground colors.

clrBack

Type: COLORREF

Band background colors. If hbmBack specifies a background bitmap, these members are ignored. By default, the band will use the background color of the rebar control set with the RB_SETBKCOLOR message. If a background color is specified here, then this background color will be used instead.

lpText

Type: LPTSTR

Pointer to a buffer that contains the display text for the band. If band information is being requested from the control and RBBIM_TEXT is specified in fMask, this member must be initialized to the address of the buffer that will receive the text.

cch

Type: UINT

Size of the buffer at lpText, in bytes. If information is not being requested from the control, this member is ignored.

iImage

Type: int

Zero-based index of any image that should be displayed in the band. The image list is set using the RB_SETBARINFO message.

hwndChild

Type: HWND

Handle to the child window contained in the band, if any.

cxMinChild

Type: UINT

Minimum width of the child window, in pixels. The band can't be sized smaller than this value.

cyMinChild

Type: UINT

Minimum height of the child window, in pixels. The band can't be sized smaller than this value.

cx

Type: UINT

Length of the band, in pixels.

hbmBack

Type: HBITMAP

Handle to a bitmap that is used as the background for this band.

wID

Type: UINT

UINT value that the control uses to identify this band for custom draw notification messages.

cyChild

Type: UINT

Version 4.71. Initial height of the band, in pixels. This member is ignored unless the RBBS_VARIABLEHEIGHT style is specified.

cyMaxChild

Type: UINT

Version 4.71. Maximum height of the band, in pixels. This member is ignored unless the RBBS_VARIABLEHEIGHT style is specified.

cyIntegral

Type: UINT

Version 4.71. Step value by which the band can grow or shrink, in pixels. If the band is resized, it will be resized in steps specified by this value. This member is ignored unless the RBBS_VARIABLEHEIGHT style is specified.

cxIdeal

Type: UINT

Version 4.71. Ideal width of the band, in pixels. If the band is maximized to the ideal width (see RB_MAXIMIZEBAND), the rebar control will attempt to make the band this width.

lParam

Type: LPARAM

Version 4.71. Application-defined value.

cxHeader

Type: UINT

Version 4.71. Size of the band's header, in pixels. The band header is the area between the edge of the band and the edge of the child window. This is the area where band text and images are displayed, if they are specified. If this value is specified, it will override the normal header dimensions that the control calculates for the band.

rcChevronLocation

Type: RECT

Version 6. Location of the chevron.

uChevronState

Type: UINT

Version 6. A combination of the Object State Constants.

Remarks

The cxMinChild, cyMinChild, and cx members provide information on dimensions relative to the orientation of the control. That is, for a horizontal rebar control, cxMinChild and cx are horizontal measurements and cyMinChild is a vertical measurement. However, if the control uses the CCS_VERT style, cxMinChild and cx are vertical measurements and cyMinChild is a horizontal measurement.

Note

The commctrl.h header defines REBARBANDINFO as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

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