拡張簡易リストウィンドウ [詳解]

#include <TnbMfcTinyListDialogEx.h>

CTinyListDialogEx の継承関係図

公開型
enum	EMenuId { MenuId_Hide = 1000 , MenuId_Clear = 1001 }
	メニューID [詳解]

enum	EMoveMode { CENTER , UNDER , RIGHT }
	移動モード型 [詳解]

enum	EShowMode { SHOW , HIDE , TOGGLE }
	表示モード型 [詳解]

公開メンバ関数
bool	Create (const CSize &size, HFONT hFont, HWND hParentWnd, LPCTSTR lpszTitle, HICON hIcon, UINT parentMenuItem=0)
	[作成] ウィンドウ作成. [詳解]

bool	Create (const CSize &size, HWND hParentWnd, LPCTSTR lpszTitle, HICON hIcon, UINT parentMenuItem=0)
	[作成] ウィンドウ作成. [詳解]

	CTinyListDialogEx (bool isColorMode=true)
	コンストラクタ. [詳解]

void	Destroy (void)
	[操作] ウィンドウの破棄. [詳解]

bool	IsWindow (void) const
	[確認] ウィンドウの有無. [詳解]

bool	IsWindowVisible (void)
	[確認] ウィンドウ表示状態. [詳解]

void	MoveWindow (EMoveMode mode=UNDER)
	[移動] ウィンドウ移動. [詳解]

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

void	PostString (int nIndex, LPCTSTR lpszItem, COLORREF colorText=0, COLORREF colorBack=0)
	[追加] 文字列追加. [詳解]

void	PostString (LPCTSTR lpszItem, COLORREF colorText=0, COLORREF colorBack=0)
	[追加] 文字列追加. [詳解]

void	PostStringCr (LPCTSTR lpszItem, COLORREF colorText=0, COLORREF colorBack=0)
	[追加] 文字列追加. [詳解]

CLightListBox &	ReferBwList (void)
	[参照] 白黒リストコントロール参照. [詳解]

CColorListBox &	ReferColorList (void)
	[参照] カラーリストコントロール参照. [詳解]

CMenu &	ReferMenu (void)
	[参照] メニュー参照. [詳解]

void	SetColor (int nIndex, COLORREF colorText, COLORREF colorBack)
	[設定] 文字色設定. [詳解]

void	SetCurrentColor (COLORREF colorText, COLORREF colorBack)
	[設定] 文字色設定. [詳解]

void	SetFont (CFont *pFont)
	[設定] フォント設定 [詳解]

void	SetMargin (DWORD m)
	[設定] マージン設定 [詳解]

void	SetMaxLine (int maxLine)
	[設定] 最大ライン数設定. [詳解]

void	SetPostViewMode (bool isView)
	[設定] PostString表示モード設定. [詳解]

void	SetTopMost (bool isTop=true)
	[表示] トップ表示. [詳解]

void	ShowWindow (EShowMode mode=SHOW)
	[表示] 表示切替. [詳解]

限定公開メンバ関数
virtual void	OnCommand (WPARAM wParam)
	[通知] コマンド通知 [詳解]

virtual void	OnCreate (void)
	[通知] 作成完了通知. [詳解]

virtual void	OnDestroy (void)
	[通知] 破棄通知. [詳解]

virtual bool	OnThreadDispatchReceive (UINT nMsg, WPARAM wParam, LPARAM lParam)
	[通知] メッセージ受信. [詳解]

virtual void	OnThreadDispatchSetup (void)
	[通知] 開始通知. [詳解]

詳解

拡張簡易リストウィンドウ

行単位で色を指定出来る ListBoxコントロールを画面一面にもつモードレスダイアログです。。

CTinyListDialog に比べ、本画面のメッセージキューを別途用意しているため、
メインダイアログでメッセージポンプを動かさずに長時間ログを出力しても、
本画面の更新が行われます。

覚え書き: 親ウィンドウの表示非表示メニューIDを Create() で指定すると、Show Hide により自動的に表示チェックが on off します。ただし、メニューアイテム選択時の Show Hide は自動化できません。親ダイアログのハンドラで xxx.ShowWindow(CTinyListDialog::TOGGLE); としてください。
// CTinyListDialogEx m_log;

void CFooDlg::OnIniDialog(void)

{

;

m_log.Create(CSize(100, 100), GetSafeHwnd(), "title", m_hIcon, ID_MENU_LIST_VIEW);

;

}

