CDialogBar::Create

2011-08-09

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