CMFCToolBarDateTimeCtrl クラス

  • [アーティクル]

日付と時刻の選択コントロールを含むツールバーボタン。

構文

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:: ホットボーダーを持つ ユーザーがボタンを選択したときに、ボタンの境界線を表示するかどうかを決定します。 ( CMFCToolBarButton:: は、ホットボーダーをオーバーライドします)。
CMFCToolBarDateTimeCtrl:: NotifyCommand ボタンが WM_COMMAND メッセージを処理するかどうかを指定します。 ( CMFCToolBarButton:: NotifyCommandをオーバーライドします)。
CMFCToolBarDateTimeCtrl:: OnAddToCustomizePage ボタンが [ カスタマイズ ] ダイアログボックスに追加されたときにフレームワークによって呼び出されます。 ( CMFCToolBarButton:: OnAddToCustomizePageをオーバーライドします)。
CMFCToolBarDateTimeCtrl::OnCalculateSize 指定されたデバイスコンテキストとドッキング状態のボタンのサイズを計算するために、フレームワークによって呼び出されます。 ( CMFCToolBarButton:: On電卓 Atesizeをオーバーライドします)。
CMFCToolBarDateTimeCtrl::OnChangeParentWnd 新しいツールバーにボタンが挿入されたときにフレームワークによって呼び出されます。 ( CMFCToolBarButton:: OnChangeParentWndをオーバーライドします。)
CMFCToolBarDateTimeCtrl:: OnClick ユーザーがコントロールをクリックすると、フレームワークによって呼び出されます。 ( CMFCToolBarButton:: OnClickをオーバーライドします)。
CMFCToolBarDateTimeCtrl::OnCtlColor 親ツールバーが WM_CTLCOLOR メッセージを処理するときに、フレームワークによって呼び出されます。 ( CMFCToolBarButton:: OnCtlColorをオーバーライドします。)
CMFCToolBarDateTimeCtrl::OnDraw 指定されたスタイルとオプションを使用してボタンを描画するために、フレームワークによって呼び出されます。 ( CMFCToolBarButton:: OnDrawをオーバーライドします)。
CMFCToolBarDateTimeCtrl::OnDrawOnCustomizeList [カスタマイズ] ダイアログボックスの [コマンド] ウィンドウにボタンを描画するために、フレームワークによって呼び出されます。 ( CMFCToolBarButton:: OnDrawOnCustomizeListをオーバーライドします。)
CMFCToolBarDateTimeCtrl:: Onglobalフォントの変更 グローバルフォントが変更されたときにフレームワークによって呼び出されます。 ( CMFCToolBarButton:: Onglobalフォントの変更をオーバーライドします)。
CMFCToolBarDateTimeCtrl::OnMove 親ツールバーが移動したときにフレームワークによって呼び出されます。 ( CMFCToolBarButton:: OnMoveをオーバーライドします。)
CMFCToolBarDateTimeCtrl:: OnShow ボタンが表示または非表示になったときにフレームワークによって呼び出されます。 ( CMFCToolBarButton:: OnShow をオーバーライドします)。
CMFCToolBarDateTimeCtrl::OnSize 親ツールバーがサイズまたは位置を変更し、この変更によってボタンのサイズが変更されるときに、フレームワークによって呼び出されます。 ( CMFCToolBarButton:: OnSizeをオーバーライドします。)
CMFCToolBarDateTimeCtrl:: OnUpdateToolTip 親ツールバーがツールヒントテキストを更新するときに、フレームワークによって呼び出されます。 ( CMFCToolBarButton:: OnUpdateToolTipをオーバーライドします)。
CMFCToolBarDateTimeCtrl::Serialize このオブジェクトをアーカイブから読み取るか、アーカイブに書き込みます ( CMFCToolBarButton:: Serializeをオーバーライドします)。
CMFCToolBarDateTimeCtrl::SetStyle ツール バーのボタンのスタイルを設定します。 ( CMFCToolBarButton:: system.windows.forms.control.setstyleをオーバーライドします。)
CMFCToolBarDateTimeCtrl:: SetTime タイムピッカーコントロールの日時を設定します。
CMFCToolBarDateTimeCtrl:: SetTimeAll 指定されたコマンド ID を持つ、時間選択コントロールのすべてのインスタンスの時刻と日付を設定します。

注釈

日付と時刻の選択コントロールを使用する方法の例については、ToolbarDateTimePicker サンプルプロジェクトを参照してください。 コントロールボタンをツールバーに追加する方法の詳細については、「 チュートリアル: ツールバーへのコントロールの配置」を参照してください。

継承階層

CObject

CMFCToolBarButton

CMFCToolBarDateTimeCtrl

要件

ヘッダー: afxtoolbardatetimectrl

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]コントロールの幅 (ピクセル単位)。

注釈

