TNB Library
公開型 | 公開メンバ関数 | 静的公開メンバ関数 | 限定公開型 | 限定公開メンバ関数 | 全メンバ一覧
CLightListBox クラス

LightListBoxコントロール [詳解]

#include <TnbMfcLightListBox.h>

+ CLightListBox の継承関係図

公開型

enum  
 シンボル定義 [詳解]
 
typedef CRingQueueT< CArrayPtrHandleT< TCHAR > > CDatas
 データ管理型 [詳解]
 

公開メンバ関数

int AddString (LPCTSTR lpszItem)
 [追加] 文字列追加. [詳解]
 
void AllSetSel (void)
 [選択] 全項目選択. [詳解]
 
 CLightListBox (void)
 コンストラクタ [詳解]
 
void Copy (bool boIsSelectOnly=true)
 [処理] 選択項目コピー. [詳解]
 
void DelayedRedraw (void)
 [設定] 遅延再描画指定. [詳解]
 
int DeleteString (UINT nIndex)
 [削除] 文字列削除. [詳解]
 
int DeleteStringEx (UINT nIndex)
 [削除] 文字列削除. [詳解]
 
const CDatasGetAllString (void) const
 [取得] 全文字列取得. [詳解]
 
DWORD GetExStyle (void) const
 [取得] ウィンドウ拡張スタイル取得. [詳解]
 
int GetMaxLine (void) const
 [取得] 最大ライン数取得. [詳解]
 
BOOL GetRedraw (void) const
 [取得] 再描画状態取得. [詳解]
 
HWND GetSafeHwnd (void) const
 [取得] ウィンドウハンドル取得. [詳解]
 
DWORD GetStyle (void) const
 [取得] ウィンドウスタイル取得. [詳解]
 
virtual void GetText (int nIndex, CString &rString) const
 [取得] 文字列取得. [詳解]
 
virtual int GetText (int nIndex, LPTSTR lpszBuffer) const
 [取得] 文字列取得. [詳解]
 
int InsertString (int nIndex, LPCTSTR lpszItem)
 [追加] 文字列追加. [詳解]
 
BOOL ModifyStyle (DWORD dwRemove, DWORD dwAdd, UINT nFlags=0)
 [設定] ウィンドウスタイル変更. [詳解]
 
BOOL ModifyStyleEx (DWORD dwRemove, DWORD dwAdd, UINT nFlags=0)
 [設定] ウィンドウ拡張スタイル変更. [詳解]
 
void PostString (int nIndex, LPCTSTR lpszItem)
 [追加] 文字列追加. [詳解]
 
void SetAllString (const CDatas &datas, int index=-1)
 [設定] 全文字列設定. [詳解]
 
void SetMargin (DWORD m)
 [設定] マージン設定 [詳解]
 
void SetMaxLine (int maxLine)
 [設定] 最大ライン数設定. [詳解]
 
void SetRedraw (BOOL bRedraw=TRUE)
 [設定] 再描画許可・禁止設定. [詳解]
 
void SetRedrawAbsolutely (void)
 [設定] 再描画許可. [詳解]
 
void SetTiming (DWORD postDrawTiming, DWORD lastDrawInterval)
 [設定] タイミング設定. [詳解]
 
BOOL SetWindowPos (const CWnd *pWndInsertAfter, int x, int y, int cx, int cy, UINT nFlags)
 [設定] ウィンドウサイズポジション設定. [詳解]
 
void SetWindowText (LPCTSTR lpszString)
 [設定] ウィンドウタイトル設定. [詳解]
 
BOOL ShowWindow (int nCmdShow)
 [設定] ウィンドウ表示状態. [詳解]
 
CString ToString (bool boIsSelectOnly=true)
 [処理] 文字列取得. [詳解]
 
void UpdateWindow (void)
 [処理] 再描画. [詳解]
 

静的公開メンバ関数

static LPTSTR CloneString (LPCTSTR lpszText)
 [作成] 文字列クローン作成. [詳解]
 

限定公開型

enum  { WM_CLB_POSTSTRING = WM_APP }
 

限定公開メンバ関数

virtual void DrawItem (LPDRAWITEMSTRUCT lpDrawItemStruct)
 [通知] オーナードロー通知. [詳解]
 
virtual void MeasureItem (LPMEASUREITEMSTRUCT lpMeasureItemStruct)
 [通知] オーナードロー計算通知. [詳解]
 
virtual void PostNcDestroy (void)
 [通知] 破棄終了後通知 [詳解]
 
virtual BOOL PreCreateWindow (CREATESTRUCT &cs)
 [通知] special pre-creation and window rect adjustment hooks. [詳解]
 
virtual void PreSubclassWindow (void)
 [通知] subclassing/unsubclassing functions. [詳解]
 
