CMFCDesktopAlertWnd Class

Article
10/12/2023

La CMFCDesktopAlertWnd classe implémente les fonctionnalités d’une boîte de dialogue sans mode qui apparaît à l’écran pour informer l’utilisateur d’un événement.

Pour plus d’informations, consultez le code source situé dans le dossier VC\atlmfc\src\mfc de votre installation de Visual Studio.

Syntaxe

class CMFCDesktopAlertWnd : public CWnd

Membres

Méthodes publiques

Nom	Description
CMFCDesktopAlertWnd ::Create	Crée et initialise la fenêtre d’alerte de bureau.
CMFCDesktopAlertWnd ::GetAnimationSpeed	Retourne la vitesse d’animation.
CMFCDesktopAlertWnd ::GetAnimationType	Retourne le type d’animation.
CMFCDesktopAlertWnd ::GetAutoCloseTime	Retourne le délai d’expiration de fermeture automatique.
CMFCDesktopAlertWnd ::GetCaptionHeight	Retourne la hauteur de la légende.
CMFCDesktopAlertWnd ::GetDialogSize
CMFCDesktopAlertWnd ::GetLastPos	Retourne la dernière position valide de la fenêtre d’alerte de bureau sur l’écran.
CMFCDesktopAlertWnd ::GetTransparency	Retourne le niveau de transparence.
CMFCDesktopAlertWnd ::HasSmallCaption	Détermine si la fenêtre d’alerte de bureau s’affiche avec la petite légende.
CMFCDesktopAlertWnd ::OnBeforeShow
CMFCDesktopAlertWnd ::OnClickLinkButton	Appelé par l’infrastructure lorsque l’utilisateur clique sur un bouton de lien situé dans le menu d’alerte de bureau.
CMFCDesktopAlertWnd ::OnCommand	L’infrastructure appelle cette fonction membre lorsque l’utilisateur sélectionne un élément dans un menu, lorsqu’un contrôle enfant envoie un message de notification ou lorsqu’une séquence de touches d’accélérateur est traduite. (Remplacements CWnd ::OnCommand.)
CMFCDesktopAlertWnd ::OnDraw
CMFCDesktopAlertWnd ::P rocessCommand
CMFCDesktopAlertWnd ::SetAnimationSpeed	Définit la nouvelle vitesse d’animation.
CMFCDesktopAlertWnd ::SetAnimationType	Définit le type d’animation.
CMFCDesktopAlertWnd ::SetAutoCloseTime	Définit le délai d’expiration de fermeture automatique.
CMFCDesktopAlertWnd ::SetSmallCaption	Bascule entre les légendes petites et normales.
CMFCDesktopAlertWnd ::SetTransparency	Définit le niveau de transparence.

Notes

Une fenêtre d’alerte de bureau peut être transparente, elle peut apparaître avec des effets d’animation et peut disparaître (après un délai spécifié ou lorsque l’utilisateur l’ignore en cliquant sur le bouton fermer).

Une fenêtre d’alerte de bureau peut également contenir une boîte de dialogue par défaut qui contient à son tour une icône, un texte de message (étiquette) et un lien. Une fenêtre d’alerte de bureau peut également contenir une boîte de dialogue personnalisée à partir des ressources de l’application.

Vous créez une fenêtre d’alerte de bureau en deux étapes. Tout d’abord, appelez le constructeur pour construire l’objet CMFCDesktopAlertWnd . Ensuite, appelez la fonction membre CMFCDesktopAlertWnd ::Create pour créer la fenêtre et l’attacher à l’objet CMFCDesktopAlertWnd .

L’objet CMFCDesktopAlertWnd crée une boîte de dialogue enfant spéciale qui remplit la zone cliente de la fenêtre d’alerte de bureau. La boîte de dialogue possède tous les contrôles qui sont positionnés dessus.

Pour afficher une boîte de dialogue personnalisée dans la fenêtre contextuelle, procédez comme suit :

Dérivez une classe de CMFCDesktopAlertDialog.
Créer un modèle de boîte de dialogue enfant dans les ressources.
Appelez CMFCDesktopAlertWnd ::Create à l’aide de l’ID de ressource du modèle de boîte de dialogue et d’un pointeur vers les informations de classe runtime de la classe dérivée.
Programmez la boîte de dialogue personnalisée pour gérer toutes les notifications provenant des contrôles hébergés ou programmez les contrôles hébergés pour gérer ces notifications directement.