このオブジェクトは、システムの日付と時刻に初期化されます。 内部オブジェクトのウィンドウ スタイルには、CMFCToolBarDateTimeCtrlImpldwStyle パラメーターと、WS_CHILDスタイルWS_VISIBLEがあります。 を使用してこれらのスタイルを変更することはできません CMFCToolBarDateTimeCtrl::SetStyle。 コントロール SetStyle のスタイルを変更するには、 を使用 CMFCToolBarDateTimeCtrl します。

例

次の例は、 クラスの オブジェクトを構築する方法を示 CMFCToolBarDateTimeCtrl しています。 このコード スニペットは、ツール バーの 日付と時刻の選択のサンプルの一部です。

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。

戻り値

指定したコマンド CMFCToolBarDateTimeCtrl ID を持つアプリケーション内の最初のオブジェクト。指定したコマンド ID CMFCToolBarDateTimeCtrl を持つオブジェクトがない場合は NULL。

注釈

この共有ユーティリティ メソッドは、指定されたコマンド ID を持つタイム ピッカー コントロールのすべてのインスタンスの時刻と日付を設定または取得するために 、CMFCToolBarDateTimeCtrl::SetTimeAll や CMFCToolBarDateTimeCtrl::GetTimeAll などのメソッドによって使用されます。

CMFCToolBarDateTimeCtrl::GetDateTimeCtrl

日付と時刻のピッカー コントロールへのポインターを返します。

CDateTimeCtrl* GetDateTimeCtrl() const;

戻り値

日付と時刻の選択コントロールへのポインター。コントロールが存在しない場合は NULL。

注釈

クラス CMFCToolBarDateTimeCtrl は、 オブジェクトを m_pWndDateTime ツール バーに挿入するときに CMFCToolBarDateTimeCtrl データ メンバーを初期化します。

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 クラス オブジェクト。 2 番目のオーバーロードでは、 システム時刻 情報を受け取る CTime オブジェクト。

pTimeDest
[out]システム時刻情報を 受け取る SYSTEMTIME 構造体へのポインター。 NULL は指定できません。

戻り値

最初のオーバーロードでは、時刻が COleDateTime クラス オブジェクトに正常に書き込まれた場合は 0 以外です。それ以外の場合は 0。 2 番目と 3 番目のオーバーロードでは、戻り値は 、NMDATETIMECHANGE 構造体で設定された dwFlag メンバーと等しい DWORD です。

注釈

メソッドは、 NMDATETIMECHANGE 構造体メンバー dwFlags を設定して、日付と時刻の選択コントロールが日時に設定されているかどうかを示します。 値がと等しい場合GDT_NONEコントロールは no date status に設定され、新しいスタイル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 クラス オブジェクト。 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) を拡張します。 内部時間の状態を更新し、同じコマンド ID を持つすべて CMFCToolBarDateTimeCtrl のオブジェクトの time プロパティを更新します。

CMFCToolBarDateTimeCtrl:: OnAddToCustomizePage

ボタンが [ カスタマイズ ] ダイアログボックスに追加されたときにフレームワークによって呼び出されます。

virtual void OnAddToCustomizePage();

注釈

このメソッドは、このオブジェクトと同じコマンド ID を持つ任意のツールバーの最初の日付と時刻のコントロールからプロパティをコピーすることによって、基本クラスの実装である CMFCToolBarButton:: OnAddToCustomizePageを拡張します。 このオブジェクトと同じコマンド ID を持つ日付と時刻のコントロールを持つツールバーがない場合、このメソッドは何も実行しません。

[ ユーザー設定 ] ダイアログボックスの詳細については、「 Cmfctoolbarscustomizedialog クラス」を参照してください。

CMFCToolBarDateTimeCtrl::OnChangeParentWnd

新しいツールバーにボタンが挿入されたときにフレームワークによって呼び出されます。

virtual void OnChangeParentWnd(CWnd* pWndParent);

パラメーター

pWndParent
から新しい親ウィンドウ。

注釈

このメソッドは、内部 CMFCToolBarDateTimeCtrlImpl オブジェクトを再作成することによって、基底クラスの実装 ( CMFCToolBarButton:: OnChangeParentWnd) をオーバーライドします。

CMFCToolBarDateTimeCtrl:: OnClick

ユーザーがコントロールをクリックすると、フレームワークによって呼び出されます。

virtual BOOL OnClick(
    CWnd* pWnd,
    BOOL bDelay = TRUE);

パラメーター

pWnd
[入力] 使用されていません。

bDelay
[入力] 使用されていません。

戻り値

ボタンがクリックメッセージを処理する場合は0以外。それ以外の場合は0です。

注釈

このメソッドは、内部 CMFCToolBarDateTimeCtrlImpl オブジェクトが表示されている場合に0以外の値を返すことによって、基底クラスの実装であるCMFCToolBarButton:: OnClickをオーバーライドします。

CMFCToolBarDateTimeCtrl::OnCtlColor

親ツールバーが WM_CTLCOLOR メッセージを処理するときに、フレームワークによって呼び出されます。

virtual HBRUSH OnCtlColor(
    CDC* pDC,
    UINT nCtlColor);

パラメーター

