Freigeben über

CMFCToolBarDateTimeCtrl-Klasse

Hinweis

Die Microsoft Foundation Classes (MFC)-Bibliothek wird weiterhin unterstützt. Wir fügen jedoch keine Features mehr hinzu oder aktualisieren die Dokumentation.

Eine Symbolleistenschaltfläche, die ein Datums- und Uhrzeitauswahl-Steuerelement enthält.

Syntax

class CMFCToolBarDateTimeCtrl : public CMFCToolBarButton

Member

Öffentliche Konstruktoren

Name Beschreibung
CMFCToolBarDateTimeCtrl::CMFCToolBarDateTimeCtrl Erstellt ein CMFCToolBarDateTimeCtrl-Objekt.
CMFCToolBarDateTimeCtrl::~CMFCToolBarDateTimeCtrl Destruktor.

Öffentliche Methoden

Name Beschreibung
CMFCToolBarDateTimeCtrl::CanBeStretched Gibt an, ob ein Benutzer die Schaltfläche während der Anpassung strecken kann. (Außerkraftsetzungen CMFCToolBarButton::CanBeStretched.)
CMFCToolBarDateTimeCtrl::CopyFrom Kopiert die Eigenschaften einer anderen Symbolleistenschaltfläche auf die aktuelle Schaltfläche. (Außerkraftsetzungen CMFCToolBarButton::CopyFrom.)
CMFCToolBarDateTimeCtrl::DuplicateData Für die zukünftige Verwendung reserviert.
CMFCToolBarButton::ExportToMenuButton Kopiert Text von der Symbolleistenschaltfläche in ein Menü.
CMFCToolBarDateTimeCtrl::CreateObject Wird vom Framework verwendet, um eine dynamische Instanz dieses Klassentyps zu erstellen.
CMFCToolBarDateTimeCtrl::GetByCmd Ruft das erste CMFCToolBarDateTimeCtrl Objekt in der Anwendung ab, das die angegebene Befehls-ID aufweist.
CMFCToolBarDateTimeCtrl::GetDateTimeCtrl Gibt einen Zeiger auf das Datums- und Uhrzeitauswahl-Steuerelement zurück.
CMFCToolBarDateTimeCtrl::GetHwnd Ruft das Fensterhandle ab, das der Symbolleistenschaltfläche zugeordnet ist. (Außerkraftsetzungen CMFCToolBarButton::GetHwnd.)
CMFCToolBarDateTimeCtrl::GetThisClass Wird vom Framework verwendet, um einen Zeiger auf das CRuntimeClass -Objekt abzurufen, das diesem Klassentyp zugeordnet ist.
CMFCToolBarDateTimeCtrl::GetTime Ruft die ausgewählte Uhrzeit aus einem Datums- und Uhrzeitauswahl-Steuerelement ab und fügt sie in eine angegebene SYSTEMTIME-Struktur ein.
CMFCToolBarDateTimeCtrl::GetTimeAll Gibt die ausgewählte Uhrzeit aus der Zeitauswahl-Steuerelementschaltfläche zurück, die über eine angegebene Befehls-ID verfügt.
CMFCToolBarDateTimeCtrl::HaveHotBorder Bestimmt, ob ein Rahmen der Schaltfläche angezeigt wird, wenn ein Benutzer die Schaltfläche auswählt. (Außerkraftsetzungen CMFCToolBarButton::HaveHotBorder.)
CMFCToolBarDateTimeCtrl::NotifyCommand Gibt an, ob die Schaltfläche die WM_COMMAND Nachricht verarbeitet. (Außerkraftsetzungen CMFCToolBarButton::NotifyCommand.)
CMFCToolBarDateTimeCtrl::OnAddToCustomizePage Wird vom Framework aufgerufen, wenn die Schaltfläche einem Dialogfeld "Anpassen " hinzugefügt wird. (Außerkraftsetzungen CMFCToolBarButton::OnAddToCustomizePage.)
CMFCToolBarDateTimeCtrl::OnCalculateSize Wird vom Framework aufgerufen, um die Größe der Schaltfläche für den angegebenen Gerätekontext und Andockzustand zu berechnen. (Außerkraftsetzungen CMFCToolBarButton::OnCalculateSize.)
CMFCToolBarDateTimeCtrl::OnChangeParentWnd Wird vom Framework aufgerufen, wenn die Schaltfläche in eine neue Symbolleiste eingefügt wird. (Außerkraftsetzungen CMFCToolBarButton::OnChangeParentWnd.)
CMFCToolBarDateTimeCtrl::OnClick Wird vom Framework aufgerufen, wenn der Benutzer auf das Steuerelement klickt. (Außerkraftsetzungen CMFCToolBarButton::OnClick.)
CMFCToolBarDateTimeCtrl::OnCtlColor Wird vom Framework aufgerufen, wenn die übergeordnete Symbolleiste eine WM_CTLCOLOR Nachricht behandelt. (Außerkraftsetzungen CMFCToolBarButton::OnCtlColor.)
CMFCToolBarDateTimeCtrl::OnDraw Wird vom Framework aufgerufen, um die Schaltfläche mithilfe der angegebenen Stile und Optionen zu zeichnen. (Außerkraftsetzungen CMFCToolBarButton::OnDraw.)
CMFCToolBarDateTimeCtrl::OnDrawOnCustomizeList Wird vom Framework aufgerufen, um die Schaltfläche im Befehlsbereich des Dialogfelds Anpassen zu zeichnen. (Außerkraftsetzungen CMFCToolBarButton::OnDrawOnCustomizeList.)
CMFCToolBarDateTimeCtrl::OnGlobalFontsChanged Wird vom Framework aufgerufen, wenn sich die globale Schriftart geändert hat. (Außerkraftsetzungen CMFCToolBarButton::OnGlobalFontsChanged.)
CMFCToolBarDateTimeCtrl::OnMove Wird vom Framework aufgerufen, wenn die übergeordnete Symbolleiste verschoben wird. (Außerkraftsetzungen CMFCToolBarButton::OnMove.)
CMFCToolBarDateTimeCtrl::OnShow Wird vom Framework aufgerufen, wenn die Schaltfläche sichtbar oder unsichtbar wird. (Außerkraftsetzungen CMFCToolBarButton::OnShow.)
CMFCToolBarDateTimeCtrl::OnSize Wird vom Framework aufgerufen, wenn die übergeordnete Symbolleiste seine Größe oder Position ändert und diese Änderung bewirkt, dass die Schaltfläche die Größe ändert. (Außerkraftsetzungen CMFCToolBarButton::OnSize.)
CMFCToolBarDateTimeCtrl::OnUpdateToolTip Wird vom Framework aufgerufen, wenn die übergeordnete Symbolleiste den QuickInfo-Text aktualisiert. (Außerkraftsetzungen CMFCToolBarButton::OnUpdateToolTip.)
CMFCToolBarDateTimeCtrl::Serialize Liest dieses Objekt aus einem Archiv oder schreibt es in ein Archiv(Overrides CMFCToolBarButton::Serialize.)
CMFCToolBarDateTimeCtrl::SetStyle Legt den Stil der Symbolleistenschaltfläche fest. (Außerkraftsetzungen CMFCToolBarButton::SetStyle.)
CMFCToolBarDateTimeCtrl::SetTime Legt die Uhrzeit und das Datum im Zeitauswahl-Steuerelement fest.
CMFCToolBarDateTimeCtrl::SetTimeAll Legt die Uhrzeit und das Datum in allen Instanzen des Zeitauswahl-Steuerelements fest, die über eine angegebene Befehls-ID verfügen.

