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

描画情報ボタンコントロール [詳解]

#include <TnbMfcDrawingButton.h>

+ CDrawingButton の継承関係図

公開型

enum  EPressMode { PM_Unused , PM_Message , PM_Lockable }
 プレスモード種 [詳解]
 

公開メンバ関数

bool AdjustSize (void)
 [設定] サイズ調整. [詳解]
 
 CDrawingButton (void)
 コンストラクタ [詳解]
 
int GetCheck (void) const
 [取得] チェック状態取得. [詳解]
 
DWORD GetExStyle (void) const
 [取得] ウィンドウ拡張スタイル取得. [詳解]
 
HWND GetSafeHwnd (void) const
 [取得] ウィンドウハンドル取得. [詳解]
 
UINT GetState (void) const
 [取得] 状態取得. [詳解]
 
DWORD GetStyle (void) const
 [取得] ウィンドウスタイル取得. [詳解]
 
BOOL ModifyStyle (DWORD dwRemove, DWORD dwAdd, UINT nFlags=0)
 [設定] ウィンドウスタイル変更. [詳解]
 
BOOL ModifyStyleEx (DWORD dwRemove, DWORD dwAdd, UINT nFlags=0)
 [設定] ウィンドウ拡張スタイル変更. [詳解]
 
void SetBitmapChangeTime (UINT ms)
 [設定] ビットマップ切り替え時間設定. [詳解]
 
void SetCheck (int nCheck)
 [設定] チェック状態設定. [詳解]
 
void SetDefaultButtonStyle (void)
 [設定] デフォルトボタンスタイル設定. [詳解]
 
void SetDisableDrawer (const IDrawable &draw)
 [設定] Disable時の描画情報指定. [詳解]
 
void SetNormalDrawer (const IDrawable &draw)
 [設定] 通常時の描画情報指定. [詳解]
 
void SetPartsDrawer (IPartsDrawable *pPartsDraw=NULL)
 [設定] パーツ描画指定. [詳解]
 
void SetPressedMode (bool isEnable)
 [設定] プレスモード設定. [詳解]
 
void SetPressedMode (EPressMode pm)
 [設定] プレスモード設定. [詳解]
 
void SetShortcutKey (TCHAR key)
 [設定] ショートカットキー設定. [詳解]
 
BOOL SetWindowPos (const CWnd *pWndInsertAfter, int x, int y, int cx, int cy, UINT nFlags)
 [設定] ウィンドウサイズポジション設定. [詳解]
 
BOOL ShowWindow (int nCmdShow)
 [設定] ウィンドウ表示状態. [詳解]
 

限定公開型

enum  EState { ES_Normal , ES_Hover , ES_Pushed , ES_Disable }
 状態 [詳解]
 

限定公開メンバ関数

EState GetButtonState (void) const
 [取得] ボタン状態取得. [詳解]
 
EKind GetKind (void) const
 [取得] 種類取得. [詳解]
 
virtual int GetLineHeight (CDC *pDC)
 [取得] 一行高さ. [詳解]
 
LONG GetOriginalStyle (void) const
 [取得] オリジナルスタイル取得. [詳解]
 
virtual bool HasFocus (void) const
 [確認] フォーカスの有無 [詳解]
 
virtual bool IsOnButton (const POINT &po) const
 [確認] ポイントがボタン上にあるか. [詳解]
 
bool IsPushButtonStyle (void) const
 [確認] ボタンタイプ取得 [詳解]
 
void MakeButtonImage (CDC *pDC)
 [処理] 描画. [詳解]
 
virtual void OnChangeState (EState state)
 [通知] 状態変化通知. [詳解]
 
virtual EState OnCheckState (EState st)
 [通知] 現在の状態確認通知 [詳解]
 
virtual BOOL OnChildNotify (UINT message, WPARAM wParam, LPARAM lParam, LRESULT *_pResult)
 [通知] for notifications from parent [詳解]
 
virtual void OnClickButton (void)
 [通知] クリック. [詳解]
 
virtual void OnDrawButton (CDC *pDC)
 [処理] 描画. [詳解]
 
virtual void PreSubclassWindow (void)
 [通知] subclassing/unsubclassing functions. [詳解]
 
