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

必要条件

ヘッダー: afxext.h

参照

関連項目

CDialogBar クラス

階層図

CDialogBar::CDialogBar