CMFCDesktopAlertWnd-Klasse

Artikel
02/26/2013

Die CMFCDesktopAlertWnd-Klasse implementiert die Funktionalität eines nicht modalen Dialogfelds, das auf dem Bildschirm angezeigt wird, den Benutzer über ein Ereignis zu informieren.

class CMFCDesktopAlertWnd : public CWnd

Mitglieder

Öffentliche Methoden

Name	Description
CMFCDesktopAlertWnd::Create	Erstellt und initialisiert das benutzerdefinierte TischplattenFenster.
CMFCDesktopAlertWnd::GetAnimationSpeed	Gibt die Animationsgeschwindigkeit zurück.
CMFCDesktopAlertWnd::GetAnimationType	Gibt den Animationstyp zurück.
CMFCDesktopAlertWnd::GetAutoCloseTime	Gibt das automatisch geschlossene Timeout zurück.
CMFCDesktopAlertWnd::GetCaptionHeight	Gibt die Höhe der Beschriftung zurück.
CMFCDesktopAlertWnd::GetDialogSize
CMFCDesktopAlertWnd::GetLastPos	Gibt die letzte gültige Position des ausgewählten TischplattenFensters auf dem Bildschirm zurück.
CMFCDesktopAlertWnd::GetTransparency	Gibt die Transparenzebene zurück.
CMFCDesktopAlertWnd::HasSmallCaption	Bestimmt, ob das benutzerdefinierte TischplattenFenster mit der kleinen Beschriftung angezeigt wird.
CMFCDesktopAlertWnd::OnBeforeShow
CMFCDesktopAlertWnd::OnClickLinkButton	Aufgerufen vom Framework, wenn der Benutzer auf eine Linkschaltfläche auf dem ausgewählten TischplattenMenü klickt.
CMFCDesktopAlertWnd::OnCommand	Das Framework ruft diese Memberfunktion auf, wenn der Benutzer ein Element aus einem Menü ausgewählt wird, wenn ein untergeordnetes Steuerelement eine Benachrichtigung sendet oder wenn eine Zugriffstastentastatureingabe übersetzt wird.(Überschreibungen CWnd::OnCommand.)
CMFCDesktopAlertWnd::OnDraw
CMFCDesktopAlertWnd::ProcessCommand
CMFCDesktopAlertWnd::SetAnimationSpeed	Legt die neue Animationsgeschwindigkeit fest.
CMFCDesktopAlertWnd::SetAnimationType	Legt den Animationstyp fest.
CMFCDesktopAlertWnd::SetAutoCloseTime	Legt das automatisch geschlossene Timeout fest.
CMFCDesktopAlertWnd::SetSmallCaption	Wechseln zwischen den kleinen und normalen Beschriftungen.
CMFCDesktopAlertWnd::SetTransparency	Legt die Transparenzebene fest.

Hinweise

Ein wachsames TischplattenFenster kann transparent, kann es mit Animationseffekten angezeigt werden, und es werden kann (nach einer bestimmten Verzögerung oder, wenn der Benutzer es ablehnt, indem er auf die Schaltfläche "Schließen" klickt).

Ein wachsames TischplattenFenster kann ein Standarddialogfeld auch enthalten, das wiederum ein Symbol, Meldungstext (eine Bezeichnung) und einen Link enthält.Alternativ kann ein wachsames TischplattenFenster ein benutzerdefiniertes Dialogfeld von Ressourcen der Anwendung enthalten.

Sie erstellen ein wachsames TischplattenFenster in zwei Schritten erstellt.Zuerst rufen Sie den Konstruktor auf, um das CMFCDesktopAlertWnd-Objekt zu erstellen.Zweitens CMFCDesktopAlertWnd::Create rufen Sie die Memberfunktion auf, um das Fenster zu erstellen und auf den CMFCDesktopAlertWnd-Objekt anzufügen.

Das Objekt stellt CMFCDesktopAlertWnd ein bestimmtes untergeordnetes Dialogfeld erstellt, das den Clientbereich des ausgewählten TischplattenFensters ausfüllt.Das Dialogfeld besitzt alle Steuerelemente, die auf ihm positioniert werden.

