ダイアログバー
ダイアログバーとはこんなもの(図の中央部)です。ツールバーとは違います。
ダイアログバーは子ウィンドウです。デザインはグラフィックエディタで行うので、好みのコントロールを配置できます。
では、早速、作成方法です。
[Resource View]で[Dialogの挿入]を選択してコントロールを配置します。
次にダイアログのプロパティを変更します。必ず、[スタイル]タブにある[スタイル](コンボボックス)を[チャイルド]、[境界線](コンボボックス)を[なし]に変更します。
加えて[その他のスタイル]タブの[可視]のチェックが外れていることを確認します。絶対！[可視]のチェックを外して下さい！(実行時にトラップしますから)
ダイアログクラスは作成しなくて良いです。作っても効果がありません。理由は以下を読み続けて頂くとわかると思います。
次に(親ウィンドウの)フレームクラスにCDialogBarクラスのメンバ変数を宣言します。
class CMainFrame : public CMDIFrameWnd
{
.
.
protected:
CDialogBar m_dlgbar;
.
.
次に親ウィンドウのフレームクラスのOnCreateでCreateします。
int CMainFrame::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
.
.
if (!m_dlgbar.Create(this, IDD_DIALOG1, WS_VISIBLE|CBRS_TOP, AFX_IDW_TOOLBAR)) {
TRACE("Failed to create dialogbar\n");
return -1; // 作成に失敗
}
// TODO: もしツール チップスが必要ない場合、ここを削除してください。
m_wndToolBar.SetBarStyle(m_wndToolBar.GetBarStyle() |
CBRS_TOOLTIPS | CBRS_FLYBY | CBRS_SIZE_DYNAMIC);
.
.
第２パラメータには先程作成したダイアログID(例ではIDD_DIALOG1)を、第３パラメータにはダイアログバーの配置スタイルを、
第３パラメータには0xe800〜0xe820の範囲の値を指定します。
以上で完了です。
しかし、コントロールにボタンを配置した場合、このままではそのボタンは常にディセーブルのままとなります。
これを回避するには手動でメッセージマップとイベントハンドラ関数を追加します。
例の如く手動で追加するのでAFX_の外側に記述します。(例ではボタンのIDをIDC_MYBUTTON1、関数名をOnMyButton1にしました)
// [MainFrm.h内]
.
.
// 生成されたメッセージ マップ関数
protected:
//{{AFX_MSG(CMainFrame)
afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);
//}}AFX_MSG
afx_msg void OnMyButton1();
DECLARE_MESSAGE_MAP()
// [MainFrm.cpp内]
.
.
BEGIN_MESSAGE_MAP(CMainFrame, CMDIFrameWnd)
//{{AFX_MSG_MAP(CMainFrame)
ON_WM_CREATE()
//}}AFX_MSG_MAP
ON_COMMAND(IDC_MYBUTTON1, OnMyButton1)
END_MESSAGE_MAP()
.
.
void CMainFrame::OnMyButton1()
{
.
.
}
また、ボタンのディセーブルの制御がしたければ、次のメッセージマップとイベントハンドラ関数を追加します。
afx_msg void OnUpdateXxx(CCmdUI* pCmdUI);
ON_UPDATE_COMMAND_UI(DC_XXX, OnUpdateXxx)
void CMainFrame::OnUpdateXxx(CCmdUI* pCmdUI)
{
pCmdUI->Enable(TRUE or FALSE);
}
また、エディトコントロール等に文字を設定したり取得したりしたい場合は、次のような記述で対応します。
CDialogBar* pBar = (CDialogBar*)AfxGetApp()->m_pMainWnd->GetDlgItem(AFX_IDW_TOOLBAR);
pBar->SetDlgItemText(IDC_EDIT1, "AAA");
char cb[101];
pBar->GetDlgItemText(IDC_EDIT1, cb, 100);
以下はCreateのパラメータの補足です。
第２パラメータのCBRS_xxxは次の意味があります。
| CBRS_TOP | コントロールバーをフレーム ウィンドウの上辺に揃えます |
| CBRS_BOTTOM | コントロールバーをフレーム ウィンドウの下辺に揃えます |
| CBRS_NOALIGN | 親ウィンドウのサイズが変更されてもコントロールバーは再配置されません |
| CBRS_LEFT | コントロールバーをフレーム ウィンドウの左辺に揃えます |
| CBRS_RIGHT | コントロールバーをフレーム ウィンドウの右辺に揃えます |
第３パラメータについてはちょっとこの辺、私は理解不足ですが、Afxres.hに次の記述がありますので参考にして下さい。
// Standard control bars (IDW = window ID)
#define AFX_IDW_CONTROLBAR_FIRST 0xE800
#define AFX_IDW_CONTROLBAR_LAST 0xE8FF
#define AFX_IDW_TOOLBAR 0xE800 // main Toolbar for window
#define AFX_IDW_STATUS_BAR 0xE801 // Status bar window
#define AFX_IDW_PREVIEW_BAR 0xE802 // PrintPreview Dialog Bar
#define AFX_IDW_RESIZE_BAR 0xE803 // OLE in-place resize bar
// Note: If your application supports docking toolbars, you should
// not use the following IDs for your own toolbars. The IDs chosen
// are at the top of the first 32 such that the bars will be hidden
// while in print preview mode, and are not likely to conflict with
// IDs your application may have used succesfully in the past.
#define AFX_IDW_DOCKBAR_TOP 0xE81B
#define AFX_IDW_DOCKBAR_LEFT 0xE81C
#define AFX_IDW_DOCKBAR_RIGHT 0xE81D
#define AFX_IDW_DOCKBAR_BOTTOM 0xE81E
#define AFX_IDW_DOCKBAR_FLOAT 0xE81F
// Macro for mapping standard control bars to bitmask (limit of 32)
#define AFX_CONTROLBAR_MASK(nIDC) (1L << (nIDC - AFX_IDW_CONTROLBAR_FIRST))
ツールバー
ツールバーは悩みなく利用されていると思います。グラフィックエディタの[ToolBar]の編集だけで完了しますね。
[ツールバーボタンプロパティ]の[ID]には、メニュー項目かキーボードアクセラレータで定義したIDを割り付けますね。
では、メニュー項目にもキーボードアクセラレータにも定義されていないIDを割り付けた場合はどうするのでしょうか。
ダイアログバーの説明をお読みになかれた方には、もうお分かりかも知れませんね。
ツールバーもボタンですから、これを利用するにはメッセージマップとイベントハンドラ関数を手動で追加します。
やり方はダイアログバーのこのあたりを参考にして下さい。
全く蛇足のなにものでもありませんが、更新コマンドUIメッセージハンドラ(CCmdUI)でメニューと同様にツールバーも表示状態が変化します。
void CXxxView::OnUpdateZzz(CCmdUI* pCmdUI)
{
// TODO: この位置に command update UI ハンドラ用のコードを追加してください
// nCheck 設定するチェック状態を指定します。0 はチェックなし(アップ)、1 はチェック付き(ダウン)、2 は不定(明るい霞)です。
// pCmdUI->SetCheck(nCheck);
// bOn アイテムを有効(通常)にするには TRUE を、無効(霞)にするには FALSE を指定します。
// pCmdUI->Enable(bOn);
}
※ツールバーボタンの更新コマンドUIメッセージハンドラは、メッセージハンドラはアプリケーションのアイドル処理中にも呼び出されるようなので、
継続的に更新されます。
グラフィックエディタの[ToolBar]を使用せずにツールバーを実装する方法があります。
但し、[Bitmap]のIDR_MAINFRAMEのtoolbar.bmpは用意されていなければなりません。
MainFrm.cppに次のような構造体に値を与えます。値の順番はtoolbar.bmpの絵の並びと合っていなければなりません。
ID_SEPARATORは順番と関係ありませんので自由に挿入できます。
static UINT BASED_CODE buttons[] =
{
ID_FILE_NEW,
ID_FILE_OPEN,
ID_FILE_SAVE,
ID_SEPARATOR,
ID_EDIT_CUT,
ID_EDIT_COPY,
ID_EDIT_PASTE,
ID_SEPARATOR,
ID_FILE_PRINT,
ID_APP_ABOUT,
};
同じくMainFrm.cppのOnCreateのツールバーの生成部分を次のように修正します。
int CMainFrame::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
.
.
if (!m_wndToolBar.Create(this) ||
!m_wndToolBar.LoadBitmap(IDR_MAINFRAME) ||
!m_wndToolBar.SetButtons(buttons, sizeof(buttons)/sizeof(UINT)))
{
TRACE0("Failed to create toolbar\n");
return -1; // 作成に失敗
}
何もこんな不便なことを紹介しなくてもいいじゃないかと思われるかも知れませんが、
ID_SEPARATORの挿入とCToolBarクラスを継承した自家製クラスを作成することで、
ツールバーの中にコントロールを配置することができます。
見た目上、ダイアログバーとツールバーを合わせたコントロールバーになります。
詳細は、またいつか・・ね(^_^;
ステータスバー
ステータスバーはメッセージ区画と状態インジケータ区画にわかれています。
メッセージ区画には[ResourceView]の[Menu]あるいは[String Table]で定義したキャプションが表示されています。
状態インジケータ区画はCapsLockキーやNumLockキー等の状態が表示されています。
ステータスバーの更新コマンドUIメッセージハンドラも、
アプリケーションのアイドル処理中に呼び出されるので継続的に更新されます。
ですからリアルタイムに表示する必要があるステータスを表示したい場合に有効があります。
表示内容を変更するにはMainFrm.cppに次のような修正を行います。
static UINT indicators[] =
{
ID_SEPARATOR, // ステータス ライン インジケータ
ID_INDICATOR_TEXT, // 追加しました(ユーザ定義)
ID_SEPARATOR, // 追加しました(システム定義)
ID_INDICATOR_KANA,
ID_INDICATOR_CAPS,
ID_INDICATOR_NUM,
ID_INDICATOR_SCRL,
ID_INDICATOR_MOUSE, // 追加しました(ユーザ定義)
};
最初のID_SEPARATORはメッセージ区画(平坦表示)を示しています。それ以降は状態インジケータ区画(くぼみ表示)になります。
追加できるIDはシステムが用意している次のものか、ユーザが[ResourceView]の[String Table]で追加したものです。
例ではユーザ定義のID_INDICATOR_TEXTとID_INDICATOR_MOUSEとシステム定義のID_SEPARATORをもう一つ、追加しています。
[Afxres.h内]
// Mode indicators in status bar - these are routed like commands
#define ID_INDICATOR_EXT 0xE700 // extended selection indicator
#define ID_INDICATOR_CAPS 0xE701 // cap lock indicator
#define ID_INDICATOR_NUM 0xE702 // num lock indicator
#define ID_INDICATOR_SCRL 0xE703 // scroll lock indicator
#define ID_INDICATOR_OVR 0xE704 // overtype mode indicator
#define ID_INDICATOR_REC 0xE705 // record mode indicator
#define ID_INDICATOR_KANA 0xE706 // kana lock indicator
#define ID_SEPARATOR 0 // special separator value
ここまでのコーディングで８つに区分けされたステータスバーが現れます。
追加したID_SEPARATORの区画は無表示のくぼみ、ID_INDICATOR_TEXTとID_INDICATOR_MOUSEの区画は
[String Table]で定義した[キャプチャ]の内容がくぼみで表示されます。
次に、表示文字や表示状態(非表示・くぼみ・突起)を変更する方法を示します。
ユーザ定義のIDを使用しているものはメッセージマップとイベントハンドラ関数を手動で追加します。
これで表示状態が制御できます。
[MainFrm.h内]
.
.
// 生成されたメッセージ マップ関数
protected:
//{{AFX_MSG(CMainFrame)
afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);
// メモ - ClassWizard はこの位置にメンバ関数を追加または削除します。
// この位置に生成されるコードを編集しないでください。
//}}AFX_MSG
afx_msg void OnUpdateText(CCmdUI* pCmdUI);
DECLARE_MESSAGE_MAP()
};
[MainFrm.cpp内]
.
.
BEGIN_MESSAGE_MAP(CMainFrame, CMDIFrameWnd)
//{{AFX_MSG_MAP(CMainFrame)
// メモ - ClassWizard はこの位置にマッピング用のマクロを追加または削除します。
// この位置に生成されるコードを編集しないでください。
ON_WM_CREATE()
//}}AFX_MSG_MAP
ON_UPDATE_COMMAND_UI(ID_INDICATOR_TEXT, OnUpdateText)
END_MESSAGE_MAP()
void CMainFrame::OnUpdateText(CCmdUI* pCmdUI)
{
// pCmdUI->Enable(TRUE or FALSE) /* 文字の表示と非表示 */
// 次の例はShiftキー押すと表示されます
// pCmdUI->Enable(::GetKeyState(VK_SHIFT) < 0);
// pCmdUI->SetCheck(0); /* くぼみ */
// pCmdUI->SetCheck(1); /* 突起 */
// pCmdUI->SetCheck(2); /* 1と同じ */
}
次は表示文字を変更します。
例ではメッセージ区画のID_SEPARATORと追加したID_SEPARATORの区画とID_INDICATOR_MOUSEに、リアルタイムにマウスポインタの位置を表示しています。
表示文字はSetPaneTextで変更します。
void CXxxView::OnMouseMove(UINT nFlags, CPoint point) // クラスがフレームクラスでないことに注目
{
CMainFrame* pFrame = (CMainFrame*)AfxGetApp()->m_pMainWnd;
CStatusBar* pStatusBar = (CStatusBar*)pFrame->GetDescendantWindow(AFX_IDW_STATUS_BAR);
//CStatusBar* pStatusBar = &pFrame->m_wndStatusBar; // NG △ m_wndStatusBarがprotectedだから。publicに変更すればOKになる。
CString cb; cb.Format("%d,%d", point.x, point.y);
pStatusBar->SetPaneText(0, cb); /* メッセージ区画(インデックスは０番) */
pStatusBar->SetPaneText(2, cb); /* 後から追加したID_SEPARATORはインデックスが２番目だから */
int nIndex = pStatusBar->CommandToIndex(ID_INDICATOR_MOUSE);
pStatusBar->SetPaneText(nIndex, cb);
}
お気付きのようにID_SEPARATORで追加を行うと構造体との位置とSetPaneTextの第１パラメータを一致させなければなりません。
ですから、メッセージマップの追加と言う作業がありますが、ユーザ定義のIDを作成した方がメンテナンスの面で良いと思います。
最後にメッセージ区画にフレームワークによる自動的なメニュープロンプトの表示をやめる方法を示します。
CMainFrameクラスのOnCreateのステータスバーの生成部分に次のようにパラメータを追加します。
if (!m_wndStatusBar.Create(this, WS_CHILD|WS_VISIBLE|CBRS_BOTTOM, ID_USER_STATUS_BAR) ||
!m_wndStatusBar.SetIndicators(indicators,
sizeof(indicators)/sizeof(UINT)))
{
TRACE0("Failed to create status bar\n");
return -1; // 作成に失敗
}
ID_USER_STATUS_BARは[String Table]で定義します。
デフォルトではAFX_IDW_STATUS_BARが使用されるので、これを置き換えるだけです。
勿論、この場合はソース中のAFX_IDW_STATUS_BARをID_USER_STATUS_BARに置き換えて利用します。
表示と非表示
ツールバーやステータスバーの表示と非表示の切り替えは、標準的にAppWizardによりメニューに追加されます。
しかし、後から追加したこれらのコントロールバーについては、コードを後から追加しなければならない場合があります。
次にツールバーを例にしたコーディング例を示します。
例ではビュークラスに記述していますが、メインフレームクラスに追加するのが一般的だと思います。
void CXxxView::OnZzz()
{
CMainFrame* pFrame = (CMainFrame*)AfxGetApp()->m_pMainWnd;
CStatusBar* pStatusBar = (CStatusBar*)pFrame->GetDescendantWindow(AFX_IDW_STATUS_BAR);
pStatusBar->ShowWindow((pStatusBar->GetStyle() & WS_VISIBLE) == 0);
pFrame->RecalcLayout(); // CFrameWnd オブジェクトのコントロール バーを再配置します。
}