Hinweise

Ein Beispiel für die Verwendung eines Datums- und Uhrzeitauswahl-Steuerelements finden Sie im ToolbarDateTimePicker-Beispielprojekt. Informationen zum Hinzufügen von Steuerelementschaltflächen zu Symbolleisten finden Sie unter Walkthrough: Putting Controls On Toolbars.

Vererbungshierarchie

CObject

CMFCToolBarButton

CMFCToolBarDateTimeCtrl

Anforderungen

Header: afxtoolbardatetimectrl.h

CMFCToolBarDateTimeCtrl::CanBeStretched

Gibt an, ob ein Benutzer die Schaltfläche während der Anpassung strecken kann.

virtual BOOL CanBeStretched() const;

Rückgabewert

Diese Methode gibt TRUE zurück.

Hinweise

Standardmäßig lässt das Framework dem Benutzer nicht zu, eine Symbolleistenschaltfläche während der Anpassung zu strecken. Diese Methode erweitert die Basisklassenimplementierung ( CMFCToolBarButton::CanBeStretched), indem der Benutzer während der Anpassung eine Schaltfläche der Datums- und Uhrzeitsymbolleiste dehnen kann.

CMFCToolBarDateTimeCtrl::CMFCToolBarDateTimeCtrl

Erstellt und initialisiert ein CMFCToolBarDateTimeCtrl -Objekt.