IPartsDrawableReferPartsDraw (void)
 [取得] パーツ描画インターフェース取得. [詳解]
 
void SetButtonState (EState s)
 [設定] ボタン状態設定. [詳解]
 
void SetSendDblClkMode (bool canSendDblClk)
 [設定] ダブルクリックイベントサポート [詳解]
 
virtual LRESULT WindowProc (UINT message, WPARAM wParam, LPARAM lParam)
 [通知] for processing Windows messages. [詳解]
 

詳解

描画情報ボタンコントロール

覚え書き
リソースエディタでの設定のコントロールになります。
使い方
リソースエディタでボタンかラジオボタンかチェックボックスコントロールを張り、コントロール変数に割り当て後、 そのコントロール変数の型(CButton)を本クラスに置き換えて使用します。
参照
CAbstractButton
必要ファイル
TnbMfcDrawingButton.h
日付
07/11/24 新規作成
07/12/20 3ステートチェックボックスのプッシュボタン型にも対応(Check時はDrawをハーフトーンで表示)。
07/12/20 プッシュボタンの動作を修正。

TnbMfcDrawingButton.h44 行目に定義があります。

列挙型メンバ詳解

◆ EPressMode

enum EPressMode
inherited

プレスモード種

列挙値
PM_Unused 

通常ボタン

PM_Message 

プレスメッセージ対応

PM_Lockable 

プレスロック機能も有効

TnbMfcAbstractButton.h165 行目に定義があります。

◆ EState

enum EState
protectedinherited

状態

列挙値
ES_Normal 

標準状態

ES_Hover 

ホバー状態

ES_Pushed 

押下状態

ES_Disable 

無効状態

TnbMfcAbstractButton.h199 行目に定義があります。

構築子と解体子

◆ CDrawingButton()

CDrawingButton ( void  )

コンストラクタ

TnbMfcDrawingButton.h494 行目に定義があります。

関数詳解

◆ AdjustSize()

bool AdjustSize ( void  )

[設定] サイズ調整.

コントロールの大きさを現在の設定に適した(最小の)大きさに変更します。

戻り値
true成功。
false失敗。

TnbMfcDrawingButton.h563 行目に定義があります。

◆ GetButtonState()

EState GetButtonState ( void  ) const
protectedinherited

[取得] ボタン状態取得.

覚え書き
現在の状態を取得します
戻り値
状態。

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

◆ GetCheck()

int GetCheck ( void  ) const

[取得] チェック状態取得.

戻り値
BST_UNCHECKEDボタンがオフの状態
BST_CHECKEDボタンがオンの状態
BST_INDETERMINATEボタンの状態が不確定 (ボタンに BS_3STATE スタイルまたは BS_AUTO3STATE スタイルが設定されているときだけ)

TnbMfcDrawingButton.h607 行目に定義があります。

◆ GetExStyle()

DWORD GetExStyle ( void  ) const
inherited

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

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

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

◆ GetKind()

EKind GetKind ( void  ) const
protected

[取得] 種類取得.

戻り値
種類

TnbMfcDrawingButton.h105 行目に定義があります。

◆ GetLineHeight()

virtual int GetLineHeight ( CDC *  pDC)
protectedvirtual

[取得] 一行高さ.

覚え書き
チェックボックス、ラジオボタンの上付き下付きの位置を計算する時に使用されます。
引数
pDCデバイスコンテキスト
戻り値
高さ

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

TnbMfcDrawingButton.h135 行目に定義があります。

◆ GetOriginalStyle()

LONG GetOriginalStyle ( void  ) const
protected

[取得] オリジナルスタイル取得.

戻り値
BUTTONスタイル.

TnbMfcDrawingButton.h111 行目に定義があります。

◆ GetSafeHwnd()

HWND GetSafeHwnd ( void  ) const
inherited

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

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

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

◆ GetState()

UINT GetState ( void  ) const
inherited

[取得] 状態取得.

オプション ボタンまたはチェック ボックスの状態を取得します。