Utilisez les fonctions suivantes pour contrôler le comportement de la fenêtre d’alerte de bureau :

Définissez le type d’animation en appelant CMFCDesktopAlertWnd ::SetAnimationType. Les options valides incluent le déroulement, la diapositive et le fondu.
Définissez la vitesse de l’image d’animation en appelant CMFCDesktopAlertWnd ::SetAnimationSpeed.
Définissez le niveau de transparence en appelant CMFCDesktopAlertWnd ::SetTransparency.
Remplacez la taille de la légende par petite en appelant CMFCDesktopAlertWnd ::SetSmallCaption. La petite légende est de 7 pixels.

Exemple

L’exemple suivant montre comment utiliser différentes méthodes dans la CMFCDesktopAlertWnd classe pour configurer un CMFCDesktopAlertWnd objet. L’exemple montre comment définir un type d’animation, définir la transparence de la fenêtre contextuelle, spécifier que la fenêtre d’alerte affiche une petite légende et définir le temps écoulé avant la fermeture automatique de la fenêtre d’alerte. L’exemple montre également comment créer et initialiser la fenêtre d’alerte de bureau. Cet extrait de code fait partie de l’exemple de démonstration d’alerte de bureau.

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));
   }
}

Hiérarchie d'héritage

Spécifications

En-tête : afxDesktopAlertWnd.h

CMFCDesktopAlertWnd ::Create

Crée et initialise la fenêtre d’alerte de bureau.

virtual BOOL Create(
    CWnd* pWndOwner,
    UINT uiDlgResID,
    HMENU hMenu = NULL,
    CPoint ptPos = CPoint(-1,-1),
    CRuntimeClass* pRTIDlgBar = RUNTIME_CLASS(CMFCDesktopAlertDialog));

virtual BOOL Create(
    CWnd* pWndOwner,
    CMFCDesktopAlertWndInfo& params,
    HMENU hMenu = NULL,
    CPoint ptPos = CPoint(-1,-1));

Paramètres

pWndOwner
[in, out] Spécifie le propriétaire de la fenêtre d’alerte. Ce propriétaire recevra ensuite toutes les notifications pour la fenêtre d’alerte de bureau. Cette valeur ne peut pas être NULL.

uiDlgResID
[in] Spécifie l’ID de ressource de la fenêtre d’alerte.

hMenu
[in] Spécifie le menu qui s’affiche lorsque l’utilisateur clique sur le bouton de menu. Si la valeur est NULL, le bouton de menu n’est pas affiché.

ptPos
[in] Spécifie la position initiale où la fenêtre d’alerte s’affiche, à l’aide des coordonnées de l’écran. Si ce paramètre est (-1, -1), la fenêtre d’alerte s’affiche dans le coin inférieur droit de l’écran.

pRTIDlgBar
[in] Informations de classe Runtime pour une classe de boîte de dialogue personnalisée qui couvre la zone cliente de la fenêtre d’alerte.

params
[in] Spécifie les paramètres utilisés pour créer une fenêtre d’alerte.

Valeur de retour

TRUE si la fenêtre d’alerte a été créée avec succès ; sinon, FALSE.

Notes

Appelez cette méthode pour créer une fenêtre d’alerte. La zone cliente de la fenêtre d’alerte contient une boîte de dialogue enfant qui héberge tous les contrôles affichés à l’utilisateur.

La première surcharge de méthode crée une fenêtre d’alerte qui contient une boîte de dialogue enfant chargée à partir des ressources de l’application. La première surcharge de méthode peut également spécifier des informations de classe runtime pour une classe de boîte de dialogue personnalisée.

La deuxième surcharge de méthode crée une fenêtre d’alerte qui contient des contrôles par défaut. Vous pouvez spécifier les contrôles à afficher en modifiant la classe CMFCDesktopAlertWndInfo.

CMFCDesktopAlertWnd ::GetAnimationSpeed

Retourne la vitesse d’animation.

UINT GetAnimationSpeed() const;

Valeur de retour

Vitesse d’animation de la fenêtre d’alerte, en millisecondes.

Notes

La vitesse d’animation décrit la vitesse à laquelle la fenêtre d’alerte s’ouvre et se ferme.

CMFCDesktopAlertWnd ::GetAnimationType

Retourne le type d’animation.

CMFCPopupMenu::ANIMATION_TYPE GetAnimationType();

