REBARBANDINFO structure

Contains information that defines a band in a rebar control.

Syntax


typedef struct {
  UINT     cbSize;
  UINT     fMask;
  UINT     fStyle;
  COLORREF clrFore;
  COLORREF clrBack;
  LPTSTR   lpText;
  UINT     cch;
  int      iImage;
  HWND     hwndChild;
  UINT     cxMinChild;
  UINT     cyMinChild;
  UINT     cx;
  HBITMAP  hbmBack;
  UINT     wID;
#if (_WIN32_IE >= 0x0400)
  UINT     cyChild;
  UINT     cyMaxChild;
  UINT     cyIntegral;
  UINT     cxIdeal;
  LPARAM   lParam;
  UINT     cxHeader;
#endif 
#if (_WIN32_WINNT >= 0x0600)
  RECT     rcChevronLocation;
  UINT     uChevronState;
#endif 
} REBARBANDINFO, *LPREBARBANDINFO;

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:

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

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

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Commctrl.h

Unicode and ANSI names

REBARBANDINFOW (Unicode) and REBARBANDINFOA (ANSI)

 

 

Community Additions

ADD
Show:
© 2014 Microsoft