CDialogBar::Create
載入 lpszTemplateName 或 nIDTemplate指定的對話方塊資源範本，建立對話方塊列的 視窗中，將其樣式，並將其與 CDialogBar 物件。
virtual BOOL Create(
CWnd* pParentWnd,
LPCTSTR lpszTemplateName,
UINT nStyle,
UINT nID
);
virtual BOOL Create(
CWnd* pParentWnd,
UINT nIDTemplate,
UINT nStyle,
UINT nID
);
參數
pParentWnd
CWnd 父物件的指標。lpszTemplateName
為 CDialogBar 物件的對話方塊資源範本名稱的指標。nStyle
工具列樣式。 支援的額外工具列樣式為:CBRS_TOP 控制列是在框架視窗上方。
CBRS_BOTTOM 控制列在較低層級框架視窗。
當父控制項調整大小時，CBRS_NOALIGN 控制列不會重新定位。
CBRS_TOOLTIPS 控制列顯示工具提示。
CBRS_SIZE_DYNAMIC 控制列是動態的。
CBRS_SIZE_FIXED 控制列是固定的。
CBRS_FLOATING 控制列浮動。
CBRS_FLYBY 狀態列會顯示按鈕的相關資訊。
CBRS_HIDE_INPLACE 控制列不顯示給使用者。
nID
對話方塊列的控制項 ID。nIDTemplate
CDialogBar 物件的對話方塊範本的資源 ID。
傳回值
如果不是零，則成功，則為 0。
備註
如果您指定 CBRS_TOP 或 CBRS_BOTTOM 對齊樣式，對話方塊列的寬度是框架視窗，其高度是 nIDTemplate指定的資源。 如果您指定 CBRS_LEFT 或 CBRS_RIGHT 對齊樣式，對話方塊列的高度是框架視窗，而且其寬度是 nIDTemplate指定的資源。
範例
int CMainFrame::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
if (CMDIFrameWnd::OnCreate(lpCreateStruct) == -1)
return -1;
EnableDocking(CBRS_ALIGN_ANY);
// m_wndDlgBar is a CDialogBar member of CMainFrame
// IDD_DIALOGBAR - Resource ID of the dialog
// template. This dialog template should be created
// with the style WS_CHILD and no other style.
// The template must not have the style WS_VISIBLE.
if (!m_wndDlgBar.Create(this, IDD_DIALOGBAR,
CBRS_LEFT|CBRS_TOOLTIPS|CBRS_FLYBY, IDD_DIALOGBAR))
{
TRACE0("Failed to create DlgBar\n");
return -1; // Fail to create.
}
return 0;
}
需求
Header: afxext.h