pDC
からボタンを表示するデバイスコンテキスト。

nCtlColor
[入力] 使用されていません。

戻り値

フレームワークがボタンの背景を描画するために使用するグローバルブラシへのハンドル。

注釈

このメソッドは、指定されたデバイスコンテキストのテキストと背景色をそれぞれグローバルテキストと背景色に設定することによって、基本クラスの実装である CMFCToolBarButton:: OnCtlColorをオーバーライドします。

アプリケーションで使用できるグローバルオプションの詳細については、「 AFX_GLOBAL_DATA 構造」を参照してください。

CMFCToolBarDateTimeCtrl:: Onglobalフォントの変更

グローバルフォントが変更されたときにフレームワークによって呼び出されます。

virtual void OnGlobalFontsChanged();

注釈

このメソッドは、コントロールのフォントをグローバルフォントのフォントに変更することによって、基本クラスの実装 ( CMFCToolBarButton:: Onglobalfont-size changed) を拡張します。

アプリケーションで使用できるグローバルオプションの詳細については、「 AFX_GLOBAL_DATA 構造」を参照してください。

CMFCToolBarDateTimeCtrl::OnMove

親ツールバーが移動したときにフレームワークによって呼び出されます。

virtual void OnMove();

注釈

このメソッドは、内部 CMFCToolBarDateTimeCtrlImpl オブジェクトの位置を更新することによって、既定のクラス実装 ( CMFCToolBarButton:: OnMove) をオーバーライドします。

CMFCToolBarDateTimeCtrl:: OnShow

ボタンが表示または非表示になったときにフレームワークによって呼び出されます。

virtual void OnShow(BOOL bShow);

パラメーター

bShow
からボタンを表示するかどうかを指定します。 このパラメーターが TRUE の場合は、ボタンが表示されます。 それ以外の場合、ボタンは表示されません。

注釈

このメソッドは、 bShowが TRUE の場合にボタンを表示することによって、基底クラスの実装 ( CMFCToolBarButton:: onshow) を拡張します。 それ以外の場合、このメソッドはボタンを非表示にします。

CMFCToolBarDateTimeCtrl:: OnSize

親ツールバーがサイズまたは位置を変更し、この変更によってボタンのサイズが変更されるときに、フレームワークによって呼び出されます。

virtual void OnSize(int iSize);

パラメーター

iSize
からボタンの新しい幅 (ピクセル単位)。

注釈

このメソッドは、内部 CMFCToolBarDateTimeCtrlImpl オブジェクトのサイズと位置を更新することによって、既定のクラス実装 ( CMFCToolBarButton:: OnSize) をオーバーライドします。

CMFCToolBarDateTimeCtrl:: OnUpdateToolTip

親ツールバーがツールヒントテキストを更新するときに、フレームワークによって呼び出されます。

virtual BOOL OnUpdateToolTip(
    CWnd* pWndParent,
    int iButtonIndex,
    CToolTipCtrl& wndToolTip,
    CString& str);

パラメーター

pWndParent
から親ウィンドウ。

iButtonIndex
から親ボタンコレクション内のボタンの0から始まるインデックス。

wndToolTip
からツールヒントのテキストを表示するコントロール。

str
入出力 CString 更新されたツールヒントテキストを受け取るオブジェクト。

戻り値

メソッドがツールヒントテキストを更新する場合は0以外の。それ以外の場合は0です。

注釈

このメソッドは、ボタンに関連付けられているツールヒントテキストを表示することによって、基本クラスの実装 ( CMFCToolBarButton:: OnUpdateToolTip) を拡張します。 ボタンが水平方向にドッキングされていない場合、このメソッドは何も実行せず、FALSE を返します。

CMFCToolBarDateTimeCtrl:: SetTime

タイムピッカーコントロールの日時を設定します。

BOOL SetTime(const COleDateTime& timeNew);
BOOL SetTime(const CTime* timeNew);
BOOL SetTime(LPSYSTEMTIME pTimeNew=NULL);

パラメーター

timeNew
から最初のバージョンでは、コントロールが設定される時刻を含む COleDateTime クラス オブジェクトへの参照。 2番目のバージョンでは、コントロールが設定される時間を格納する CTime オブジェクトへのポインター。

pTimeNew
からコントロールが設定される時刻を格納している 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
からツールバーボタンのコマンド ID を指定します。

timeNew
から最初のバージョンでは、コントロールが設定される時刻を含む COleDateTime クラス オブジェクト。 2番目のバージョンでは、コントロールが設定される時間を格納する CTime オブジェクトへのポインター。

pTimeNew
からコントロールが設定される時刻を格納している SYSTEMTIME 構造体へのポインター。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

指定したコマンド ID のツールバーボタンを検索し、 CMFCToolBarDateTimeCtrl:: SetTimeを呼び出すことにより、日付と時刻の選択コントロールに時刻を設定します。

関連項目

階層図
クラス
CMFCToolBarButton クラス
チュートリアル: ツール バーへのコントロールの追加