Um ein benutzerdefiniertes Dialogfeld auf dem Popupfenster anzuzeigen, führen Sie folgende Schritte aus:

Leiten Sie eine Klasse von CMFCDesktopAlertDialog ab.
Erstellen Sie eine untergeordnete Dialogfeldvorlage in Ressourcen.
Rufen Sie CMFCDesktopAlertWnd::Create mithilfe des Ressourcen-ID der Dialogfeldvorlage und den Zeiger auf das Ablaufklasseninformationen der abgeleiteten Klasse auf.
Programmieren Sie das benutzerdefinierte Dialogfeld, um alle Benachrichtigungen zu bearbeiten, die von den gehosteten Steuerelementen, stammen oder programmieren Sie die gehosteten Steuerelemente, um diese Benachrichtigungen direkt zu bearbeiten.

Verwenden Sie die folgenden Funktionen, um das Verhalten des Desktopwarnungsfensters zu steuern:

Legen Sie den Animationstyp fest, indem Sie CMFCDesktopAlertWnd::SetAnimationType aufriefen.Gültiges Optionseinschliessung falten auf, schieben und blenden aus.
Legen Sie die Animationsframegeschwindigkeit fest, indem Sie CMFCDesktopAlertWnd::SetAnimationSpeed aufriefen.
Legen Sie die Transparenz fest, indem Sie CMFCDesktopAlertWnd::SetTransparency glätten, aufriefen.
Ändern Sie die Größe der Beschriftung zu kleinem, indem Sie CMFCDesktopAlertWnd::SetSmallCaption aufrufen.Die kleine Beschriftung ist 7 Pixel hoch.

Beispiel

Das folgende Beispiel veranschaulicht, wie verschiedene Methoden in der CMFCDesktopAlertWnd-Klasse verwendet, um ein CMFCDesktopAlertWnd-Objekt zu konfigurieren.Im Beispiel wird gezeigt, wie ein Animationstyp, legen Sie die Transparenz des Popupfensters, angeben, dass das Warnungsereignisse Fenster eine kleine Beschriftung anzeigt, und legen die Zeit festgelegt wird, die Verläufe vor dem Warnmeldungsfenster automatisch geschlossen wird.Das Beispiel zeigt auch, wie das benutzerdefinierte TischplattenFenster erstellt und initialisiert.Dieser Codeausschnitt ist Teil Desktop-wachsames Demobeispiel.

    CMFCDesktopAlertWnd* pPopup = new CMFCDesktopAlertWnd;

    // int m_nAnimation
    pPopup->SetAnimationType ((CMFCPopupMenu::ANIMATION_TYPE) m_nAnimation);
    
    // int m_nAnimationSpeed
    pPopup->SetAnimationSpeed (m_nAnimationSpeed);
    
    // int m_nTransparency
    pPopup->SetTransparency ((BYTE)m_nTransparency);
    
    // BOOL m_bSmallCaption
    pPopup->SetSmallCaption (m_bSmallCaption);

    // BOOL m_bAutoClose, int m_nAutoCloseTime
    pPopup->SetAutoCloseTime (m_bAutoClose ? m_nAutoCloseTime * 1000 : 0);

    // int m_nPopupSource
    if (m_nPopupSource == 0)
    {
        // int m_nVisualMngr
        // CPoint m_ptPopup
        // The this pointer points to a CDesktopAlertDemoDlg class which extends the CDialogEx class.
        if (m_nVisualMngr == 5) // MSN-style
        {
            pPopup->Create (this, IDD_DIALOG2, NULL, 
                m_ptPopup, RUNTIME_CLASS (CMSNDlg));
        }
        else
        {
            pPopup->Create (this, IDD_DIALOG1, 
                m_menuPopup.GetSubMenu (0)->GetSafeHmenu (), 
                m_ptPopup, RUNTIME_CLASS (CMyPopupDlg));
        }
    }