日付と時刻の選択コントロールを含むツール バー ボタン。
構文
class CMFCToolBarDateTimeCtrl : public CMFCToolBarButton
メンバー
パブリック コンストラクター
| 名前 | 説明 |
|---|---|
| CMFCToolBarDateTimeCtrl::CMFCToolBarDateTimeCtrl | CMFCToolBarDateTimeCtrl オブジェクトを構築します。 |
CMFCToolBarDateTimeCtrl::~CMFCToolBarDateTimeCtrl |
デストラクターです。 |
パブリック メソッド
| 名前 | 説明 |
|---|---|
| CMFCToolBarDateTimeCtrl::CanBeStretched | ユーザーがカスタマイズ中にボタンを拡大できるかどうかを指定します。 ( をオーバーライドしますCMFCToolBarButton::CanBeStretched.) |
| CMFCToolBarDateTimeCtrl::CopyFrom | 別のツール バー ボタンのプロパティを現在のボタンにコピーします。 ( をオーバーライドしますCMFCToolBarButton::CopyFrom.) |
CMFCToolBarDateTimeCtrl::DuplicateData |
将来の使用のために予約済み。 |
| CMFCToolBarButton::ExportToMenuButton | ツール バー ボタンからメニューにテキストをコピーします。 |
CMFCToolBarDateTimeCtrl::CreateObject |
このクラス型の動的インスタンスを作成するために、フレームワークで使用されます。 |
| CMFCToolBarDateTimeCtrl::GetByCmd | 指定したコマンド ID を持つアプリケーション内の最初の CMFCToolBarDateTimeCtrl オブジェクトを取得します。 |
| CMFCToolBarDateTimeCtrl::GetDateTimeCtrl | 日付と時刻の選択コントロールへのポインターを返します。 |
| CMFCToolBarDateTimeCtrl::GetHwnd | ツール バー ボタンに関連付けられているウィンドウ ハンドルを取得します。 ( をオーバーライドしますCMFCToolBarButton::GetHwnd.) |
CMFCToolBarDateTimeCtrl::GetThisClass |
このクラス型に関連付けられている CRuntimeClass オブジェクトへのポインターを取得するためにフレームワークによって使用されます。 |
| CMFCToolBarDateTimeCtrl::GetTime | 日付と時刻の選択コントロールから選択した時刻を取得し、指定した SYSTEMTIME 構造体に配置します。 |
| CMFCToolBarDateTimeCtrl::GetTimeAll | 指定したコマンド ID を持つタイム ピッカー コントロール ボタンから選択した時刻を返します。 |
| CMFCToolBarDateTimeCtrl::HaveHotBorder | ユーザーがボタンを選択したときにボタンの境界線を表示するかどうかを指定します。 ( をオーバーライドしますCMFCToolBarButton::HaveHotBorder.) |
| CMFCToolBarDateTimeCtrl::NotifyCommand | ボタンが WM_COMMAND メッセージを処理するかどうかを指定します。 ( をオーバーライドしますCMFCToolBarButton::NotifyCommand.) |
| CMFCToolBarDateTimeCtrl::OnAddToCustomizePage | ボタンが Customize ダイアログ ボックスに追加されたときにフレームワークによって呼び出されます。 ( をオーバーライドしますCMFCToolBarButton::OnAddToCustomizePage.) |
CMFCToolBarDateTimeCtrl::OnCalculateSize |
指定したデバイス コンテキストとドッキング状態のボタンのサイズを計算するためにフレームワークによって呼び出されます。 ( をオーバーライドしますCMFCToolBarButton::OnCalculateSize.) |
| CMFCToolBarDateTimeCtrl::OnChangeParentWnd | ボタンが新しいツール バーに挿入されたときにフレームワークによって呼び出されます。 ( をオーバーライドしますCMFCToolBarButton::OnChangeParentWnd.) |
| CMFCToolBarDateTimeCtrl::OnClick | ユーザーがコントロールをクリックしたときにフレームワークによって呼び出されます。 ( をオーバーライドしますCMFCToolBarButton::OnClick.) |
| CMFCToolBarDateTimeCtrl::OnCtlColor | 親ツール バーがWM_CTLCOLOR メッセージを処理するときにフレームワークによって呼び出されます。 ( をオーバーライドしますCMFCToolBarButton::OnCtlColor.) |
CMFCToolBarDateTimeCtrl::OnDraw |
指定したスタイルとオプションを使用してボタンを描画するために、フレームワークによって呼び出されます。 ( をオーバーライドしますCMFCToolBarButton::OnDraw.) |
CMFCToolBarDateTimeCtrl::OnDrawOnCustomizeList |
Customize ダイアログ ボックスの Commands ペインにボタンを描画するためにフレームワークによって呼び出されます。 ( をオーバーライドしますCMFCToolBarButton::OnDrawOnCustomizeList.) |
| CMFCToolBarDateTimeCtrl::OnGlobalFontsChanged | グローバル フォントが変更されたときにフレームワークによって呼び出されます。 ( をオーバーライドしますCMFCToolBarButton::OnGlobalFontsChanged.) |
| CMFCToolBarDateTimeCtrl::OnMove | 親ツールバーが移動したときにフレームワークによって呼び出されます。 ( をオーバーライドしますCMFCToolBarButton::OnMove.) |
| CMFCToolBarDateTimeCtrl::OnShow | ボタンが表示または非表示になったときにフレームワークによって呼び出されます。 ( をオーバーライドしますCMFCToolBarButton::OnShow.) |
CMFCToolBarDateTimeCtrl::OnSize |
親ツール バーのサイズまたは位置が変更され、この変更によってボタンのサイズが変更されたときに、フレームワークによって呼び出されます。 ( をオーバーライドしますCMFCToolBarButton::OnSize.) |
| CMFCToolBarDateTimeCtrl::OnUpdateToolTip | 親ツール バーがツール ヒント テキストを更新するときに、フレームワークによって呼び出されます。 ( をオーバーライドしますCMFCToolBarButton::OnUpdateToolTip.) |
CMFCToolBarDateTimeCtrl::Serialize |
このオブジェクトをアーカイブから読み取るか、アーカイブに書き込みます ( CMFCToolBarButton::Serialize をオーバーライドします)。 |
CMFCToolBarDateTimeCtrl::SetStyle |
ツール バーのボタンのスタイルを設定します。 ( をオーバーライドしますCMFCToolBarButton::SetStyle.) |
| CMFCToolBarDateTimeCtrl::SetTime | 時刻選択コントロールの時刻と日付を設定します。 |
| CMFCToolBarDateTimeCtrl::SetTimeAll | 指定したコマンド ID を持つタイム ピッカー コントロールのすべてのインスタンスの時刻と日付を設定します。 |
解説
日付と時刻の選択コントロールを使用する方法の例については、ToolbarDateTimePicker サンプル プロジェクトを参照してください。 ツールバーにコントロール ボタンを追加する方法については、「 Walkthrough: Putting Controls on Toolbars」を参照してください。
継承階層
要件
Header: afxtoolbardatetimectrl.h
CMFCToolBarDateTimeCtrl::CanBeStretched
ユーザーがカスタマイズ中にボタンを拡大できるかどうかを指定します。
virtual BOOL CanBeStretched() const;
戻り値
このメソッドは TRUE を返します。
解説
既定では、フレームワークでは、ユーザーがカスタマイズ中にツール バー ボタンを拡大することはできません。 このメソッドは、ユーザーがカスタマイズ中に日付と時刻のツール バー ボタンを拡張できるようにすることで、基底クラスの実装 ( CMFCToolBarButton::CanBeStretched) を拡張します。
CMFCToolBarDateTimeCtrl::CMFCToolBarDateTimeCtrl
CMFCToolBarDateTimeCtrl オブジェクトを作成して初期化します。
CMFCToolBarDateTimeCtrl(
UINT uiID,
int iImage,
DWORD dwStyle=0,
int iWidth=0);
パラメーター
uiID
[入力] コントロール ID。
iImage
[in]ツール バーの CMFCToolBarImages オブジェクト内のイメージのインデックス。
dwStyle
[in]ユーザーがボタンをクリックしたときに作成される CMFCToolBarDateTimeCtrlImpl ウィンドウのスタイル。
iWidth
[in]コントロールの幅 (ピクセル単位)。
解説
このオブジェクトは、システムの日付と時刻に初期化されます。 内部 CMFCToolBarDateTimeCtrlImpl オブジェクトのウィンドウ スタイルには、 dwStyle パラメーターとWS_CHILDスタイルとWS_VISIBLEスタイルが含まれます。 CMFCToolBarDateTimeCtrl::SetStyleを使用してこれらのスタイルを変更することはできません。 SetStyleを使用して、CMFCToolBarDateTimeCtrl コントロールのスタイルを変更します。
例
次の例では、 CMFCToolBarDateTimeCtrl クラスのオブジェクトを構築する方法を示します。 このコード スニペットは、 Toolbar Date Time Picker サンプルの一部です。
CMFCToolBarDateTimeCtrl dateButton(ID_DATE,
GetCmdMgr()->GetCmdImage(ID_DATE, FALSE));
CMFCToolBarDateTimeCtrl::CopyFrom
別のツール バー ボタンのプロパティを現在のボタンにコピーします。
virtual void CopyFrom(const CMFCToolBarButton& src);
パラメーター
src
[in]コピー元のソース ボタンへの参照。
解説
このツール バー ボタンに別のツール バー ボタンをコピーするには、このメソッドを呼び出します。 src は CMFCToolBarDateTimeCtrl型である必要があります。
CMFCToolBarDateTimeCtrl::ExportToMenuButton
ツール バー ボタンからメニューにテキストをコピーします。
virtual BOOL ExportToMenuButton(CMFCToolBarMenuButton& menuButton) const;
パラメーター
menuButton
[in]ターゲット メニュー ボタンへの参照。
戻り値
このメソッドは TRUE を返します。
解説
このメソッドは、コントロールのコマンド ID に関連付けられている文字列リソースを読み込むことで、基底クラスの実装 ( CMFCToolBarButton::ExportToMenuButton) をオーバーライドします。 文字列リソースの詳細については、「 CStringT::LoadString」を参照してください。
CMFCToolBarDateTimeCtrl::GetByCmd
指定したコマンド ID を持つアプリケーション内の最初の CMFCToolBarDateTimeCtrl オブジェクトを取得します。
static CMFCToolBarDateTimeCtrl* __stdcall GetByCmd(UINT uiCmd);
パラメーター
uiCmd
[in]取得するボタンのコマンド ID。
戻り値
指定したコマンド ID を持つアプリケーション内の最初の CMFCToolBarDateTimeCtrl オブジェクト。指定したコマンド ID を持つ CMFCToolBarDateTimeCtrl オブジェクトがない場合は NULL。
解説
この共有ユーティリティ メソッドは、 CMFCToolBarDateTimeCtrl::SetTimeAll や CMFCToolBarDateTimeCtrl::GetTimeAll などのメソッドによって使用され、指定したコマンド ID を持つタイム ピッカー コントロールのすべてのインスタンスの時刻と日付を設定または取得します。
CMFCToolBarDateTimeCtrl::GetDateTimeCtrl
日付と時刻の選択コントロールへのポインターを返します。
CDateTimeCtrl* GetDateTimeCtrl() const;
戻り値
日付と時刻の選択コントロールへのポインター。コントロールが存在しない場合は NULL。
解説
CMFCToolBarDateTimeCtrl クラスは、ツール バーにCMFCToolBarDateTimeCtrl オブジェクトを挿入するときに、m_pWndDateTime データ メンバーを初期化します。
CMFCToolBarDateTimeCtrl::GetHwnd
ツール バー ボタンに関連付けられているウィンドウ ハンドルを取得します。
virtual HWND GetHwnd();
戻り値
日付と時刻のツール バー ボタンに関連付けられているウィンドウ ハンドル。
解説
このメソッドは、 CMFCToolBarButton::GetHwnd メソッドをオーバーライドします。
CMFCToolBarDateTimeCtrl::GetTime
関連付けられている日付と時刻の選択コントロールから選択した時刻を取得し、指定した SYSTEMTIME 構造体に配置します。
BOOL GetTime(COleDateTime& timeDest) const;
DWORD GetTime(CTime& timeDest) const;
DWORD GetTime(LPSYSTEMTIME pTimeDest) const;
パラメーター
timeDest
[out]最初のオーバーロードでは、システム時刻情報を受け取る COleDateTime Class オブジェクト。 2 番目のオーバーロードでは、システム時刻情報を受け取る CTime オブジェクト。
pTimeDest
[out]システム時刻情報を受信する SYSTEMTIME 構造体へのポインター。 NULL は指定できません。
戻り値
最初のオーバーロードでは、時刻が COleDateTime Class オブジェクトに正常に書き込まれた場合は 0 以外。それ以外の場合は 0。 2 番目と 3 番目のオーバーロードでは、戻り値は、 NMDATETIMECHANGE 構造体で設定された dwFlag メンバーと等しい DWORD です。
解説
このメソッドは、 NMDATETIMECHANGE 構造体メンバー dwFlags を設定して、日付と時刻の選択が日付と時刻に設定されているかどうかを示します。 値がGDT_NONEと等しい場合、コントロールは no date 状態に設定され、DTS_SHOWNONE スタイルが使用されます。 返される値が GDT_VALID と等しい場合、システム時刻は宛先の場所に正常に格納されます。
CMFCToolBarDateTimeCtrl::GetTimeAll
指定したコマンド ID を持つタイム ピッカー コントロール ボタンからユーザーが選択した時間を返します。
static BOOL GetTimeAll(
UINT uiCmd,
COleDateTime& timeDest);
static DWORD GetTimeAll(
UINT uiCmd,
CTime& timeDest);
static DWORD GetTimeAll(
UINT uiCmd,
LPSYSTEMTIME pTimeDest);
パラメーター
uiCmd
[in]ツール バー ボタンのコマンド ID を指定します。
timeDest
[out]最初のオーバーロードでは、システム時刻情報を受け取る COleDateTime Class オブジェクト。 2 番目のオーバーロードでは、システム時刻情報を受け取る CTime オブジェクト。
pTimeDest
[out]システム時刻情報を受信する SYSTEMTIME 構造体へのポインター。 NULL は指定できません。
戻り値
コマンド ID uiCmdに一致するツール バー ボタンがフレームワークで見つからない場合、戻り値は最初のオーバーロードでは 0 になり、他のオーバーロードではGDT_NONE。 ツール バー ボタンが見つかった場合、戻り値は、そのボタンの CMFCToolBarDateTimeCtrl::GetTime の呼び出しからの戻り値と同じです。 戻り値 0 またはGDT_NONEは、ボタンが見つかったときに発生する可能性があります。これは、 GetTime の呼び出しが何らかの理由で有効な日付を返さなかったことを示します。
解説
このメソッドは、指定したコマンド ID を持つツール バー ボタンを検索し、そのボタン CMFCToolBarDateTimeCtrl::GetTime メソッドを呼び出します。
CMFCToolBarDateTimeCtrl::HaveHotBorder
ユーザーがボタンを選択したときにボタンの境界線を表示するかどうかを指定します。
virtual BOOL HaveHotBorder() const;
戻り値
ボタンを選択すると境界線が表示される場合は 0 以外。それ以外の場合は 0。
解説
コントロールが表示されている場合、このメソッドは 0 以外の値を返します。
CMFCToolBarDateTimeCtrl::NotifyCommand
ボタンが WM_COMMAND メッセージを処理するかどうかを指定します。
virtual BOOL NotifyCommand(int iNotifyCode);
パラメーター
iNotifyCode
[in]コマンドに関連付けられている通知メッセージ。
戻り値
ボタンがWM_COMMAND メッセージを処理する場合は TRUE、親ツール バーがメッセージを処理する必要があることを示す FALSE。
解説
フレームワークは、親ウィンドウに WM_COMMAND メッセージを送信しようとしているときに、このメソッドを呼び出します。
このメソッドは、DTN_DATETIMECHANGE通知を処理することによって基底クラスの実装 (CMFCToolBarButton::NotifyCommand) を拡張します。 内部時刻の状態を更新し、すべての CMFCToolBarDateTimeCtrl オブジェクトの time プロパティを同じコマンド ID で更新します。
CMFCToolBarDateTimeCtrl::OnAddToCustomizePage
ボタンが Customize ダイアログ ボックスに追加されたときにフレームワークによって呼び出されます。
virtual void OnAddToCustomizePage();
解説
このメソッドは、基本クラスの実装である CMFCToolBarButton::OnAddToCustomizePage を拡張します。このオブジェクトと同じコマンド ID を持つツール バーの最初の日付と時刻コントロールからプロパティをコピーします。 このメソッドは、ツール バーに、このオブジェクトと同じコマンド ID を持つ日付と時刻のコントロールがない場合は何も行いません。
Customize ダイアログ ボックスの詳細については、「CMFCToolBarsCustomizeDialog クラスを参照してください。
CMFCToolBarDateTimeCtrl::OnChangeParentWnd
ボタンが新しいツール バーに挿入されたときにフレームワークによって呼び出されます。
virtual void OnChangeParentWnd(CWnd* pWndParent);
パラメーター
pWndParent
[in]新しい親ウィンドウ。
解説
このメソッドは、内部CMFCToolBarDateTimeCtrlImpl オブジェクトを再作成することによって、基底クラスの実装 (CMFCToolBarButton::OnChangeParentWnd) をオーバーライドします。
CMFCToolBarDateTimeCtrl::OnClick
ユーザーがコントロールをクリックしたときにフレームワークによって呼び出されます。
virtual BOOL OnClick(
CWnd* pWnd,
BOOL bDelay = TRUE);
パラメーター
pWnd
[in] 使用されていません。
bDelay
[入力] 使用されていません。
戻り値
ボタンがクリック メッセージを処理する場合は 0 以外。それ以外の場合は 0。
解説
このメソッドは、内部CMFCToolBarDateTimeCtrlImpl オブジェクトが表示されている場合に 0 以外の値を返すことによって、基底クラスの実装である CMFCToolBarButton::OnClick をオーバーライドします。
CMFCToolBarDateTimeCtrl::OnCtlColor
親ツール バーがWM_CTLCOLOR メッセージを処理するときにフレームワークによって呼び出されます。
virtual HBRUSH OnCtlColor(
CDC* pDC,
UINT nCtlColor);
パラメーター
pDC
[in]ボタンを表示するデバイス コンテキスト。
nCtlColor
[入力] 使用されていません。
戻り値
フレームワークがボタンの背景を描画するために使用するグローバル ブラシのハンドル。
解説
このメソッドは、指定されたデバイス コンテキストのテキストと背景色をそれぞれグローバル テキストと背景色に設定することで、基底クラスの実装である CMFCToolBarButton::OnCtlColor をオーバーライドします。
アプリケーションで使用できるグローバル オプションの詳細については、「 AFX_GLOBAL_DATA構造体」を参照してください。
CMFCToolBarDateTimeCtrl::OnGlobalFontsChanged
グローバル フォントが変更されたときにフレームワークによって呼び出されます。
virtual void OnGlobalFontsChanged();
解説
このメソッドは、コントロールのフォントをグローバル フォントのフォントに変更することで、基底クラスの実装 ( CMFCToolBarButton::OnGlobalFontsChanged) を拡張します。
アプリケーションで使用できるグローバル オプションの詳細については、「 AFX_GLOBAL_DATA構造体」を参照してください。
CMFCToolBarDateTimeCtrl::OnMove
親ツールバーが移動したときにフレームワークによって呼び出されます。
virtual void OnMove();
解説
このメソッドは、内部CMFCToolBarDateTimeCtrlImpl オブジェクトの位置を更新することによって、既定のクラス実装 (CMFCToolBarButton::OnMove) をオーバーライドします。
CMFCToolBarDateTimeCtrl::OnShow
ボタンが表示または非表示になったときにフレームワークによって呼び出されます。
virtual void OnShow(BOOL bShow);
パラメーター
bShow
[in]ボタンを表示するかどうかを指定します。 このパラメーターが TRUE の場合、ボタンが表示されます。 それ以外の場合、ボタンは表示されません。
解説
このメソッドは、bShow が TRUE の場合にボタンを表示することで、基本クラスの実装 (CMFCToolBarButton::OnShow) を拡張します。 それ以外の場合、このメソッドはボタンを非表示にします。
CMFCToolBarDateTimeCtrl::OnSize
親ツール バーのサイズまたは位置が変更され、この変更によってボタンのサイズが変更されたときに、フレームワークによって呼び出されます。
virtual void OnSize(int iSize);
パラメーター
iSize
[in]ボタンの新しい幅 (ピクセル単位)。
解説
このメソッドは、内部CMFCToolBarDateTimeCtrlImpl オブジェクトのサイズと位置を更新することによって、既定のクラス実装 (CMFCToolBarButton::OnSize) をオーバーライドします。
CMFCToolBarDateTimeCtrl::OnUpdateToolTip
親ツール バーがツール ヒント テキストを更新するときに、フレームワークによって呼び出されます。
virtual BOOL OnUpdateToolTip(
CWnd* pWndParent,
int iButtonIndex,
CToolTipCtrl& wndToolTip,
CString& str);
パラメーター
pWndParent
[in]親ウィンドウ。
iButtonIndex
[in]親ボタン コレクション内のボタンの 0 から始まるインデックス。
wndToolTip
[in]ヒント テキストを表示するコントロール。
str
[out]更新されたツールヒント テキストを受け取る CString オブジェクト。
戻り値
メソッドがツールヒントテキストを更新する場合は 0 以外。それ以外の場合は 0。
解説
このメソッドは、ボタンに関連付けられているツールヒント テキストを表示することで、基底クラスの実装 ( CMFCToolBarButton::OnUpdateToolTip) を拡張します。 ボタンが水平方向にドッキングされていない場合、このメソッドは何も実行せず、FALSE を返します。
CMFCToolBarDateTimeCtrl::SetTime
時刻選択コントロールの時刻と日付を設定します。
BOOL SetTime(const COleDateTime& timeNew);
BOOL SetTime(const CTime* timeNew);
BOOL SetTime(LPSYSTEMTIME pTimeNew=NULL);
パラメーター
timeNew
[in]最初のバージョンでは、コントロールが設定される時刻を含む COleDateTime クラス オブジェクトへの参照。 2 番目のバージョンでは、コントロールが設定される時刻を含む CTime オブジェクトへのポインター。
pTimeNew
[in] SYSTEMTIME コントロールの設定時刻を格納する構造体へのポインター。
戻り値
正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。
解説
CDateTimeCtrl::SetTime を呼び出して、日付と時刻の選択コントロールの時刻を設定します。
CMFCToolBarDateTimeCtrl::SetTimeAll
指定したコマンド ID を持つタイム ピッカー コントロールのすべてのインスタンスの時刻と日付を設定します。
static BOOL SetTimeAll(
UINT uiCmd,
const COleDateTime& timeNew);
static BOOL SetTimeAll(
UINT uiCmd,
const CTime* pTimeNew);
static BOOL SetTimeAll(
UINT uiCmd,
LPSYSTEMTIME pTimeNew=NULL);
パラメーター
uiCmd
[in]ツール バー ボタンのコマンド ID を指定します。
timeNew
[in]最初のバージョンでは、 COleDateTime クラス コントロールが設定される時刻を含むオブジェクト。 2 番目のバージョンでは、コントロールが設定される時刻を含む CTime オブジェクトへのポインター。
pTimeNew
[in] SYSTEMTIME コントロールの設定時刻を格納する構造体へのポインター。
戻り値
正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。
解説
指定したコマンド ID を持つツール バー ボタンを探し、 CMFCToolBarDateTimeCtrl::SetTime を呼び出して、日付と時刻の選択コントロールに時刻を設定します。