void CFooDlg::OnMenuListView(void)

{

m_log.ShowWindow(CTinyListDialog::TOGGLE);

}

TNB::MFC::CTinyListDialog::TOGGLE
@ TOGGLE
トグル
Definition: TnbMfcTinyListDialog.h:79

メニューIDを指定していない場合、 PostString() で表示されるようになります。; 以下のようにメイン画面で LOG 関数を用意しておくと便利です。
enum ELogType

{

RECV = RGB(204, 255, 204),

SEND = RGB(204, 255, 255),

NORMAL = RGB(255, 255, 255),

ERR = RGB(255,153,153),

};

void CFooDlg::Log(ELogType tt, LPCTSTR lpszFmt, ...)

{

va_list args;

va_start(args, lpszFmt);

CString s;

s.FormatV(lpszFmt, args);

va_end(args);

m_log.PostString(-1, s, RGB(0, 0, 0), tt);

}

void CFooDlg::Log(LPCTSTR lpszFmt, ...)

{

va_list args;

va_start(args, lpszFmt);

CString s;

s.FormatV(lpszFmt, args);

va_end(args);

m_log.PostString(-1, s, RGB(0, 0, 0), NORMAL);

}; 継承してメニュー項目を変更することも出来ます。

参照: CColorListBox; CTinyListDialog

必要ファイル: TnbMfcTinyListDialogEx.h

日付: 11/02/03 新規作成

TnbMfcTinyListDialogEx.h の 90 行目に定義があります。

列挙型メンバ詳解

◆ EMenuId

enum EMenuId

inherited

メニューID

列挙値
MenuId_Hide	隠す
MenuId_Clear	クリア

TnbMfcTinyListDialog.h の 68 行目に定義があります。

◆ EMoveMode

enum EMoveMode

inherited

移動モード型

列挙値
CENTER	中央
UNDER	下
RIGHT	右

TnbMfcTinyListDialog.h の 83 行目に定義があります。

◆ EShowMode

enum EShowMode

inherited

表示モード型

列挙値
SHOW	表示
HIDE	非表示
TOGGLE	トグル

TnbMfcTinyListDialog.h の 75 行目に定義があります。

構築子と解体子

◆ CTinyListDialogEx()

CTinyListDialogEx ( bool isColorMode = true )

コンストラクタ.

引数

isColorMode true ならカラーモード。 false なら白黒モードです。

TnbMfcTinyListDialogEx.h の 99 行目に定義があります。

関数詳解

◆ Create() [1/2]

bool Create	(	const CSize &	size,
		HFONT	hFont,
		HWND	hParentWnd,
		LPCTSTR	lpszTitle,
		HICON	hIcon,
		UINT	parentMenuItem = `0`
	)

[作成] ウィンドウ作成.

覚え書き: 非表示状態で作成されます。

引数

size	ウィンドウ大きさ
hFont	フォント
hParentWnd	親ウィンドウ
lpszTitle	ウィンドウタイトル
hIcon	ウィンドウアイコン
parentMenuItem	親ウィンドウの表示非表示メニュー。省略可能。

戻り値

true	作成成功
false	失敗

TnbMfcTinyListDialogEx.h の 115 行目に定義があります。

◆ Create() [2/2]

bool Create	(	const CSize &	size,
		HWND	hParentWnd,
		LPCTSTR	lpszTitle,
		HICON	hIcon,
		UINT	parentMenuItem = `0`
	)

[作成] ウィンドウ作成.

覚え書き: 非表示状態で作成されます。

引数

size	ウィンドウ大きさ
hParentWnd	親ウィンドウ
lpszTitle	ウィンドウタイトル
hIcon	ウィンドウアイコン
parentMenuItem	親ウィンドウの表示非表示メニュー。省略可能。

戻り値

true	作成成功
false	失敗

TnbMfcTinyListDialogEx.h の 143 行目に定義があります。

◆ Destroy()

void Destroy ( void )

[操作] ウィンドウの破棄.

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

◆ IsWindow()

bool IsWindow ( void ) const

inherited

[確認] ウィンドウの有無.

戻り値

true	有り
false	なし

TnbMfcTinyListDialog.h の 230 行目に定義があります。

◆ IsWindowVisible()

bool IsWindowVisible ( void )

inherited

[確認] ウィンドウ表示状態.

戻り値

true	表示中
false	非表示中（ウィンドウが作成されていない場合も false が返ります）