CMFCToolBarDateTimeCtrl(
    UINT uiID,
    int iImage,
    DWORD dwStyle=0,
    int iWidth=0);

Parameter

uiID
[in] Die Steuerelement-ID.

iImage
[in] Der Index des Bilds CMFCToolBarImages im Objekt der Symbolleiste.

dwStyle
[in] Die Formatvorlage des CMFCToolBarDateTimeCtrlImpl Fensters, das erstellt wird, wenn ein Benutzer auf die Schaltfläche klickt.

iWidth
[in] Die Breite des Steuerelements in Pixel.

Hinweise

Dieses Objekt wird an das Systemdatum und die Systemzeit initialisiert. Das Fensterformat des internen CMFCToolBarDateTimeCtrlImpl Objekts enthält den dwStyle-Parameter und die formatvorlagen WS_CHILD und WS_VISIBLE. Sie können diese Formatvorlagen nicht mithilfe von CMFCToolBarDateTimeCtrl::SetStyle. Wird verwendet SetStyle , um die Formatvorlage des CMFCToolBarDateTimeCtrl Steuerelements zu ändern.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie ein Objekt der CMFCToolBarDateTimeCtrl Klasse erstellt wird. Dieser Codeausschnitt ist Teil des Beispiels für die Symbolleiste für die Datums-/Uhrzeitauswahl.

CMFCToolBarDateTimeCtrl dateButton(ID_DATE,
                                   GetCmdMgr()->GetCmdImage(ID_DATE, FALSE));

CMFCToolBarDateTimeCtrl::CopyFrom

Kopiert die Eigenschaften einer anderen Symbolleistenschaltfläche auf die aktuelle Schaltfläche.

virtual void CopyFrom(const CMFCToolBarButton& src);

Parameter

src
[in] Ein Verweis auf die Quellschaltfläche, aus der kopiert werden soll.

Hinweise

Rufen Sie diese Methode auf, um eine weitere Symbolleistenschaltfläche auf diese Symbolleistenschaltfläche zu kopieren. src muss vom Typ CMFCToolBarDateTimeCtrlsein.

CMFCToolBarDateTimeCtrl::ExportToMenuButton

Kopiert Text von der Symbolleistenschaltfläche in ein Menü.

virtual BOOL ExportToMenuButton(CMFCToolBarMenuButton& menuButton) const;

Parameter

menuButton
[in] Ein Verweis auf die Zielmenüschaltfläche.

Rückgabewert

Diese Methode gibt TRUE zurück.

Hinweise

Diese Methode setzt die Implementierung der Basisklasse ( CMFCToolBarButton::ExportToMenuButton) außer Kraft, indem die Zeichenfolgenressource geladen wird, die der Befehls-ID des Steuerelements zugeordnet ist. Weitere Informationen zu Zeichenfolgenressourcen finden Sie unter "CStringT::LoadString".

CMFCToolBarDateTimeCtrl::GetByCmd

Ruft das erste CMFCToolBarDateTimeCtrl Objekt in der Anwendung ab, das die angegebene Befehls-ID aufweist.

static CMFCToolBarDateTimeCtrl* __stdcall GetByCmd(UINT uiCmd);

Parameter

