ページ付きタブコントロールテンプレート [詳解]

#include <TnbMfcPagesTabCtrl.h>

CPagesTabCtrlT< TAB > の継承関係図

公開メンバ関数
int	AddItem (LPCTSTR lpszName, CDialog *pWnd, UINT idd)
	[追加] アイテム追加. [詳解]

template<typename TYP >
int	AddItem (LPCTSTR lpszName, TYP *pWnd)
	[追加] アイテム追加. [詳解]

BOOL	DeleteAllItems (void)
	[削除] 全アイテム削除. [詳解]

BOOL	DeleteItem (int nItem)
	[削除] アイテム削除. [詳解]

int	FindItem (HWND page) const
	[検索] アイテム検索. [詳解]

int	GetCurSel (void) const
	[取得] 選択アイテム取得. [詳解]

DWORD	GetExStyle (void) const
	[取得] ウィンドウ拡張スタイル取得. [詳解]

HWND	GetSafeHwnd (void) const
	[取得] ウィンドウハンドル取得. [詳解]

DWORD	GetStyle (void) const
	[取得] ウィンドウスタイル取得. [詳解]

CWnd *	GetWndCurSel (void) const
	[取得] 選択ウィンドウ取得. [詳解]

CWnd *	GetWndItem (int nItem) const
	[取得] ウィンドウ取得. [詳解]

BOOL	ModifyStyle (DWORD dwRemove, DWORD dwAdd, UINT nFlags=0)
	[設定] ウィンドウスタイル変更. [詳解]

BOOL	ModifyStyleEx (DWORD dwRemove, DWORD dwAdd, UINT nFlags=0)
	[設定] ウィンドウ拡張スタイル変更. [詳解]

int	SetCurSel (HWND page)
	[選択] タブ選択. [詳解]

int	SetCurSel (int nItem)
	[選択] タブ選択. [詳解]

BOOL	SetWindowPos (const CWnd *pWndInsertAfter, int x, int y, int cx, int cy, UINT nFlags)
	[設定] ウィンドウサイズポジション設定. [詳解]

BOOL	ShowWindow (int nCmdShow)
	[設定] ウィンドウ表示状態. [詳解]

限定公開メンバ関数
virtual BOOL	OnChildNotify (UINT message, WPARAM wParam, LPARAM lParam, LRESULT *_pResult)
	[通知] for notifications from parent [詳解]

virtual void	PreSubclassWindow (void)
	[通知] subclassing/unsubclassing functions. [詳解]

virtual LRESULT	WindowProc (UINT message, WPARAM wParam, LPARAM lParam)
	[通知] for processing Windows messages. [詳解]

限定公開変数類
CSimpleVectorT< CWnd * >	m_apPages
	ページウィンドウ群 [詳解]

詳解

template<typename TAB = CTabCtrl>
class TNB::MFC::CPagesTabCtrlT< TAB >

ページ付きタブコントロールテンプレート

タブの中に、指定のダイアログを持つことが出来るタブコントロールです。

使い方: リソースエディタでタブコントロールを張り、コントロール変数に割り当て後、そのコントロール変数の型（CTabCtrl）を本クラスに置き換えて使用します。 CDialog のサブクラスを作成し、 AddItem で追加するだけです

覚え書き: ウィンドウは AddItem() 時にクリエイトします。その際 WM_INITDIALOG メッセージを通知します。; タブ切替え時、新たに表示される画面に WM_ACTIVATE メッセージ（パラメタは WA_ACTIVE ）を通知します。今まで表示していた画面にも WM_ACTIVATE メッセージ（パラメタは WA_INACTIVE ）を通知します。

必要ファイル: TnbMfcPagesTabCtrl.h

日付: 09/04/06 新規作成; 09/04/17 TCM_SETCURSEL にも対応。; 09/05/26 CE用でも動作するように対応。; 09/06/16 WM_ACTIVATE メッセージ対応。; 10/03/23 Zオーダー、整理; 10/04/15 テンプレート化; 11/05/26 GetWndCurSel() 追加。; 11/06/07 GetWndItem() 追加。; 19/06/27 WM_MOVE メッセージにも対応。

TnbMfcPagesTabCtrl.h の 51 行目に定義があります。

関数詳解

◆ AddItem() [1/2]

int AddItem	(	LPCTSTR	lpszName,
		CDialog *	pWnd,
		UINT	idd
	)

[追加] アイテム追加.

引数