virtual LRESULT WindowProc (UINT message, WPARAM wParam, LPARAM lParam)
 [通知] for processing Windows messages. [詳解]
 

詳解

LightListBoxコントロール

多くの行を高速にもてる、軽い ListBoxコントロールです。

Ctrl+A , Ctrl+C が使える ListBoxコントロールです。
使い方
リソースエディタでリストボックスコントロールを張り、コントロール変数に割り当て後、 そのコントロール変数の型(CListBox)を本クラスに置き換えて使用します。
リストボックスのプロパティは、「オーナー描画(O)」を「固定」に 文字列ありのチェックを OFF にしておいてください。 更に LBS_NODATA のスタイルをつけて置いてください(CE の場合は、これをつけないでください)。
注意
LBS_NODATA は VC6 の場合、IDE からはこのスタイルをつけることは出来ません。 直接 rc ファイルを開き編集してください)。
覚え書き
スクロールすると、親に WM_VSCROLL を SendMessage します。LPARAM には 本コントロールの HWND を渡します。 そのため、 MFC の CWnd::OnVScroll() の第三引数の CScrollBar* には本クラスのインスタンスが渡ります。 CScrollBar* として操作しないように注意してください。
必要ファイル
TnbMfcLightListBox.h
日付
10/11/01 新規作成。
10/11/30 CE 用カスタマイズ。背景描画処理修正。
11/03/08 情報をリングキューに変更。
11/03/16 キューの管理を調整。
11/06/17 CEのDelete処理を修正。
12/11/05 デフォルトの行数を 10万行に低減。
14/01/10 GetText() を追加。「LBS_NODATA をつけると LBS_HASSTRING スタイルをつけられないので LB_GETTEXT が4byte しか得られない」 対策。

TnbMfcLightListBox.h56 行目に定義があります。

型定義メンバ詳解

◆ CDatas

データ管理型

TnbMfcLightListBox.h62 行目に定義があります。

列挙型メンバ詳解

◆ anonymous enum

anonymous enum
protectedinherited

TnbMfcListBoxCp.h232 行目に定義があります。

◆ anonymous enum

anonymous enum
inherited

シンボル定義

TnbMfcSetRedrawEx.h46 行目に定義があります。

構築子と解体子

◆ CLightListBox()

CLightListBox ( void  )

コンストラクタ

TnbMfcLightListBox.h65 行目に定義があります。

関数詳解

◆ AddString()

int AddString ( LPCTSTR  lpszItem)

[追加] 文字列追加.

文字列を最後に追加します。

覚え書き
別スレッドからの実行は、予想外の動作をすることがあります。 PostString() を使用してください。
引数
lpszItem追加する文字列。
戻り値
マイナスエラー。
0以上成功。挿入されたインデックスを返します。

TnbMfcLightListBox.h132 行目に定義があります。

◆ AllSetSel()

void AllSetSel ( void  )
inherited

[選択] 全項目選択.

TnbMfcListBoxCp.h83 行目に定義があります。

◆ CloneString()

static LPTSTR CloneString ( LPCTSTR  lpszText)
static

[作成] 文字列クローン作成.

指定の文字列を複製します。

引数
lpszText文字列
戻り値
複製した文字列のポインタ。 いらなくなったら delete[] すること。

TnbMfcLightListBox.h198 行目に定義があります。

◆ Copy()

void Copy ( bool  boIsSelectOnly = true)
inherited

[処理] 選択項目コピー.

LIST 内の文字列を改行で連結し、クリップボードへコピーします。

引数
boIsSelectOnlytrue なら選択されている項目のみを収集します。

TnbMfcListBoxCp.h124 行目に定義があります。

◆ DelayedRedraw()

void DelayedRedraw ( void  )
inherited

[設定] 遅延再描画指定.

内容更新時、その前にこのメソッドをコールして置きます。

TnbMfcDelayedRedraw.h74 行目に定義があります。

◆ DeleteString()

int DeleteString ( UINT  nIndex)
inherited

[削除] 文字列削除.

覚え書き
削除後、表示位置を top に戻します。
引数
nIndex削除する文字列を 0 から始まるインデックスで指定します。
戻り値
LB_ERRエラー。
上記以外成功。数値は、残りのアイテム数

TnbMfcListBoxCp.h186 行目に定義があります。

◆ DeleteStringEx()

int DeleteStringEx ( UINT  nIndex)
inherited

[削除] 文字列削除.

覚え書き
表示位置を変えずに、文字列を削除します。
引数
nIndex削除する文字列を 0 から始まるインデックスで指定します。
戻り値
LB_ERRエラー。
上記以外成功。数値は、残りのアイテム数

TnbMfcListBoxCp.h198 行目に定義があります。

◆ DrawItem()

virtual void DrawItem ( LPDRAWITEMSTRUCT  lpDrawItemStruct)
protectedvirtual