uiCmd
[in] Die Befehls-ID der abzurufenden Schaltfläche.

Rückgabewert

Das erste CMFCToolBarDateTimeCtrl Objekt in der Anwendung mit der angegebenen Befehls-ID oder NULL, wenn keine CMFCToolBarDateTimeCtrl Objekte die angegebene Befehls-ID aufweisen.

Hinweise

Diese freigegebene Hilfsprogrammmethode wird von Methoden wie CMFCToolBarDateTimeCtrl::SetTimeAll und CMFCToolBarDateTimeCtrl::GetTimeAll verwendet, um die Uhrzeit und das Datum aller Instanzen des Zeitauswahl-Steuerelements festzulegen oder abzurufen, die über eine angegebene Befehls-ID verfügen.

CMFCToolBarDateTimeCtrl::GetDateTimeCtrl

Gibt einen Zeiger auf das Datums- und Uhrzeitauswahl-Steuerelement zurück.

CDateTimeCtrl* GetDateTimeCtrl() const;

Rückgabewert

Zeiger auf Datums- und Uhrzeitauswahl-Steuerelement; oder NULL, wenn das Steuerelement nicht vorhanden ist.

Hinweise

Die CMFCToolBarDateTimeCtrl Klasse initialisiert das m_pWndDateTime Datenelement, wenn Sie ein CMFCToolBarDateTimeCtrl Objekt in eine Symbolleiste einfügen.

CMFCToolBarDateTimeCtrl::GetHwnd

Ruft das Fensterhandle ab, das der Symbolleistenschaltfläche zugeordnet ist.

virtual HWND GetHwnd();

Rückgabewert

Das Fensterhandle, das der Schaltfläche "Datums- und Uhrzeitsymbolleiste" zugeordnet ist.

Hinweise

Diese Methode setzt die CMFCToolBarButton::GetHwnd-Methode außer Kraft.

CMFCToolBarDateTimeCtrl::GetTime

Ruft die ausgewählte Uhrzeit aus dem zugeordneten Datums- und Uhrzeitauswahl-Steuerelement ab und fügt sie in eine angegebene SYSTEMTIME-Struktur ein.

BOOL GetTime(COleDateTime& timeDest) const;
DWORD GetTime(CTime& timeDest) const;
DWORD GetTime(LPSYSTEMTIME pTimeDest) const;

Parameter

timeDest
[out] In der ersten Überladung erhält ein COleDateTime Class-Objekt , das die Systemzeitinformationen empfängt. In der zweiten Überladung erhält ein CTime-Objekt , das die Systemzeitinformationen empfängt.

pTimeDest
[out] Ein Zeiger auf die SYSTEMTIME-Struktur zum Empfangen der Systemzeitinformationen. Darf nicht NULL sein.

Rückgabewert

In der ersten Überladung ist nonzero, wenn die Zeit erfolgreich in das COleDateTime Class - Objekt geschrieben wird; andernfalls 0. In den zweiten und dritten Überladungen ist der Rückgabewert ein DWORD, das dem dwFlag-Element entspricht, das in der NMDATETIMECHANGE-Struktur festgelegt wurde.

Hinweise

Die Methode legt das NMDATETIMECHANGE-Strukturelement dwFlags fest, um anzugeben, ob die Datums- und Uhrzeitauswahl auf ein Datum und eine Uhrzeit festgelegt ist. Wenn der Wert GDT_NONE ist, wird das Steuerelement auf no date den Status festgelegt und verwendet die DTS_SHOWNONE Formatvorlage. Wenn der zurückgegebene Wert GDT_VALID entspricht, wird die Systemzeit erfolgreich am Zielspeicherort gespeichert.

CMFCToolBarDateTimeCtrl::GetTimeAll

Gibt die vom Benutzer ausgewählte Uhrzeit aus der Schaltfläche des Zeitauswahl-Steuerelements zurück, die über eine angegebene Befehls-ID verfügt.

static BOOL GetTimeAll(
    UINT uiCmd,
    COleDateTime& timeDest);

static DWORD GetTimeAll(
    UINT uiCmd,
    CTime& timeDest);