Valeur de retour

L’un des types d’animation suivants :

NO_ANIMATION
DÉPLIER
DIAPOSITIVE
Se faner
SYSTEM_DEFAULT_ANIMATION

CMFCDesktopAlertWnd ::GetAutoCloseTime

Retourne le délai d’expiration de fermeture automatique.

int GetAutoCloseTime() const;

Valeur de retour

Heure, en millisecondes, après laquelle la fenêtre d’alerte se ferme automatiquement.

Notes

Utilisez cette méthode pour déterminer combien de temps doit s’écouler avant la fermeture automatique de la fenêtre d’alerte.

CMFCDesktopAlertWnd ::GetCaptionHeight

Retourne la hauteur de la légende.

virtual int GetCaptionHeight();

Valeur de retour

Hauteur, en pixels, de la légende.

Notes

Cette méthode peut être substituée dans une classe dérivée. L’implémentation par défaut : retourne la petite valeur de hauteur de légende (7 pixels) si la fenêtre contextuelle doit afficher la petite légende ou la valeur obtenue à partir de la fonction GetSystemMetrics(SM_CYSMCAPTION)API Windows.

CMFCDesktopAlertWnd ::GetLastPos

Retourne la dernière position de la fenêtre d’alerte de bureau sur l’écran.

CPoint GetLastPos() const;

Valeur de retour

Point, en coordonnées d’écran.

Notes

Cette méthode retourne la dernière position valide de la fenêtre d’alerte à l’écran.

CMFCDesktopAlertWnd ::GetTransparency

Retourne le niveau de transparence.

BYTE GetTransparency() const;

Valeur de retour

Niveau de transparence compris entre 0 et 255. Plus la valeur est élevée, plus la fenêtre est opaque.

Notes

Utilisez cette méthode pour récupérer le niveau de transparence actuel de la fenêtre d’alerte.

CMFCDesktopAlertWnd ::HasSmallCaption

Détermine si la fenêtre d’alerte de bureau a une petite légende ou une légende de taille régulière.

BOOL HasSmallCaption() const;

Valeur de retour

TRUE si la fenêtre contextuelle s’affiche avec une petite légende ; FALSE si la fenêtre contextuelle s’affiche avec une légende de taille régulière.

Notes

Utilisez cette méthode pour déterminer si la fenêtre contextuelle a une petite légende ou une légende de taille régulière. Par défaut, la petite légende est de 7 pixels. Vous pouvez obtenir la hauteur de la légende de taille régulière en appelant la fonction GetSystemMetrics(SM_CYCAPTION)API Windows.

CMFCDesktopAlertWnd ::OnBeforeShow

virtual BOOL OnBeforeShow(CPoint&);

Paramètres

[in] CPoint&

Valeur de retour

Notes

CMFCDesktopAlertWnd ::OnClickLinkButton

Appelé par l’infrastructure lorsque l’utilisateur clique sur un bouton de lien situé dans le menu d’alerte de bureau.

virtual BOOL OnClickLinkButton(UINT uiCmdID);

Paramètres

uiCmdID
[in] Ce paramètre n’est pas utilisé.

Valeur de retour

Toujours FALSE.

Notes

Remplacez cette méthode dans une classe dérivée si vous souhaitez être averti lorsqu’un utilisateur clique sur le lien dans la fenêtre d’alerte.

CMFCDesktopAlertWnd ::OnCommand

virtual BOOL OnCommand(
    WPARAM wParam,
    LPARAM lParam);

Paramètres

[in] wParam

[in] lParam

Valeur de retour

Notes

CMFCDesktopAlertWnd ::OnDraw

virtual void OnDraw(CDC* pDC);

Paramètres

[in] pDC

Notes

CMFCDesktopAlertWnd ::P rocessCommand

BOOL ProcessCommand(HWND hwnd);

Paramètres

[in] hwnd

Valeur de retour

Notes

CMFCDesktopAlertWnd ::SetAnimationSpeed

Définit la nouvelle vitesse d’animation.

void SetAnimationSpeed(UINT nSpeed);

Paramètres

nSpeed
[in] Spécifie la nouvelle vitesse d’animation, en millisecondes.

Notes

Appelez cette méthode pour définir la vitesse d’animation de la fenêtre d’alerte. La vitesse d’animation par défaut est de 30 millisecondes.