[通知] オーナードロー通知.

引数
lpDrawItemStructドロー要求状態

TnbMfcLightListBox.h212 行目に定義があります。

◆ GetAllString()

const CDatas & GetAllString ( void  ) const

[取得] 全文字列取得.

戻り値
全データ

TnbMfcLightListBox.h187 行目に定義があります。

◆ GetExStyle()

DWORD GetExStyle ( void  ) const
inherited

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

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

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

◆ GetMaxLine()

int GetMaxLine ( void  ) const
inherited

[取得] 最大ライン数取得.

戻り値
0未満最大ライン、未指定.
0以上

TnbMfcListBoxCp.h75 行目に定義があります。

◆ GetRedraw()

BOOL GetRedraw ( void  ) const
inherited

[取得] 再描画状態取得.

戻り値
TRUE再描画許可状態。
FALSE再描画禁止状態。

TnbMfcSetRedrawEx.h77 行目に定義があります。

◆ GetSafeHwnd()

HWND GetSafeHwnd ( void  ) const
inherited

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

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

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

◆ GetStyle()

DWORD GetStyle ( void  ) const
inherited

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

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

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

◆ GetText() [1/2]

virtual void GetText ( int  nIndex,
CString &  rString 
) const
virtual

[取得] 文字列取得.

引数
[in]nIndex取得する文字列を 0 から始まるインデックスで指定します。
[out]rString文字列を格納されます。

CListBoxCpを再実装しています。

TnbMfcLightListBox.h159 行目に定義があります。

◆ GetText() [2/2]

virtual int GetText ( int  nIndex,
LPTSTR  lpszBuffer 
) const
virtual

[取得] 文字列取得.

引数
[in]nIndex取得する文字列を 0 から始まるインデックスで指定します。
[out]lpszBuffer文字列を格納するアドレスを指定します。
戻り値
LB_ERRエラー。
上記以外成功。数値は、取得した文字数。

CListBoxCpを再実装しています。

TnbMfcLightListBox.h144 行目に定義があります。

◆ InsertString()

int InsertString ( int  nIndex,
LPCTSTR  lpszItem 
)

[追加] 文字列追加.

文字列を追加します。

覚え書き
別スレッドからの実行は、予想外の動作をすることがあります。 PostString() を使用してください。
引数
nIndex文字列を挿入する位置を 0 から始まるインデックスで指定します。 このパラメータが -1 の場合、文字列はリストの最後に追加されます。
lpszItem挿入する文字列。
戻り値
マイナスエラー。
0以上成功。挿入されたインデックスを返します。

TnbMfcLightListBox.h118 行目に定義があります。

◆ MeasureItem()

virtual void MeasureItem ( LPMEASUREITEMSTRUCT  lpMeasureItemStruct)
protectedvirtual

[通知] オーナードロー計算通知.

引数
lpMeasureItemStructドロー要求状態

TnbMfcLightListBox.h256 行目に定義があります。

◆ ModifyStyle()

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

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

引数
dwRemove除去するスタイルを指定する。
dwAdd追加するスタイルを指定する。
nFlagsSetWindowPos() に渡すフラグ。0なら SetWindowPos() を呼びません。
戻り値
TRUE成功.
FALSE失敗.

◆ ModifyStyleEx()

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

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

引数
dwRemove除去する拡張スタイルを指定する。
dwAdd追加する拡張スタイルを指定する。
nFlagsSetWindowPos() に渡すフラグ。0なら SetWindowPos() を呼びません。
戻り値
TRUE成功.
FALSE失敗.

◆ PostNcDestroy()

virtual void PostNcDestroy ( void  )
protectedvirtual

[通知] 破棄終了後通知

CSetRedrawExAddinT< CListBoxCp >を再実装しています。

TnbMfcLightListBox.h400 行目に定義があります。

◆ PostString()

void PostString ( int  nIndex,
LPCTSTR  lpszItem 
)

[追加] 文字列追加.

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

覚え書き
別スレッドからでも追加が可能です。
引数
nIndexダミーです。常に文字列はリストの最後に追加されます。
lpszItem挿入する文字列。

TnbMfcLightListBox.h99 行目に定義があります。

◆ PreCreateWindow()

virtual BOOL PreCreateWindow ( CREATESTRUCT &  cs)
protectedvirtualinherited

[通知] special pre-creation and window rect adjustment hooks.

Create時コールされます。

覚え書き
CWndのメソッドをオーバーライドしています。
引数
cs構築データ.
戻り値
結果.

TnbMfcSetRedrawEx.h160 行目に定義があります。

◆ PreSubclassWindow()

virtual void PreSubclassWindow ( void  )
protectedvirtual

[通知] subclassing/unsubclassing functions.

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

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

CDelayedRedrawAddinT< CListBoxCp >を再実装しています。

TnbMfcLightListBox.h382 行目に定義があります。

