This documentation is archived and is not being maintained.


Call this function to cause a control bar to not be docked to the frame window.

void FloatControlBar( 
   CControlBar * pBar, 
   CPoint point, 


Points to the control bar to be floated.


The location, in screen coordinates, where the top left corner of the control bar will be placed.


Specifies whether to align the control bar horizontally or vertically within its new frame window. It can be any one of the following:

  • CBRS_ALIGN_TOP   Orients the control bar vertically.

  • CBRS_ALIGN_BOTTOM   Orients the control bar vertically.

  • CBRS_ALIGN_LEFT   Orients the control bar horizontally.

  • CBRS_ALIGN_RIGHT   Orients the control bar horizontally.

If styles are passed specifying both horizontal and vertical orientation, the toolbar will be oriented horizontally.

Typically, this is done at application startup when the program is restoring settings from the previous execution.

This function is called by the framework when the user causes a drop operation by releasing the left mouse button while dragging the control bar over a location that is not available for docking.

Header: afxwin.h