CDialogBar クラス

コントロール バー内の Windows のモードレス ダイアログ ボックスの機能を提供します。

構文

class CDialogBar : public CControlBar

メンバー

パブリック コンストラクター

名前 説明
CDialogBar:: CDialogBar CDialogBar オブジェクトを構築します。

パブリック メソッド

名前 説明
CDialogBar:: Create Windows ダイアログバーを作成し、オブジェクトに CDialogBar アタッチします。

注釈

ダイアログバーはダイアログボックスに似ています。これには、ユーザーが tab キーを使用して設定できる標準 Windows コントロールが含まれています。 もう1つの類似性は、ダイアログバーを表すダイアログテンプレートを作成することです。

ダイアログバーの作成と使用は、オブジェクトの CFormView 作成と使用に似ています。 最初に、 ダイアログエディター を使用して、スタイル WS_CHILD で他のスタイルを指定せずにダイアログテンプレートを定義します。 テンプレートにスタイル WS_VISIBLE を指定することはできません。 アプリケーションコードで、コンストラクターを呼び出してオブジェクトを構築 CDialogBar し、を呼び出し Create てダイアログバーウィンドウを作成し、オブジェクトに CDialogBar アタッチします。

CDialogBar 詳細については、「 ダイアログバー 」と「 テクニカルノート 31のコントロールバー」を参照してください。

注意

現在のリリースでは、CDialogBar オブジェクトで Windows フォーム コントロールをホストすることはできません。 Visual C++ の Windows フォームコントロールの詳細については、「 MFC での Windows フォームユーザーコントロールの使用」を参照してください。

継承階層

CObject

CCmdTarget

CWnd

CControlBar

CDialogBar

要件

ヘッダー: afxext.h

CDialogBar:: CDialogBar

CDialogBar オブジェクトを構築します。

CDialogBar();

CDialogBar:: Create

または nIDTemplatelpszTemplateName 指定されたダイアログボックスリソーステンプレートを読み込み、ダイアログバーウィンドウを作成し、そのスタイルを設定して、オブジェクトに 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;
}

関連項目

MFC のサンプル CTRLBARS
CControlBar クラス
階層図
CFormView クラス
CControlBar クラス