Simplestar Game
since 17/01/2009
:::::::::::フォームビューをドッキングウィンドウにする方法:::::::::::
この Tips に興味を示す方は以下のフォームビューとドッキングウィンドウについてご存知の方だと思います。
これを踏まえて、次のページを読んで納得できる方はこの先を読む必要はありません。
How to put CFormView on CDockableView
こちら↑をペラ読みして、よくわからない方のために以下に作業メモを残します。
まずフォームビューのクラスと、ドッキングウィンドウのクラスをそれぞれ用意します。
※このとき、フォームビューのプロパティで「Style」を「子」に指定しておきます。（そうしないと実行時にエラーになります）
ドッキングウィンドウのクラスのヘッダーファイルにて、フォームビューのクラスへのポインタをメンバとして持たせます。
実体ではないので、ヘッダーファイルではフォームビューのクラスは前方宣言に留めておきます。
こちら↓がドッキングウィンドウのヘッダーファイルです。
※フォームビューのクラス名は「CSliderForm」になってます。
class CSliderForm;
// CDockableFormView
class CDockableFormView : public CDockablePane
{
DECLARE_DYNAMIC(CDockableFormView)
public:
CDockableFormView();
virtual ~CDockableFormView();
protected:
DECLARE_MESSAGE_MAP()
private:
CSliderForm* m_pSliderFormView;
public:
afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);
afx_msg void OnSize(UINT nType, int cx, int cy);
};
ここで示される OnCreate 関数と OnSize 関数は次に示すドッキングウィンドウのクラスの
プロパティのメッセージリストから自動で作成できます。
項目をクリックするだけで、コードがヘッダーファイルとソースファイルに作成されます。
それぞれの実装は次に示す通りです。
int CDockableFormView::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
if (CDockablePane::OnCreate(lpCreateStruct) == -1)
return -1;
m_pSliderFormView = CSliderForm::CreateOne(this);
return 0;
}
void CDockableFormView::OnSize(UINT nType, int cx, int cy)
{
CDockablePane::OnSize(nType, cx, cy);
// TODO: ここにメッセージ ハンドラ コードを追加します。
if (m_pSliderFormView)
{
m_pSliderFormView->SetWindowPos(NULL, 0, 0, cx, cy, SWP_NOZORDER );
}
}
フォームビューである「CSliderForm」クラスのヘッダーファイルは次の通りです。
#include "afxcmn.h"
// CSliderForm フォーム ビュー
class CSliderForm : public CFormView
{
DECLARE_DYNCREATE(CSliderForm)
protected:
CSliderForm(); // 動的生成で使用される protected コンストラクタ
virtual ~CSliderForm();
public:
static CSliderForm* CreateOne( CWnd* pParent );
public:
enum { IDD = IDD_SLIDER_FORM };
#ifdef _DEBUG
virtual void AssertValid() const;
#ifndef _WIN32_WCE
virtual void Dump(CDumpContext& dc) const;
#endif
#endif
protected:
virtual void DoDataExchange(CDataExchange* pDX); // DDX/DDV サポート
DECLARE_MESSAGE_MAP()
private:
bool m_bInitialized; //!< 初期化フラグ
CSliderCtrl m_sliderCtrl;
public:
virtual void OnInitialUpdate();
afx_msg int OnMouseActivate(CWnd* pDesktopWnd, UINT nHitTest, UINT message);
afx_msg void OnSize(UINT nType, int cx, int cy);
};
スライダーコントロールが一つあるフォームビューですね。
ここで示される OnInitialUpdate 関数 OnMouseActivate 関数の作り方は次に示す通りです。
フォームビュークラスのプロパティから、オーバーロードする関数を選択するだけです。
イベントハンドラも同じく、メッセージを選択するだけ。
OnSize 関数は先ほど作り方を示しましたから、もういいですね。
基本的に、ビューとかMFCの一般的なクラスはプロパティから関数をオーバーロードしたり
メッセージごとのイベントハンドラを用意するくらいしか仕事がありません。ただ、やり方を覚えるだけです。
ユーザーが新しく用意するのは、static 関数の CreateOne 関数だけです。
これらの関数のソースコードは次に示す通りです。
@brief フォームビューの作成
@param[in] pParent : 親のビュー
@author Simplestar
@return フォームビューへのポインタ
*//***********************************************************************/
CSliderForm* CSliderForm::CreateOne( CWnd* pParent )
{
CSliderForm* pFormView = new CSliderForm;
CFrameWnd* pFrameWnd = (CFrameWnd* )AfxGetMainWnd();
if (!pFormView->Create(NULL, NULL, WS_CHILD | WS_VISIBLE, CRect(0, 0, 100, 30), pParent, IDD_SLIDER_FORM, NULL))
{
AfxMessageBox( _T("Failed in creating CSliderForm") );
}
pFormView->OnInitialUpdate();
return pFormView;
}
#endif
#endif //_DEBUG
// CSliderForm メッセージ ハンドラ
void CSliderForm::OnInitialUpdate()
{
CFormView::OnInitialUpdate();
GetParentFrame()->RecalcLayout();
SetScrollSizes( MM_TEXT, CSize( 100, 30 ) ); // ←フォームのサイズ
ResizeParentToFit(FALSE);
m_bInitialized = true;
}
int CSliderForm::OnMouseActivate(CWnd* pDesktopWnd, UINT nHitTest, UINT message)
{
int nResult = 0;
CFrameWnd* pParentFrame = GetParentFrame();
if( pParentFrame == pDesktopWnd )
{
nResult = CFormView::OnMouseActivate(pDesktopWnd, nHitTest, message);
}
else
{
// When this is not docked
BOOL isMiniFrameWnd = pDesktopWnd->IsKindOf( RUNTIME_CLASS( CMiniFrameWnd ) );
BOOL isPaneFrameWnd = pDesktopWnd->IsKindOf( RUNTIME_CLASS( CPaneFrameWnd ) );
BOOL isMultiPaneFrameWnd = pDesktopWnd->IsKindOf( RUNTIME_CLASS( CMultiPaneFrameWnd ) );
}
// pDesktopWnd is the frame window for CDockablePane
nResult = CWnd::OnMouseActivate( pDesktopWnd, nHitTest, message );
return nResult;
}
void CSliderForm::OnSize(UINT nType, int cx, int cy)
{
CFormView::OnSize(nType, cx, cy);
if (m_bInitialized)
{
RECT pos;
{
pos.top=0;
pos.left =0;
pos.right = cx ;
pos.bottom = cy;
}
m_sliderCtrl.MoveWindow( &pos );
}
}
これでドッキングウィンドウにフォームが乗っかります。
こちら↑が実行結果です。
ドッキングウィンドウの中にスライダーコントロールがあるのがドッキングフォームウィンドウです。
ドッキングウィンドウにコントロールを配置したフォームが乗せられるようになると
MFCアプリケーションで出来ることがグっと広がる…かも？
最後に、ドッキングウィンドウを閉じたり、開いたりを繰り返すとフォームビューを作成している分メモリリークが起きると思います。
ドッキングウィンドウを閉じたら、フォームビューも解放するようにしておいてください。
以上です。
2011/04/09 最終更新