戻り値
状態。次のマスク値が使用できます。
マスク 説明
0x0003 オン、オフ状態を調べます (オプション ボタンとチェック ボックスの場合だけ)。 0 のときは、ボタンはオフです。1 のときは、ボタンはオンです。オプション ボタンはチェック マーク (?) が付いている状態がオンです。チェック ボックスは X マークが付いている状態がオンです。2 は、チェック状態が不確定であることを示します (3 ステート チェック ボックスのみ)。 3 ステート チェック ボックスは淡色表示状態のとき不確定状態を示します。
0x0004 強調表示状態を調べます。0 以外の値のときは、ボタンが強調表示状態です。 マウスの左ボタンをクリックしたままにすると、ボタンは強調表示状態になります。 マウス ボタンを離すと、強調表示状態は解除されます。
0x0008 フォーカス状態を調べます。0 以外の値のときは、ボタンにフォーカスがあることを示します。

TnbMfcAbstractButton.h158 行目に定義があります。

◆ GetStyle()

DWORD GetStyle ( void  ) const
inherited

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

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

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

◆ HasFocus()

virtual bool HasFocus ( void  ) const
protectedvirtualinherited

[確認] フォーカスの有無

戻り値
trueフォーカスあり。
falseフォーカスなし。

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

TnbMfcAbstractButton.h298 行目に定義があります。

◆ IsOnButton()

virtual bool IsOnButton ( const POINT &  po) const
protectedvirtualinherited

[確認] ポイントがボタン上にあるか.

引数
poスクリーン座標。
戻り値
true上にある。
falseない。

TnbMfcAbstractButton.h249 行目に定義があります。

◆ IsPushButtonStyle()

bool IsPushButtonStyle ( void  ) const
protected

[確認] ボタンタイプ取得

戻り値
trueプッシュボタンタイプ.
false否。

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

◆ MakeButtonImage()

void MakeButtonImage ( CDC *  pDC)
protected

[処理] 描画.

引数
pDCデバイスコンテキスト。

TnbMfcDrawingButton.h173 行目に定義があります。

◆ 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失敗.

◆ OnChangeState()

virtual void OnChangeState ( EState  state)
protectedvirtual

[通知] 状態変化通知.

覚え書き
現在の状態を取得します
引数
state状態。

CAbstractButtonを再実装しています。

TnbMfcDrawingButton.h389 行目に定義があります。

◆ OnCheckState()

virtual EState OnCheckState ( EState  st)
protectedvirtualinherited

[通知] 現在の状態確認通知

引数
st現在の状態
戻り値
新しい状態

TnbMfcAbstractButton.h259 行目に定義があります。

◆ OnChildNotify()

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

[通知] for notifications from parent

覚え書き
CWndのメソッドをオーバーライドしています。 メッセージ受信したらコールされます。
引数
[in]messageメッセージ
[in]wParamWPARAM
[in]lParamLPARAM
[out]_pResultリザルト
戻り値
TRUE処理済。
FALSE未処理。

TnbMfcAbstractButton.h332 行目に定義があります。

◆ OnClickButton()

virtual void OnClickButton ( void  )
protectedvirtual

[通知] クリック.

BN_CLICKED を親に通知する前にコールされます。

CAbstractButtonを再実装しています。

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

TnbMfcDrawingButton.h357 行目に定義があります。

◆ OnDrawButton()

virtual void OnDrawButton ( CDC *  pDC)
protectedvirtual

[処理] 描画.

引数
pDCデバイスコンテキスト。

CAbstractButtonを実装しています。

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

◆ PreSubclassWindow()

virtual void PreSubclassWindow ( void  )
protectedvirtual

[通知] subclassing/unsubclassing functions.

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

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

CAbstractButtonを再実装しています。

CColorSelectButton, CDrawingButtonTxで再実装されています。

TnbMfcDrawingButton.h444 行目に定義があります。

◆ ReferPartsDraw()

IPartsDrawable * ReferPartsDraw ( void  )
protected

[取得] パーツ描画インターフェース取得.

戻り値
パーツ描画インターフェース

TnbMfcDrawingButton.h117 行目に定義があります。

◆ SetBitmapChangeTime()

void SetBitmapChangeTime ( UINT  ms)

[設定] ビットマップ切り替え時間設定.

状態が変わってビットマップを変更する時、デフォルトでは、切り替え前のビットマップと、 切り替え後のビットマップの50%合成の画像を 30ms 秒表示するようになっています(そのため ふわっと切り替わるように見えます)。この切り替え時間を本メソッドで指定することが出来ます。