static DWORD GetTimeAll(
    UINT uiCmd,
    LPSYSTEMTIME pTimeDest);

Parameter

uiCmd
[in] Gibt die Befehls-ID einer Symbolleistenschaltfläche an.

timeDest
[out] In der ersten Überladung erhält ein COleDateTime Class-Objekt , das die Systemzeitinformationen empfängt. In der zweiten Überladung erhält ein CTime-Objekt , das die Systemzeitinformationen empfängt.

pTimeDest
[out] Ein Zeiger auf die SYSTEMTIME-Struktur zum Empfangen der Systemzeitinformationen. Darf nicht NULL sein.

Rückgabewert

Wenn das Framework keine Symbolleistenschaltfläche finden kann, die der Befehls-ID uiCmd entspricht, ist der Rückgabewert in der ersten Überladung null und GDT_NONE in den anderen Überladungen. Wenn die Symbolleistenschaltfläche gefunden wird, entspricht der Rückgabewert dem Rückgabewert eines Aufrufs von CMFCToolBarDateTimeCtrl::GetTime auf dieser Schaltfläche. Ein Rückgabewert von Null oder GDT_NONE kann auftreten, wenn die Schaltfläche gefunden wird, was angibt, dass der Aufruf GetTime kein gültiges Datum aus einem anderen Grund zurückgibt.

Hinweise

Diese Methode sucht nach einer Symbolleistenschaltfläche mit der angegebenen Befehls-ID und ruft cmFCToolBarDateTimeCtrl::GetTime-Methode auf dieser Schaltfläche auf.

CMFCToolBarDateTimeCtrl::HaveHotBorder

Bestimmt, ob ein Rahmen der Schaltfläche angezeigt wird, wenn ein Benutzer die Schaltfläche auswählt.

virtual BOOL HaveHotBorder() const;

Rückgabewert

Nonzero, wenn eine Schaltfläche den Rahmen anzeigt, wenn sie ausgewählt ist; andernfalls 0.

Hinweise

Diese Methode gibt einen Wert ungleich Null zurück, wenn das Steuerelement sichtbar ist.

CMFCToolBarDateTimeCtrl::NotifyCommand

Gibt an, ob die Schaltfläche die WM_COMMAND Nachricht verarbeitet.

virtual BOOL NotifyCommand(int iNotifyCode);

Parameter

iNotifyCode
[in] Die Benachrichtigung, die dem Befehl zugeordnet ist.

Rückgabewert

TRUE, wenn die Schaltfläche die WM_COMMAND Nachricht verarbeitet, oder FALSE, um anzugeben, dass die Nachricht von der übergeordneten Symbolleiste behandelt werden soll.

Hinweise

Das Framework ruft diese Methode auf, wenn es darum geht, eine WM_COMMAND Nachricht an das übergeordnete Fenster zu senden.

Diese Methode erweitert die Implementierung der Basisklasse ( CMFCToolBarButton::NotifyCommand) durch Verarbeitung der DTN_DATETIMECHANGE-Benachrichtigung . Er aktualisiert den internen Zeitstatus und aktualisiert die Zeiteigenschaft aller CMFCToolBarDateTimeCtrl Objekte mit derselben Befehls-ID.

CMFCToolBarDateTimeCtrl::OnAddToCustomizePage

Wird vom Framework aufgerufen, wenn die Schaltfläche einem Dialogfeld "Anpassen " hinzugefügt wird.

virtual void OnAddToCustomizePage();

Hinweise

Diese Methode erweitert die Basisklassenimplementierung CMFCToolBarButton::OnAddToCustomizePage, indem die Eigenschaften aus dem ersten Datums- und Uhrzeitsteuerelement in jede Symbolleiste kopiert werden, die dieselbe Befehls-ID wie dieses Objekt aufweist. Diese Methode führt nichts aus, wenn keine Symbolleiste über ein Datums- und Uhrzeitsteuerelement verfügt, das dieselbe Befehls-ID wie dieses Objekt aufweist.

Weitere Informationen zum Dialogfeld "Anpassen " finden Sie unter CMFCToolBarsCustomizeDialog-Klasse.

