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