CDialogBar::Create

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

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_LEFT コントロールバーをフレームウィンドウの左辺に揃えます。
- CBRS_RIGHT コントロールバーをフレームウィンドウの右辺に揃えます。
nID
ダイアログバーのコントロール ID。
nIDTemplate
CDialogBar オブジェクトのダイアログボックステンプレートのリソース ID。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 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;
}