覚え書き
合成画像は一枚しか用意しないため、100msぐらいが上限です。
引数
ms切り替え時間(単位 ms)。

TnbMfcDrawingButton.h526 行目に定義があります。

◆ SetButtonState()

void SetButtonState ( EState  s)
protectedinherited

[設定] ボタン状態設定.

覚え書き
内部情報を書き換えるだけです。再表示はしません。
引数
s状態。

TnbMfcAbstractButton.h222 行目に定義があります。

◆ SetCheck()

void SetCheck ( int  nCheck)

[設定] チェック状態設定.

引数
nCheck以下のパラメータを指定できます。
パラメータ 説明
BST_UNCHECKED ボタンがオフの状態
BST_CHECKED ボタンがオンの状態
BST_INDETERMINATE ボタンの状態が不確定

TnbMfcDrawingButton.h626 行目に定義があります。

◆ SetDefaultButtonStyle()

void SetDefaultButtonStyle ( void  )
inherited

[設定] デフォルトボタンスタイル設定.

本ボタンにデフォルトボタンスタイルをつけます。

覚え書き
他のボタンにフォーカスがない時に、リターンを押下すると動作するのが、デフォルトボタンです。

TnbMfcAbstractButton.h127 行目に定義があります。

◆ SetDisableDrawer()

void SetDisableDrawer ( const IDrawable draw)

[設定] Disable時の描画情報指定.

引数
draw描画情報。クローンを記憶しまうので、破棄してもかまいません。

TnbMfcDrawingButton.h548 行目に定義があります。

◆ SetNormalDrawer()

void SetNormalDrawer ( const IDrawable draw)

[設定] 通常時の描画情報指定.

引数
draw描画情報。クローンを記憶しまうので、破棄してもかまいません。

TnbMfcDrawingButton.h535 行目に定義があります。

◆ SetPartsDrawer()

void SetPartsDrawer ( IPartsDrawable pPartsDraw = NULL)

[設定] パーツ描画指定.

引数
pPartsDrawパーツ描画。参照のみ記憶します。破棄しないでください。 未指定時や、 NULL 指定時は、標準のコントロールを表示します。
覚え書き
本クラスでは、 IPartsDrawable の GetPushedOffset() , DrawFrameControl() , DrawFocusRect() を使用します。

TnbMfcDrawingButton.h505 行目に定義があります。

◆ SetPressedMode() [1/2]

void SetPressedMode ( bool  isEnable)
inherited

[設定] プレスモード設定.

プレスロックモード付きのボタンにすることが出来ます。 プレスモードにすると、プレスすると親ウィンドウに BN_PUSHED_T が、 リリースすると BN_UNPUSHED_T が通知されます。

引数
isEnabletrue ならプレスモード。 false なら通常ボタンにします。

TnbMfcAbstractButton.h179 行目に定義があります。

◆ SetPressedMode() [2/2]

void SetPressedMode ( EPressMode  pm)
inherited

[設定] プレスモード設定.

プレスメッセージ、プレスロックモード付きのボタンにすることが出来ます。 プレスモードにすると、プレスすると親ウィンドウに BN_PUSHED_T が、 リリースすると BN_UNPUSHED_T が通知されます。

引数
pmプレスモード

TnbMfcAbstractButton.h191 行目に定義があります。

◆ SetSendDblClkMode()

void SetSendDblClkMode ( bool  canSendDblClk)
protectedinherited

[設定] ダブルクリックイベントサポート

覚え書き
デフォルトでは false です。
引数
canSendDblClktrue なら、 BN_DOUBLECLICKED を親に通知するようになります。

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

◆ SetShortcutKey()

void SetShortcutKey ( TCHAR  key)
inherited

[設定] ショートカットキー設定.

フォーカスが無いときでもキーボードの ALT + で押せるショートカットキーに対応するキーを指定します。 指定しない場合、ショートカットは出来ません。

引数
keyキー。 'A' 〜 'Z' を指定します。

TnbMfcAbstractButton.h117 行目に定義があります。

◆ 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失敗.

◆ 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失敗.

◆ WindowProc()

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

[通知] for processing Windows messages.

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

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

CAbstractButtonを再実装しています。

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

TnbMfcDrawingButton.h403 行目に定義があります。