Edit

Rebar

  • Article

This section contains information about programming elements used with rebar controls.

Overviews

Topic Contents
Rebar Controls Rebar controls act as containers for child windows.
Using Rebar Controls This section contains example code showing how to implement rebar controls.

Messages

Topic Contents
RB_BEGINDRAG Puts the rebar control in drag-and-drop mode. This message does not cause a RBN_BEGINDRAG notification to be sent.
RB_DELETEBAND Deletes a band from a rebar control.
RB_DRAGMOVE Updates the drag position in the rebar control after a previous RB_BEGINDRAG message.
RB_ENDDRAG Terminates the rebar control's drag-and-drop operation. This message does not cause an RBN_ENDDRAG notification to be sent.
RB_GETBANDBORDERS Retrieves the borders of a band. The result of this message can be used to calculate the usable area in a band.
RB_GETBANDCOUNT Retrieves the count of bands currently in the rebar control.
RB_GETBANDINFO Retrieves information about a specified band in a rebar control.
RB_GETBANDMARGINS Retrieves the margins of a band.
RB_GETBARHEIGHT Retrieves the height of the rebar control.
RB_GETBARINFO Retrieves information about the rebar control and the image list it uses.
RB_GETBKCOLOR Retrieves a rebar control's default background color.
RB_GETCOLORSCHEME Retrieves the color scheme information from the rebar control.
RB_GETDROPTARGET Retrieves a rebar control's IDropTarget interface pointer.
RB_GETEXTENDEDSTYLE Gets the extended style.
RB_GETPALETTE Retrieves the rebar control's current palette.
RB_GETRECT Retrieves the bounding rectangle for a given band in a rebar control.
RB_GETROWCOUNT Retrieves the number of rows of bands in a rebar control.
RB_GETROWHEIGHT Retrieves the height of a specified row in a rebar control.
RB_GETTEXTCOLOR Retrieves a rebar control's default text color.
RB_GETTOOLTIPS Retrieves the handle to any tooltip control associated with the rebar control.
RB_GETUNICODEFORMAT Retrieves the Unicode character format flag for the control.
RB_HITTEST Determines which portion of a rebar band is at a given point on the screen, if a rebar band exists at that point.
RB_IDTOINDEX Converts a band identifier to a band index in a rebar control.
RB_INSERTBAND Inserts a new band in a rebar control.
RB_MAXIMIZEBAND Resizes a band in a rebar control to either its ideal or largest size.
RB_MINIMIZEBAND Resizes a band in a rebar control to its smallest size.
RB_MOVEBAND Moves a band from one index to another.
RB_PUSHCHEVRON Sent to a rebar control to programmatically push a chevron.
RB_SETBANDINFO Sets characteristics of an existing band in a rebar control.
RB_SETBANDWIDTH Sets the width for a docked band.
RB_SETBARINFO Sets the characteristics of a rebar control.
RB_SETBKCOLOR Sets a rebar control's default background color.
RB_SETCOLORSCHEME Sets the color scheme information for the rebar control.
RB_SETEXTENDEDSTYLE Sets the extended style. This message is not implemented.
RB_SETPALETTE Sets the rebar control's current palette.
RB_SETPARENT Sets a rebar control's parent window.
RB_SETTEXTCOLOR Sets a rebar control's default text color.
RB_SETTOOLTIPS Associates a tooltip control with the rebar control.
RB_SETUNICODEFORMAT Sets the Unicode character format flag for the control. This message allows you to change the character set used by the control at run time rather than having to re-create the control.
RB_SETWINDOWTHEME Sets the visual style of a rebar control.
RB_SHOWBAND Shows or hides a given band in a rebar control.
RB_SIZETORECT Attempts to find the best layout of the bands for the given rectangle.

Notifications

Topic Contents
NM_CUSTOMDRAW (rebar) Sent by the rebar control to notify its parent window about drawing operations. This notification is sent in the form of a WM_NOTIFY message.
NM_NCHITTEST (rebar) Sent by a rebar control when the control receives a WM_NCHITTEST message. This notification code is sent in the form of a WM_NOTIFY message.
NM_RELEASEDCAPTURE (rebar) Notifies a rebar control's parent window that the control is releasing mouse capture. This notification is sent in the form of a WM_NOTIFY message.
RBN_AUTOBREAK Notifies a rebar's parent that a break will appear in the bar. The parent determines whether to make the break.
RBN_AUTOSIZE Sent by a rebar control created with the RBS_AUTOSIZE style when the rebar automatically resizes itself. This notification code is sent in the form of a WM_NOTIFY message.
RBN_BEGINDRAG Sent by a rebar control when the user begins dragging a band. This notification code is sent in the form of a WM_NOTIFY message.
RBN_CHEVRONPUSHED Sent by a rebar control when a chevron is pushed. This notification code is sent in the form of a WM_NOTIFY message.
RBN_CHILDSIZE Sent by a rebar control when a band's child window is resized. This notification code is sent in the form of a WM_NOTIFY message.
RBN_DELETEDBAND Sent by a rebar control after a band has been deleted. This notification code is sent in the form of a WM_NOTIFY message.
RBN_DELETINGBAND Sent by a rebar control when a band is about to be deleted. This notification code is sent in the form of a WM_NOTIFY message.
RBN_ENDDRAG Sent by a rebar control when the user stops dragging a band. This notification code is sent in the form of a WM_NOTIFY message.
RBN_GETOBJECT Sent by a rebar control created with the RBS_REGISTERDROP style when an object is dragged over a band in the control. This notification code is sent in the form of a WM_NOTIFY message.
RBN_HEIGHTCHANGE Sent by a rebar control when its height has changed. This notification code is sent in the form of a WM_NOTIFY message.
RBN_LAYOUTCHANGED Sent by a rebar control when the user changes the layout of the control's bands. This notification code is sent in the form of a WM_NOTIFY message.
RBN_MINMAX Sent by a rebar control prior to maximizing or minimizing a band. This notification code is sent in the form of a WM_NOTIFY message.
RBN_SPLITTERDRAG Sent by a rebar control when the user drags a splitter. This notification code is sent in the form of a WM_NOTIFY message.

Structures

Topic Contents
NMRBAUTOSIZE Contains information used in handling the RBN_AUTOSIZE notification codes.
NMREBAR Contains information used in handling various rebar notification codes.
NMREBARAUTOBREAK Contains information used with the RBN_AUTOBREAK notification.
NMREBARCHEVRON Contains information used in handling the RBN_CHEVRONPUSHED notification code.
NMREBARCHILDSIZE Contains information used in handling the RBN_CHILDSIZE notification code.
NMREBARSPLITTER Contains information used to handle an RBN_SPLITTERDRAG notification code.
RBHITTESTINFO Contains information specific to a hit test operation. This structure is used with the RB_HITTEST message.
REBARBANDINFO Contains information that defines a band in a rebar control.
REBARINFO Contains information that describes rebar control characteristics.

Constants

Topic Contents
Rebar Control Styles Rebar controls support a variety of control styles in addition to standard window styles.