TnbMfcTinyListDialog.h の 240 行目に定義があります。

◆ MoveWindow()

void MoveWindow ( EMoveMode mode = UNDER )

inherited

[移動] ウィンドウ移動.

引数

mode 移動モード

TnbMfcTinyListDialog.h の 182 行目に定義があります。

◆ OnCommand()

virtual void OnCommand ( WPARAM wParam )

protectedvirtualinherited

[通知] コマンド通知

引数

wParam メニューID

TnbMfcTinyListDialog.h の 449 行目に定義があります。

◆ OnCreate()

virtual void OnCreate ( void )

protectedvirtualinherited

[通知] 作成完了通知.

覚え書き: ウィンドウ作成完了後に通知されます。

CDebugStringDialogで再実装されています。

TnbMfcTinyListDialog.h の 433 行目に定義があります。

◆ OnDestroy()

virtual void OnDestroy ( void )

protectedvirtualinherited

[通知] 破棄通知.

覚え書き: ウィンドウ破棄直前に通知されます。

CDebugStringDialogで再実装されています。

TnbMfcTinyListDialog.h の 441 行目に定義があります。

◆ OnThreadDispatchReceive()

virtual bool OnThreadDispatchReceive	(	UINT	nMsg,
		WPARAM	wParam,
		LPARAM	lParam
	)

protectedvirtual

[通知] メッセージ受信.

最後は必ず nMsg に WM_QUIT が入って通知されます。

引数

nMsg	メッセージ
wParam	WPARAM
lParam	LPARAM

戻り値

true	正常
false	切断要求

CThreadDispatch::IListenerを実装しています。

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

◆ OnThreadDispatchSetup()

virtual void OnThreadDispatchSetup ( void )

protectedvirtual

[通知] 開始通知.

受信スレッドが開始されると、通知されます。

CThreadDispatch::IListenerを再実装しています。

TnbMfcTinyListDialogEx.h の 164 行目に定義があります。

◆ operator HWND()

operator HWND ( void )

inherited

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

保持しているウィンドウのハンドルを返します。

戻り値: ハンドル

TnbMfcTinyListDialog.h の 220 行目に定義があります。

◆ PostString() [1/2]

void PostString	(	int	nIndex,
		LPCTSTR	lpszItem,
		COLORREF	colorText = `0`,
		COLORREF	colorBack = `0`
	)

inherited

[追加] 文字列追加.

指定した色で文字列を追加します。

覚え書き: 色の指定は、コンストラクタでカラーモードを指定した場合のみ、有効です。

引数

nIndex	文字列を挿入する位置を 0 から始まるインデックスで指定します。このパラメータが -1 の場合、文字列はリストの最後に追加されます。
lpszItem	挿入する文字列。
colorText	文字色指定(COLORREF)。省略した場合、最後に設定された文字色になります。
colorBack	背景色指定(COLORREF)。省略した場合、最後に設定された背景色になります。

TnbMfcTinyListDialog.h の 379 行目に定義があります。

◆ PostString() [2/2]

void PostString	(	LPCTSTR	lpszItem,
		COLORREF	colorText = `0`,
		COLORREF	colorBack = `0`
	)

inherited

[追加] 文字列追加.

指定した色で文字列を最後に追加します。

覚え書き: 別スレッドからでも追加が可能です。

注意: 改行コードは処理されません(その分高速です)。

引数

lpszItem	挿入する文字列。
colorText	文字色指定(COLORREF)。省略した場合、最後に設定された文字色になります。
colorBack	背景色指定(COLORREF)。省略した場合、最後に設定された背景色になります。

TnbMfcTinyListDialog.h の 404 行目に定義があります。

◆ PostStringCr()

void PostStringCr	(	LPCTSTR	lpszItem,
		COLORREF	colorText = `0`,
		COLORREF	colorBack = `0`
	)

inherited

[追加] 文字列追加.

指定した色で文字列を最後に追加します。改行コードがあれば複数行にして追加します。

覚え書き: 別スレッドからでも追加が可能です。

引数

lpszItem	挿入する文字列。
colorText	文字色指定(COLORREF)。省略した場合、最後に設定された文字色になります。
colorBack	背景色指定(COLORREF)。省略した場合、最後に設定された背景色になります。

TnbMfcTinyListDialog.h の 417 行目に定義があります。

◆ ReferBwList()

CLightListBox & ReferBwList ( void )

inherited

[参照] 白黒リストコントロール参照.

