CTreePropertySheet::InsertExtraControl

CTreePropertySheet::InsertExtraControl( int nVertArrange,
int zOrder,
CWnd* pWnd,
int row,
int col,
int nWidth,
int nHeight,
int nArrange=tps_horz_center|tps_vert_center,
BOOL bAutoDelete=FALSE);

Parameters

nVertArrange Defines in which pane this control should be inserted.
Can be tps_above or tps_below - above all standard elements or below them.
zOrder Defines the tab order of the extra control.
'0' means it should be the first tab item. Caution: Do not assign the same value twice, and increase in 1-steps.
pWnd Contains the CWnd pointer to the window to be inserted.
This CWnd must already have a Windows window attached to it.
(The width and height of the HWND belonging to pWnd defines the actual width and height of the item).
row,col Defines the position to place the control.
Do not assign the same position twice.
nWidth,nHeight Defines the space to be reserved for this control.
This can be more than the size of the control (see pWnd and nArrange).
nArrange This value defines how the control is aligned.
Can be one of the following values:
(Combine a tps_horz_xxx style with a tps_vert_xxx style)

tps_horz_left The item is aligned to the left.(default)
tps_horz_center The item is horizontally centered.
tps_horz_right The item is aligned to the right.
tps_vert_top The item is aligned to the top.(default)
tps_vert_center The item is vertically centered.
tps_vert_bottom The item is aligned to the bottom.

The alignment is relative to the space which is reserved for this control using 'nWidth' and 'nHeight'
bAutoDelete If TRUE, the 'pWnd' object is deleted by the destructor of the CTreePropertyPage object.
If FALSE, you must delete it manually.

Modifcations

In the prior version, all buttons of the sheet were added using this method. Now the property page uses the default property sheet buttons by default (which are localized). If you need to use the old way of handling the buttons, please refer to the member variable 'm_bDisableStandardButtons'.

Remarks

This function inserts an extra control to the property sheet.
It is important that the window of the control to insert, pWnd, must already have been created. This is because the control may need parameters which can't be passed thru DoModal, and also because the size of the window rectangle is needed.
The width and height of the pWnd object determines the real size of the control.
nWidth and nHeight instead define how many space is reserved.
Within this reserved space, 'nArrange' tells how to align the control.