SECFrameWnd::DockControlBarEx

voidSECFrameWnd::DockControlBarEx(CControlBar*pBar, UINTnDockBarID= 0, intnCol= 0, intnRow= 0, floatfPctWidth= 0, intnHeight= 150)

This member function is similar in purpose to CFrameWnd::DockControlBar except it gives greater control over how and where the control bar will be docked. For example, with DockControlBarEx, you can specify that you want four control bars with the first docked on a row by itself and the last three docked side by side on the second row. Moreover, you can request that the second row of three control bars be divided 70%, 10%, and 15% (each as a percentage of the dock bar’s width). In addition, you can specify the height of all control bars (and therefore the row) to be 100 pixels.

Defined in: swinfrm.cpp

Return Value

void

Parameters

pBar

The control bar to be docked.

nDockBarID

The ID of the dock bar to dock the control bar to.

nCol

The column where the control bar should be positioned. The column index is zero-based

nRow

The row where the control bar should be positioned. The row index is zero-based.

fPctWidth

The percent of the dock bar’s width that the control bar should occupy. If the dock bar identified by nDockBarID is a vertical dock bar, this parameter really specifies the percent of the dock bar’s height the control bar should occupy.

nHeight

The requested height (in pixels) of the control bar. If the dock bar is vertical, this parameter actually represents the control bar width.