覚え書き: コンストラクタで白黒モードを指定した場合のみ、有効です。

戻り値: リストコントロールオブジェクト

TnbMfcTinyListDialog.h の 284 行目に定義があります。

◆ ReferColorList()

CColorListBox & ReferColorList ( void )

inherited

[参照] カラーリストコントロール参照.

覚え書き: コンストラクタでカラーモードを指定した場合のみ、有効です。

戻り値: リストコントロールオブジェクト

TnbMfcTinyListDialog.h の 273 行目に定義があります。

◆ ReferMenu()

CMenu & ReferMenu ( void )

inherited

[参照] メニュー参照.

覚え書き: Create() の前にメニューを作成（アタッチ・ロード）することで、処理メニューを変更できます。; OnCreate() を継承して、メニューの状態を変更することも可能です。

戻り値: メニューオブジェクト

TnbMfcTinyListDialog.h の 296 行目に定義があります。

◆ SetColor()

void SetColor	(	int	nIndex,
		COLORREF	colorText,
		COLORREF	colorBack
	)

inherited

[設定] 文字色設定.

指定行の色を指定します。

覚え書き: コンストラクタでカラーモードを指定した場合のみ、有効です。

引数

nIndex	インデックス
colorText	文字色指定(COLORREF)
colorBack	背景色指定(COLORREF)

TnbMfcTinyListDialog.h の 322 行目に定義があります。

◆ SetCurrentColor()

void SetCurrentColor	(	COLORREF	colorText,
		COLORREF	colorBack
	)

inherited

[設定] 文字色設定.

追加する文字列の色を指定します。

覚え書き: コンストラクタでカラーモードを指定した場合のみ、有効です。

引数

colorText	文字色指定(COLORREF)
colorBack	背景色指定(COLORREF)

TnbMfcTinyListDialog.h の 308 行目に定義があります。

◆ SetFont()

void SetFont ( CFont * pFont )

inherited

[設定] フォント設定

引数

pFont フォント

TnbMfcTinyListDialog.h の 352 行目に定義があります。

◆ SetMargin()

void SetMargin ( DWORD m )

inherited

[設定] マージン設定

引数

m 上下のマージン

TnbMfcTinyListDialog.h の 332 行目に定義があります。

◆ SetMaxLine()

void SetMaxLine ( int maxLine )

inherited

[設定] 最大ライン数設定.

引数

maxLine 最大ライン.

TnbMfcTinyListDialog.h の 342 行目に定義があります。

◆ SetPostViewMode()

void SetPostViewMode ( bool isView )

inherited

[設定] PostString表示モード設定.

覚え書き: PostString() 実行時、追加した文字列が表示するようにスクロールさせるか否か、設定できます。; コンストラクタでカラーモードを指定した場合のみ、有効です。

引数

isView true なら追加文字列が表示されるようにスクロールします。 false ならスクロールしません。

TnbMfcTinyListDialog.h の 363 行目に定義があります。

◆ SetTopMost()

void SetTopMost ( bool isTop = true )

inherited

[表示] トップ表示.

引数

isTop true なら常にTOPに表示されるようになります。 false なら通常です。

TnbMfcTinyListDialog.h の 263 行目に定義があります。

◆ ShowWindow()

void ShowWindow ( EShowMode mode = SHOW )

inherited

[表示] 表示切替.

引数

mode 表示モード

TnbMfcTinyListDialog.h の 249 行目に定義があります。

公開型

公開メンバ関数

限定公開メンバ関数

詳解

列挙型メンバ詳解

◆ EMenuId

◆ EMoveMode

◆ EShowMode

構築子と解体子

◆ CTinyListDialogEx()

関数詳解

◆ Create() [1/2]

◆ Create() [2/2]

◆ Destroy()

◆ IsWindow()

◆ IsWindowVisible()

◆ MoveWindow()

◆ OnCommand()

◆ OnCreate()

◆ OnDestroy()

◆ OnThreadDispatchReceive()

◆ OnThreadDispatchSetup()

◆ operator HWND()

◆ PostString() [1/2]

◆ PostString() [2/2]

◆ PostStringCr()

◆ ReferBwList()

◆ ReferColorList()

◆ ReferMenu()

◆ SetColor()

◆ SetCurrentColor()

◆ SetFont()

◆ SetMargin()

◆ SetMaxLine()

◆ SetPostViewMode()

◆ SetTopMost()

◆ ShowWindow()