lpszName	アイテムネーム（タブ名）。
pWnd	ページになる CDialog のサブクラスのインスタンス（クリエイトしないこと）。本インスタンスで保持しないので、破棄しないでください。
idd	ページになる CDialog のリソースID。

戻り値

マイナス	エラー。
0以上	追加成功。値は追加したアイテムNo。

TnbMfcPagesTabCtrl.h の 79 行目に定義があります。

◆ AddItem() [2/2]

int AddItem	(	LPCTSTR	lpszName,
		TYP *	pWnd
	)

[追加] アイテム追加.

引数

lpszName	アイテムネーム（タブ名）。
pWnd	ページになる CDialog のサブクラスのインスタンス（クリエイトしないこと）。本インスタンスで保持しないので、破棄しないでください。

戻り値

マイナス	エラー。
0以上	追加成功。値は追加したアイテムNo。

TnbMfcPagesTabCtrl.h の 65 行目に定義があります。

◆ DeleteAllItems()

BOOL DeleteAllItems ( void )

[削除] 全アイテム削除.

戻り値

TRUE	削除成功。
FALSE	失敗。

TnbMfcPagesTabCtrl.h の 228 行目に定義があります。

◆ DeleteItem()

BOOL DeleteItem ( int nItem )

[削除] アイテム削除.

引数

nItem アイテムNo。

戻り値

TRUE	削除成功。
FALSE	失敗。

TnbMfcPagesTabCtrl.h の 212 行目に定義があります。

◆ FindItem()

int FindItem ( HWND page ) const

[検索] アイテム検索.

覚え書き: 指定のウィンドウハンドル(アイテム)を持っているアイテムNoを返します。

引数

page ウィンドウハンドル

戻り値

マイナス	なかった。
0以上	検索成功。値は発見したアイテムNo。

TnbMfcPagesTabCtrl.h の 132 行目に定義があります。

◆ GetCurSel()

int GetCurSel ( void ) const

[取得] 選択アイテム取得.

SetCurSel() で選択されたアイテムのインデックスを返します。

戻り値

0以上	選択されているアイテムのインデックス。
マイナス	選択されていない。

TnbMfcPagesTabCtrl.h の 189 行目に定義があります。

◆ GetExStyle()

DWORD GetExStyle ( void ) const

inherited

[取得] ウィンドウ拡張スタイル取得.

本インスタンスが管理しているウィンドウの拡張スタイルを返します。

戻り値: ウィンドウスタイル。 WS_EX_LEFT や WS_EX_TOPMOST などのシンボルが論理和(or)されている。

◆ GetSafeHwnd()

HWND GetSafeHwnd ( void ) const

inherited

[取得] ウィンドウハンドル取得.

本インスタンスが管理しているウィンドウのハンドルを返します。

戻り値: ウィンドウハンドル

◆ GetStyle()

DWORD GetStyle ( void ) const

inherited

[取得] ウィンドウスタイル取得.

本インスタンスが管理しているウィンドウのスタイルを返します。

戻り値: ウィンドウスタイル。 WS_CHILD や WS_MINIMIZE などのシンボルが論理和(or)されている。

◆ GetWndCurSel()

CWnd * GetWndCurSel ( void ) const

[取得] 選択ウィンドウ取得.

SetCurSel() で選択されたアイテムに登録されている CWnd のポインタを返します。この実体は、 AddItem() で登録されたインスタンスになっています。

戻り値

NULL以外	成功。値は CWnd のポインタ
NULL	失敗。選択されていない。

TnbMfcPagesTabCtrl.h の 201 行目に定義があります。

◆ GetWndItem()

CWnd * GetWndItem ( int nItem ) const

[取得] ウィンドウ取得.

指定のインデックスに登録された CWnd のポインタを返します。この実体は、 AddItem() で登録されたインスタンスになっています。

引数

nItem 取得するアイテムのインデックス

戻り値

NULL以外	成功。値は CWnd のポインタ
NULL	失敗。選択されていない。

TnbMfcPagesTabCtrl.h の 152 行目に定義があります。

◆ ModifyStyle()

BOOL ModifyStyle	(	DWORD	dwRemove,
		DWORD	dwAdd,
		UINT	nFlags = `0`
	)

inherited

[設定] ウィンドウスタイル変更.

引数

dwRemove	除去するスタイルを指定する。
dwAdd	追加するスタイルを指定する。
nFlags	SetWindowPos() に渡すフラグ。０なら SetWindowPos() を呼びません。

戻り値

TRUE	成功.
FALSE	失敗.

◆ ModifyStyleEx()