CMFCToolBarDateTimeCtrl::OnChangeParentWnd

Wird vom Framework aufgerufen, wenn die Schaltfläche in eine neue Symbolleiste eingefügt wird.

virtual void OnChangeParentWnd(CWnd* pWndParent);

Parameter

pWndParent
[in] Das neue übergeordnete Fenster.

Hinweise

Diese Methode setzt die Implementierung der Basisklasse außer Kraft ( CMFCToolBarButton::OnChangeParentWnd), indem das interne CMFCToolBarDateTimeCtrlImpl Objekt neu erstellt wird.

CMFCToolBarDateTimeCtrl::OnClick

Wird vom Framework aufgerufen, wenn der Benutzer auf das Steuerelement klickt.

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

Parameter

pWnd
[in] Nicht verwendet.

bDelay
[in] Nicht verwendet.

Rückgabewert

Nonzero, wenn die Schaltfläche die Klicknachricht verarbeitet; andernfalls 0.

Hinweise

Diese Methode setzt die Basisklassenimplementierung CMFCToolBarButton::OnClick außer Kraft, indem ein Wert ungleich Null zurückgegeben wird, wenn das interne CMFCToolBarDateTimeCtrlImpl Objekt sichtbar ist.

CMFCToolBarDateTimeCtrl::OnCtlColor

Wird vom Framework aufgerufen, wenn die übergeordnete Symbolleiste eine WM_CTLCOLOR Nachricht behandelt.

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

Parameter

pDC
[in] Der Gerätekontext, der die Schaltfläche anzeigt.

nCtlColor
[in] Nicht verwendet.

Rückgabewert

Ein Handle für den globalen Pinsel, den das Framework zum Zeichnen des Hintergrunds der Schaltfläche verwendet.

Hinweise

Diese Methode überschreibt die Basisklassenimplementierung CMFCToolBarButton::OnCtlColor, indem die Text- und Hintergrundfarben des bereitgestellten Gerätekontexts auf den globalen Text bzw. die Hintergrundfarben festgelegt werden.

Weitere Informationen zu globalen Optionen, die für Ihre Anwendung verfügbar sind, finden Sie unter AFX_GLOBAL_DATA Struktur.

CMFCToolBarDateTimeCtrl::OnGlobalFontsChanged

Wird vom Framework aufgerufen, wenn sich die globale Schriftart geändert hat.

virtual void OnGlobalFontsChanged();

Hinweise

Diese Methode erweitert die Implementierung der Basisklasse ( CMFCToolBarButton::OnGlobalFontsChanged) durch Ändern der Schriftart des Steuerelements auf die der globalen Schriftart.

Weitere Informationen zu globalen Optionen, die für Ihre Anwendung verfügbar sind, finden Sie unter AFX_GLOBAL_DATA Struktur.

CMFCToolBarDateTimeCtrl::OnMove

Wird vom Framework aufgerufen, wenn die übergeordnete Symbolleiste verschoben wird.

virtual void OnMove();

Hinweise

Diese Methode setzt die Standardklassenimplementierung ( CMFCToolBarButton::OnMove) außer Kraft, indem die Position des internen CMFCToolBarDateTimeCtrlImpl Objekts aktualisiert wird.

CMFCToolBarDateTimeCtrl::OnShow

Wird vom Framework aufgerufen, wenn die Schaltfläche sichtbar oder unsichtbar wird.

virtual void OnShow(BOOL bShow);

Parameter

bShow
[in] Gibt an, ob die Schaltfläche sichtbar ist. Wenn dieser Parameter TRUE ist, ist die Schaltfläche sichtbar. Andernfalls ist die Schaltfläche nicht sichtbar.

Hinweise

Diese Methode erweitert die Basisklassenimplementierung ( CMFCToolBarButton::OnShow), indem die Schaltfläche angezeigt wird, wenn bShow TRUE ist. Andernfalls blendet diese Methode die Schaltfläche aus.

CMFCToolBarDateTimeCtrl::OnSize

