Classe de CMFCStatusBar

Article
03/12/2013

La classe d' CMFCStatusBar implémente une barre d'état similaire à la classe d' CStatusBar .Toutefois, la classe d' CMFCStatusBar possède des fonctionnalités non offertes par la classe d' CStatusBar , telle que la possibilité d'afficher des images, des animations, et les barres de progression ; et la possibilité de répondre à des doublons clics de souris.

class CMFCStatusBar : public CPane

Membres

Méthodes publiques

Nom	Description
CMFCStatusBar::CalcFixedLayout	(Substitutions CBasePane::CalcFixedLayout.)
CMFCStatusBar::CommandToIndex
CMFCStatusBar::Create	Crée une barre de contrôles et la attaché à l'objet de CPane .(Substitutions CPane::Create.)
CMFCStatusBar::CreateEx	Crée une barre de contrôles et la attaché à l'objet de CPane .(Substitutions CPane::CreateEx.)
CMFCStatusBar::DoesAllowDynInsertBefore	Détermine si un autre volet peut être dynamiquement inséré entre ce volet et le frame parent.(Substitutions CBasePane::DoesAllowDynInsertBefore.)
CMFCStatusBar::EnablePaneDoubleClick	Active ou désactive la gestion des doublons clics de souris dans la barre d'état.
CMFCStatusBar::EnablePaneProgressBar	Affiche une barre de progression dans le volet spécifié.
CMFCStatusBar::GetCount	Retourne le nombre de volets dans la barre d'état.
CMFCStatusBar::GetDrawExtendedArea
CMFCStatusBar::GetExtendedArea
CMFCStatusBar::GetItemID
CMFCStatusBar::GetItemRect
CMFCStatusBar::GetPaneInfo
CMFCStatusBar::GetPaneProgress
CMFCStatusBar::GetPaneStyle	Retourne le style de volet.(Substitutions CBasePane::GetPaneStyle.)
CMFCStatusBar::GetPaneText
CMFCStatusBar::GetPaneWidth	Retourne la largeur, en pixels, du volet spécifié de la barre d'état.
CMFCStatusBar::GetTipText	Retourne le texte d'info-bulle pour le volet spécifié de la barre d'état.
CMFCStatusBar::InvalidatePaneContent	Invalide le volet spécifié et redessine son contenu.
CMFCStatusBar::PreCreateWindow	Appelé par l'infrastructure avant la création de la fenêtre de windows attachée à cet objet d' CWnd .(Substitutions CWnd::PreCreateWindow.)
CMFCStatusBar::SetDrawExtendedArea
CMFCStatusBar::SetIndicators
CMFCStatusBar::SetPaneAnimation	Assigne une animation dans le volet spécifié.
CMFCStatusBar::SetPaneBackgroundColor	Définit la couleur d'arrière-plan du volet spécifié de la barre d'état.
CMFCStatusBar::SetPaneIcon	Définit l'icône d'indicateur pour le volet spécifié de la barre d'état.
CMFCStatusBar::SetPaneInfo
CMFCStatusBar::SetPaneProgress	Définit la progression actuelle de la barre de progression du volet spécifié de la barre d'état.
CMFCStatusBar::SetPaneStyle	Définit le style du volet.(Substitutions CBasePane::SetPaneStyle.)
CMFCStatusBar::SetPaneText
CMFCStatusBar::SetPaneTextColor	Définit la couleur de texte du volet spécifié de la barre d'état.
CMFCStatusBar::SetPaneWidth	Définit la largeur en pixels du volet spécifié de la barre d'état.
CMFCStatusBar::SetTipText	Définit le texte d'info-bulle pour le volet spécifié de la barre d'état.

Méthodes protégées

Nom	Description
CMFCStatusBar::OnDrawPane	Appelé par l'infrastructure lorsqu'elle redessine le volet de la barre d'état.

Notes

Le diagramme suivant illustre une illustration de la barre d'état de l'application d' Exemple de démonstration de barre d'état .

Image CMFCStatusBar

Exemple

L'exemple suivant illustre l'utilisation des variables locales que l'application utilise pour appeler des méthodes dans la classe d' CMFCStatusBar .Ces variables sont déclarées dans StatusBarDemoView.h.Le frame principal est déclaré dans MainFrm.h, le document est déclaré dans StatusBarDemoDoc.h, et la vue est déclarée dans StatusBarDemoView.h.Cet extrait de code fait partie d' Exemple de démonstration de barre d'état.

    int         m_nProgressCurr;
    BOOL        m_bInProgress;

    CImageList  m_imlStatusAnimation;
    BOOL        m_bInAnimation;

    CBitmap     m_bmpIcon1;
    CBitmap     m_bmpIcon2;

L'exemple suivant montre comment obtenir une référence à l'objet d' CMFCStatusBar en tapant la méthode d' GetStatusBar dans MainFrm.h puis en appelant cette méthode de la méthode d' GetStatusBar dans StatusBarDemoView.h.Cet extrait de code fait partie d' Exemple de démonstration de barre d'état.

// in MainFrm.h
public:
    CMFCStatusBar& GetStatusBar ()
    {
        return m_wndStatusBar;
    }


...


    // in StatusBarDemoView.h
    CMFCStatusBar& GetStatusBar () const
    {
        return ((CMainFrame*) AfxGetMainWnd ())->GetStatusBar ();
    }

L'exemple suivant montre comment appeler des méthodes dans la classe d' CMFCStatusBar dans StatusBarDemoView.cpp.Les constantes sont déclarées dans MainFrm.h.L'exemple suivant indique comment définir l'icône, définir le texte d'info-bulle du volet de barre d'état, afficher une barre de progression dans le volet spécifié, assigner une animation dans le volet spécifié, définir le texte et la largeur du volet de barre d'état, et définir l'indicateur de progression actuel de la barre de progression du volet de barre d'état.Cet extrait de code fait partie d' Exemple de démonstration de barre d'état.

// in MainFrm.h
const int nStatusIcon = 0;
const int nStatusInfo = 1;
const int nStatusProgress = 2;
const int nStatusLabel = 3;
const int nStatusAnimation = 4;


...


    // in StatusBarDemoView.cpp
    GetStatusBar ().SetPaneIcon (nStatusIcon, m_bmpIcon1);
    GetStatusBar ().SetTipText (nStatusIcon, _T("This is a tooltip"));


...


    GetStatusBar ().EnablePaneProgressBar (nStatusProgress, PROGRESS_MAX);


...


        GetStatusBar ().SetPaneAnimation (nStatusAnimation, NULL);


...


    GetStatusBar ().SetPaneAnimation (nStatusAnimation, m_imlStatusAnimation);
    GetStatusBar ().SetPaneText (nStatusAnimation, _T(""));
    GetStatusBar ().SetPaneWidth (nStatusAnimation, 16);


...


        GetStatusBar ().SetPaneProgress (nStatusProgress, m_nProgressCurr);