BOOL ModifyStyleEx	(	DWORD	dwRemove,
		DWORD	dwAdd,
		UINT	nFlags = `0`
	)

inherited

[設定] ウィンドウ拡張スタイル変更.

引数

dwRemove	除去する拡張スタイルを指定する。
dwAdd	追加する拡張スタイルを指定する。
nFlags	SetWindowPos() に渡すフラグ。０なら SetWindowPos() を呼びません。

戻り値

TRUE	成功.
FALSE	失敗.

◆ OnChildNotify()

virtual BOOL OnChildNotify	(	UINT	message,
		WPARAM	wParam,
		LPARAM	lParam,
		LRESULT *	_pResult
	)

protectedvirtual

[通知] for notifications from parent

覚え書き: CWndのメソッドをオーバーライドしています。メッセージ受信したらコールされます。

引数

[in]	message	メッセージ
[in]	wParam	WPARAM
[in]	lParam	LPARAM
[out]	_pResult	リザルト

戻り値

TRUE	処理済。
FALSE	未処理。

TnbMfcPagesTabCtrl.h の 267 行目に定義があります。

◆ PreSubclassWindow()

virtual void PreSubclassWindow ( void )

protectedvirtual

[通知] subclassing/unsubclassing functions.

サブクラス化する時コールされます。

覚え書き: CWndのメソッドをオーバーライドしています。

TnbMfcPagesTabCtrl.h の 250 行目に定義があります。

◆ SetCurSel() [1/2]

int SetCurSel ( HWND page )

[選択] タブ選択.

引数

page	ウィンドウハンドル。

戻り値

マイナス	失敗。
0以上	成功。値は直前に選択されていたインデックス。

TnbMfcPagesTabCtrl.h の 178 行目に定義があります。

◆ SetCurSel() [2/2]

int SetCurSel ( int nItem )

[選択] タブ選択.

引数

nItem 選択するアイテムのインデックス

戻り値

マイナス	失敗。
0以上	成功。値は直前に選択されていたインデックス。

TnbMfcPagesTabCtrl.h の 167 行目に定義があります。

◆ SetWindowPos()

BOOL SetWindowPos	(	const CWnd *	pWndInsertAfter,
		int	x,
		int	y,
		int	cx,
		int	cy,
		UINT	nFlags
	)

inherited

[設定] ウィンドウサイズポジション設定.

子ウィンドウ、ポップアップウィンドウ、およびトップレベルウィンドウのサイズ、位置、および Z オーダーを変更します。

引数

pWndInsertAfter	Z オーダーでこの CWnd オブジェクトより前に配置される CWnd オブジェクトを識別します。このパラメータへは、 CWnd へのポインタか次の値のいずれか 1 つを指定できます。 wndBottom ウィンドウを Z オーダーの一番下に置きます。この CWnd が最上位のウィンドウの場合、ウィンドウの最上位ステータスは失われます。システムでは、このウィンドウをほかのすべてのウィンドウよりも下に置きます。 wndTop ウィンドウを Z オーダーの先頭に置きます。 wndTopMost ウィンドウを最上位でないすべてのウィンドウの上に置きます。ウィンドウは、非アクティブになったときも、最上位の位置を保持します。 wndNoTopMost ウィンドウを最上位でないすべてのウィンドウの先頭に再配置します (つまり、一番手前のすべてのウィンドウの後ろに置きます)。ウィンドウが既に非最上位ウィンドウとなっているときは、このフラグは無効です。
x	ウィンドウの新しい左辺の位置を指定します。
y	ウィンドウの新しい上辺の位置を指定します。
cx	ウィンドウの新しい幅を指定します。
cy	ウィンドウの新しい高さを指定します。
nFlags	サイズ変更オプションおよび位置指定オプションを指定します。このパラメータには、次の値を組み合わせて指定できます。 SWP_DRAWFRAME ウィンドウの周りにフレーム (ウィンドウ作成時に定義されます) を描画します。 SWP_FRAMECHANGED ウィンドウのサイズが変化されていない場合でも、ウィンドウに WM_NCCALCSIZE メッセージを送信します。このフラグが指定されていない場合、WM_NCCALCSIZE メッセージはウィンドウのサイズが実際に変化しているときにだけ送られます。 SWP_HIDEWINDOW ウィンドウを非表示にします。 SWP_NOACTIVATE ウィンドウをアクティブにしません。このフラグが設定されていないと、ウィンドウはアクティブになり、最上位または非最上位のウィンドウグループのいずれかの先頭に移動されます (パラメータ pWndInsertAfter の設定に依存します)。 SWP_NOCOPYBITS クライアント領域の内容全体を破棄します。このフラグが指定されていない場合、クライアント領域の有効な内容はすべて保存されます。保存された内容は、ウィンドウのサイズや位置が再び変更されたときにクライアント領域に復元されます。 SWP_NOMOVE 現在位置を保持します (x パラメータと y パラメータを無視します)。 SWP_NOOWNERZORDER オーナーウィンドウの Z オーダーの位置を変更しません。 SWP_NOREDRAW 変更があっても再描画しません。このフラグが設定されていると、どのような種類の再描画も行われません。このことは、クライアント領域、非クライアント領域 (タイトルやスクロールバーを含みます)、ウィンドウが移動したことにより覆われない親ウィンドウのあらゆる部分に適用されます。このフラグが設定されているときは、アプリケーションは再描画が必要なウィンドウや親ウィンドウのあらゆる部分を明示的に無効領域または再描画する必要があります。 SWP_NOREPOSITION SWP_NOOWNERZORDER と同じです。 SWP_NOSENDCHANGING ウィンドウが WM_WINDOWPOSCHANGING メッセージを受信しないようにします。 SWP_NOSIZE 現在のサイズを保持します (cx パラメータと cy パラメータを無視します)。 SWP_NOZORDER 現在の順序を保持します (pWndInsertAfter を無視します)。 SWP_SHOWWINDOW ウィンドウを表示します。