CMFCDesktopAlertWnd ::SetAnimationType

Définit le type d’animation.

void SetAnimationType(CMFCPopupMenu::ANIMATION_TYPE type);

Paramètres

type
[in] Spécifie le type d’animation.

Notes

Appelez cette méthode pour définir le type d’animation. Vous pouvez spécifier l’une des valeurs suivantes :

NO_ANIMATION
DÉPLIER
DIAPOSITIVE
Se faner
SYSTEM_DEFAULT_ANIMATION

CMFCDesktopAlertWnd ::SetAutoCloseTime

Définit le délai d’expiration de fermeture automatique.

void SetAutoCloseTime(int nTime);

Paramètres

nTime
[in] Temps, en millisecondes, qui s’écoule avant la fermeture automatique de la fenêtre d’alerte.

Notes

La fenêtre d’alerte est automatiquement fermée après l’heure spécifiée si l’utilisateur n’interagit pas avec la fenêtre.

CMFCDesktopAlertWnd ::SetSmallCaption

Bascule entre les légendes de petite taille et de taille régulière.

void SetSmallCaption(BOOL bSmallCaption = TRUE);

Paramètres

bSmallCaption
[in] TRUE pour spécifier que la fenêtre d’alerte affiche une petite légende ; sinon, FALSE pour spécifier que la fenêtre d’alerte affiche une légende de taille normale.

Notes

Appelez cette méthode pour afficher la légende petite ou normale. Par défaut, la petite légende est de 7 pixels. Vous pouvez obtenir la taille de la légende régulière en appelant la fonction GetSystemMetrics(SM_CYCAPTION)API Windows.

CMFCDesktopAlertWnd ::SetTransparency

Définit le niveau de transparence de la fenêtre contextuelle.

void SetTransparency(BYTE nTransparency);

Paramètres

nTransparency
[in] Spécifie le niveau de transparence. Cette valeur doit être comprise entre 0 et 255, inclus. Plus la valeur est élevée, plus la fenêtre est opaque.

Notes

Appelez cette fonction pour définir le niveau de transparence de la fenêtre contextuelle.

CMFCDesktopAlertWnd ::GetDialogSize

virtual CSize GetDialogSize();

Valeur de retour

Notes

Voir aussi

Graphique hiérarchique
Classes
CMFCDesktopAlertWndInfo, classe
CMFCDesktopAlertDialog, classe
CWnd, classe

Partager via

CMFCDesktopAlertWnd Class

Syntaxe

Membres

Méthodes publiques

Notes

Exemple

Hiérarchie d'héritage

Spécifications

CMFCDesktopAlertWnd ::Create

Paramètres

Valeur de retour

Notes

CMFCDesktopAlertWnd ::GetAnimationSpeed

Valeur de retour

Notes

CMFCDesktopAlertWnd ::GetAnimationType

Valeur de retour

CMFCDesktopAlertWnd ::GetAutoCloseTime

Valeur de retour

Notes

CMFCDesktopAlertWnd ::GetCaptionHeight

Valeur de retour

Notes

CMFCDesktopAlertWnd ::GetLastPos

Valeur de retour

Notes

CMFCDesktopAlertWnd ::GetTransparency

Valeur de retour

Notes

CMFCDesktopAlertWnd ::HasSmallCaption

Valeur de retour

Notes

CMFCDesktopAlertWnd ::OnBeforeShow

Paramètres

Valeur de retour

Notes

CMFCDesktopAlertWnd ::OnClickLinkButton

Paramètres

Valeur de retour

Notes

CMFCDesktopAlertWnd ::OnCommand

Paramètres

Valeur de retour

Notes

CMFCDesktopAlertWnd ::OnDraw

Paramètres

Notes

CMFCDesktopAlertWnd ::P rocessCommand

Paramètres

Valeur de retour

Notes

CMFCDesktopAlertWnd ::SetAnimationSpeed

Paramètres

Notes

CMFCDesktopAlertWnd ::SetAnimationType

Paramètres

Notes

CMFCDesktopAlertWnd ::SetAutoCloseTime

Paramètres

Notes

CMFCDesktopAlertWnd ::SetSmallCaption

Paramètres

Notes

CMFCDesktopAlertWnd ::SetTransparency

Paramètres

Notes

CMFCDesktopAlertWnd ::GetDialogSize

Valeur de retour

Notes

Voir aussi

Commentaires

Ressources supplémentaires