◆ SetAllString()

void SetAllString ( const CDatas datas,
int  index = -1 
)

[設定] 全文字列設定.

引数
datas全データ
index表示ライン。省略すると最終行を表示します。

TnbMfcLightListBox.h172 行目に定義があります。

◆ SetMargin()

void SetMargin ( DWORD  m)

[設定] マージン設定

引数
m上下のマージン

TnbMfcLightListBox.h86 行目に定義があります。

◆ SetMaxLine()

void SetMaxLine ( int  maxLine)

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

覚え書き
デフォルトは 10万行です。
引数
maxLine最大ライン。 -1 なら、最大ラインのチェックをしません(推奨しません)。

TnbMfcLightListBox.h76 行目に定義があります。

◆ SetRedraw()

void SetRedraw ( BOOL  bRedraw = TRUE)
inherited

[設定] 再描画許可・禁止設定.

覚え書き
これをアドオンすると、カウンタ式になります。つまり、禁止を3回行ったら、 許可を3階しないと、再描画されるようになりません。
引数
bRedrawTURE なら再描画を許可します。 FALSE なら禁止します。

TnbMfcSetRedrawEx.h57 行目に定義があります。

◆ SetRedrawAbsolutely()

void SetRedrawAbsolutely ( void  )
inherited

[設定] 再描画許可.

覚え書き
カウンタを初期化し、かならず再描画されるようにします。

TnbMfcSetRedrawEx.h66 行目に定義があります。

◆ SetTiming()

void SetTiming ( DWORD  postDrawTiming,
DWORD  lastDrawInterval 
)
inherited

[設定] タイミング設定.

引数
postDrawTiming内容更新が続いている間、再描画するタイミング(ms)。(def.200)
lastDrawInterval内容更新がひと段落したと判断する時間(ms)。(def.100)

TnbMfcDelayedRedraw.h64 行目に定義があります。

◆ SetWindowPos()

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

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

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

引数
pWndInsertAfterZ オーダーでこの 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失敗.

◆ SetWindowText()

void SetWindowText ( LPCTSTR  lpszString)
inherited

[設定] ウィンドウタイトル設定.

引数
lpszString文字列.

TnbMfcDelayedRedraw.h92 行目に定義があります。

◆ ShowWindow()

BOOL ShowWindow ( int  nCmdShow)
inherited

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

引数
nCmdShowCWnd を表示する方法を指定します。次の値のいずれかになります。
  • SW_HIDE このウィンドウを非表示にし、他のウィンドウをアクティブにします。
  • SW_MINIMIZE ウィンドウを最小化し、システムのリストのトップレベル ウィンドウをアクティブにします。
  • SW_RESTORE ウィンドウをアクティブにし、表示します。ウィンドウが最小化または最大化されている場合は、Windows によって元のサイズと位置に戻されます。
  • SW_SHOW ウィンドウをアクティブにし、現在のサイズと位置で表示します。
  • SW_SHOWMAXIMIZED ウィンドウをアクティブにし、最大表示します。
  • SW_SHOWMINIMIZED ウィンドウをアクティブにし、最小化して表示します。
  • SW_SHOWMINNOACTIVE ウィンドウを最小化して表示します。現在アクティブなウィンドウはアクティブなまま表示します。
  • SW_SHOWNA 現在の状態でウィンドウを表示します。現在アクティブなウィンドウはアクティブなまま表示します。
  • SW_SHOWNOACTIVATE ウィンドウを直前のサイズと位置で表示します。現在アクティブなウィンドウはアクティブなまま表示します。
  • SW_SHOWNORMAL ウィンドウをアクティブにし、表示します。ウィンドウが最小化または最大化されている場合は、Windows によって元のサイズと位置に戻されます。
戻り値
TRUE成功.
FALSE失敗.

◆ ToString()

CString ToString ( bool  boIsSelectOnly = true)
inherited

[処理] 文字列取得.

LIST 内の文字列を改行で連結し返します。

引数
boIsSelectOnlytrue なら選択されている項目のみを収集します。
戻り値
文字列。

TnbMfcListBoxCp.h98 行目に定義があります。

◆ UpdateWindow()

void UpdateWindow ( void  )
inherited

[処理] 再描画.

覚え書き
遅延描画せず、すぐに描画指示します。

TnbMfcDelayedRedraw.h102 行目に定義があります。

◆ WindowProc()

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

[通知] for processing Windows messages.

メッセージ受信したらコールされます。 ListBox 関係のメッセージをフックしています。

覚え書き
CWndのメソッドをオーバーライドしています。
引数
messageメッセージ
wParamWPARAM
lParamLPARAM
戻り値
リザルト。

CDelayedRedrawAddinT< CListBoxCp >を再実装しています。

TnbMfcLightListBox.h270 行目に定義があります。