Wird vom Framework aufgerufen, wenn die übergeordnete Symbolleiste seine Größe oder Position ändert und diese Änderung bewirkt, dass die Schaltfläche die Größe ändert.

virtual void OnSize(int iSize);

Parameter

iSize
[in] Die neue Breite der Schaltfläche in Pixel.

Hinweise

Diese Methode setzt die Standardklassenimplementierung ( CMFCToolBarButton::OnSize) außer Kraft, indem die Größe und Position des internen CMFCToolBarDateTimeCtrlImpl Objekts aktualisiert wird.

CMFCToolBarDateTimeCtrl::OnUpdateToolTip

Wird vom Framework aufgerufen, wenn die übergeordnete Symbolleiste den QuickInfo-Text aktualisiert.

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

Parameter

pWndParent
[in] Das übergeordnete Fenster.

iButtonIndex
[in] Der nullbasierte Index der Schaltfläche in der übergeordneten Schaltflächensammlung.

wndToolTip
[in] Das Steuerelement, das den QuickInfo-Text anzeigt.

str
[out] Ein CString Objekt, das den aktualisierten QuickInfo-Text empfängt.

Rückgabewert

Nonzero, wenn die Methode den QuickInfo-Text aktualisiert; andernfalls 0.

Hinweise

Diese Methode erweitert die Implementierung der Basisklasse ( CMFCToolBarButton::OnUpdateToolTip), indem der QuickInfo-Text angezeigt wird, der der Schaltfläche zugeordnet ist. Wenn die Schaltfläche nicht horizontal angedockt ist, führt diese Methode nichts aus und gibt FALSE zurück.

CMFCToolBarDateTimeCtrl::SetTime

Legt die Uhrzeit und das Datum im Zeitauswahl-Steuerelement fest.

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

Parameter

timeNew
[in] In der ersten Version wird ein Verweis auf ein COleDateTime Class -Objekt verwendet, das die Zeit enthält, zu der das Steuerelement festgelegt wird. In der zweiten Version zeigt ein Zeiger auf ein CTime-Objekt , das die Uhrzeit enthält, zu der das Steuerelement festgelegt wird.

pTimeNew
[in] Ein Zeiger auf die SYSTEMTIME-Struktur , die die Uhrzeit enthält, zu der das Steuerelement festgelegt wird.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Hinweise

Legt die Uhrzeit in einem Datums- und Uhrzeitauswahl-Steuerelement fest, indem CDateTimeCtrl::SetTime aufgerufen wird.

CMFCToolBarDateTimeCtrl::SetTimeAll

Legt die Uhrzeit und das Datum in allen Instanzen des Zeitauswahl-Steuerelements fest, die über eine angegebene Befehls-ID verfügen.

static BOOL SetTimeAll(
    UINT uiCmd,
    const COleDateTime& timeNew);

static BOOL SetTimeAll(
    UINT uiCmd,
    const CTime* pTimeNew);

static BOOL SetTimeAll(
    UINT uiCmd,
    LPSYSTEMTIME pTimeNew=NULL);

Parameter

uiCmd
[in] Gibt die Befehls-ID einer Symbolleistenschaltfläche an.

timeNew
[in] In der ersten Version ein COleDateTime Class -Objekt, das die Zeit enthält, auf die das Steuerelement festgelegt wird. In der zweiten Version zeigt ein Zeiger auf ein CTime-Objekt , das die Uhrzeit enthält, zu der das Steuerelement festgelegt wird.

pTimeNew
[in] Ein Zeiger auf die SYSTEMTIME-Struktur , die die Uhrzeit enthält, zu der das Steuerelement festgelegt wird.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Hinweise

Sucht nach einer Symbolleistenschaltfläche mit der angegebenen Befehls-ID und legt die Uhrzeit in einem Datums- und Uhrzeitauswahl-Steuerelement fest, indem CMFCToolBarDateTimeCtrl::SetTime aufgerufen wird.

Siehe auch

Hierarchiediagramm
Klassen
CMFCToolBarButton-Klasse
Exemplarische Vorgehensweise: Steuerelemente in eine Symbolleiste einfügen

  • Last updated on