戻り値

TRUE	成功.
FALSE	失敗.

◆ ShowWindow()

BOOL ShowWindow ( int nCmdShow )

inherited

[設定] ウィンドウ表示状態.

引数

nCmdShow

CWnd を表示する方法を指定します。次の値のいずれかになります。

SW_HIDE このウィンドウを非表示にし、他のウィンドウをアクティブにします。
SW_MINIMIZE ウィンドウを最小化し、システムのリストのトップレベルウィンドウをアクティブにします。
SW_RESTORE ウィンドウをアクティブにし、表示します。ウィンドウが最小化または最大化されている場合は、Windows によって元のサイズと位置に戻されます。
SW_SHOW ウィンドウをアクティブにし、現在のサイズと位置で表示します。
SW_SHOWMAXIMIZED ウィンドウをアクティブにし、最大表示します。
SW_SHOWMINIMIZED ウィンドウをアクティブにし、最小化して表示します。
SW_SHOWMINNOACTIVE ウィンドウを最小化して表示します。現在アクティブなウィンドウはアクティブなまま表示します。
SW_SHOWNA 現在の状態でウィンドウを表示します。現在アクティブなウィンドウはアクティブなまま表示します。
SW_SHOWNOACTIVATE ウィンドウを直前のサイズと位置で表示します。現在アクティブなウィンドウはアクティブなまま表示します。
SW_SHOWNORMAL ウィンドウをアクティブにし、表示します。ウィンドウが最小化または最大化されている場合は、Windows によって元のサイズと位置に戻されます。

戻り値

TRUE	成功.
FALSE	失敗.

◆ WindowProc()

virtual LRESULT WindowProc	(	UINT	message,
		WPARAM	wParam,
		LPARAM	lParam
	)

protectedvirtual

[通知] for processing Windows messages.

メッセージ受信したらコールされます。

覚え書き: CWndのメソッドをオーバーライドしています。

引数

message	メッセージ
wParam	WPARAM
lParam	LPARAM

戻り値: リザルト。

TnbMfcPagesTabCtrl.h の 289 行目に定義があります。

メンバ詳解

◆ m_apPages

CSimpleVectorT<CWnd*> m_apPages

protected

ページウィンドウ群

TnbMfcPagesTabCtrl.h の 243 行目に定義があります。

公開メンバ関数

限定公開メンバ関数

限定公開変数類

詳解

関数詳解

◆ AddItem() [1/2]

◆ AddItem() [2/2]

◆ DeleteAllItems()

◆ DeleteItem()

◆ FindItem()

◆ GetCurSel()

◆ GetExStyle()

◆ GetSafeHwnd()

◆ GetStyle()

◆ GetWndCurSel()

◆ GetWndItem()

◆ ModifyStyle()

◆ ModifyStyleEx()

◆ OnChildNotify()

◆ PreSubclassWindow()

◆ SetCurSel() [1/2]

◆ SetCurSel() [2/2]

◆ SetWindowPos()

◆ ShowWindow()

◆ WindowProc()

メンバ詳解

◆ m_apPages