Klasse CMFCRibbonStatusBar

De CMFCRibbonStatusBar klasse implementeert een statusbalkbesturingselement waarmee lintelementen kunnen worden weergegeven.

Syntaxis

class CMFCRibbonStatusBar : public CMFCRibbonBar

Leden

Openbare methoden

Beveiligde methoden

Opmerkingen

Gebruikers kunnen de zichtbaarheid van lintelementen op een lintstatusbalk wijzigen met behulp van het ingebouwde contextmenu voor de lintstatusbalk. U kunt elementen dynamisch toevoegen of verwijderen.

Een lintstatusbalk heeft twee gebieden: een hoofdgebied en een uitgebreid gebied. Het uitgebreide gebied wordt aan de rechterkant van de statusbalk van het lint weergegeven en wordt weergegeven in een andere kleur dan het hoofdgebied.

Normaal gesproken worden in het hoofdgebied van de statusbalk statusmeldingen weergegeven en in het uitgebreide gebied worden weergavebesturingselementen weergegeven. Het uitgebreide gebied blijft zo lang mogelijk zichtbaar wanneer de gebruiker de grootte van de lintstatusbalk wijzigt.

Example

In het volgende voorbeeld ziet u hoe u verschillende methoden in de CMFCRibbonStatusBar klasse gebruikt. In het voorbeeld ziet u hoe u een nieuw lintelement toevoegt aan de statusbalk van het lint, een lintelement toevoegt aan het uitgebreide gebied van de lintstatusbalk, een scheidingsteken toevoegt en de normale modus voor de statusbalk van het lint inschakelt.

// CMFCRibbonStatusBar  m_wndStatusBar
m_wndStatusBar.AddElement(rsbp, strTitlePane1);
m_wndStatusBar.AddExtendedElement(new CMFCRibbonStatusBarPane(ID_STATUSBAR_PANE2, strTitlePane2, TRUE),
                                  strTitlePane2);

m_wndStatusBar.AddSeparator();
m_wndStatusBar.SetInformation(NULL);

Overnamehiërarchie

CObject

CCmdTarget-

CWnd

CBasePane

CPane

CMFCRibbonBar

CMFCRibbonStatusBar

Requirements

Koptekst: afxribbonstatusbar.h

CMFCRibbonStatusBar::AddDynamicElement

Hiermee voegt u een dynamisch element toe aan de statusbalk van het lint.

void AddDynamicElement(CMFCRibbonBaseElement* pElement);

Parameterwaarden

pElement
[in] Een aanwijzer naar een dynamisch element.

Opmerkingen

In tegenstelling tot reguliere elementen kunnen dynamische elementen niet worden aangepast en worden deze niet weergegeven in het menu Aanpassen van de statusbalk.

CMFCRibbonStatusBar::AddElement

Hiermee voegt u een nieuw lintelement toe aan de statusbalk van het lint.

void AddElement(
    CMFCRibbonBaseElement* pElement,
    LPCTSTR lpszLabel,
    BOOL bIsVisible=TRUE);

Parameterwaarden

pElement
[in] Een aanwijzer naar het toegevoegde element.

lpszLabel
[in] Een tekstlabel van het element.

bIsVisible
[in] WAAR als u het element als zichtbaar wilt toevoegen, ONWAAR als u het element als verborgen wilt toevoegen.

CMFCRibbonStatusBar::AddExtendedElement

Hiermee voegt u een lintelement toe aan het uitgebreide gebied van de statusbalk van het lint.

void AddExtendedElement(
    CMFCRibbonBaseElement* pElement,
    LPCTSTR lpszLabel,
    BOOL bIsVisible=TRUE);

Parameterwaarden

pElement
[in] Een aanwijzer naar het toegevoegde element.

lpszLabel
[in] Het tekstlabel van het element.

bIsVisible
[in] WAAR als u het element als zichtbaar wilt toevoegen, ONWAAR als u het element als verborgen wilt toevoegen.

Opmerkingen

Het uitgebreide gebied bevindt zich aan de rechterkant van het besturingselement voor de statusbalk.

CMFCRibbonStatusBar::AddSeparator

Hiermee voegt u een scheidingsteken toe aan de statusbalk van het lint.

void AddSeparator();

Opmerkingen

Het framework voegt een scheidingsteken toe na de methode CMFCRibbonStatusBar::AddElement. voegt het laatste element in.

CMFCRibbonStatusBar::Create

Hiermee maakt u een lintstatusbalk.

BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle=WS_CHILD|WS_VISIBLE|CBRS_BOTTOM,
    UINT nID=AFX_IDW_STATUS_BAR);

Parameterwaarden

pParentWnd
[in] Een aanwijzer naar het bovenliggende venster.

dwStyle
[in] Een logische OR-combinatie van besturingsstijlen.

nID
[in] De besturings-id van de statusbalk.

Retourwaarde

WAAR als de statusbalk is gemaakt, anders ONWAAR.

CMFCRibbonStatusBar::CreateEx

Hiermee maakt u een lintstatusbalk met een uitgebreide stijl.

BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwCtrlStyle=0,
    DWORD dwStyle=WS_CHILD|WS_VISIBLE|CBRS_BOTTOM,
    UINT nID=AFX_IDW_STATUS_BAR);

Parameterwaarden

pParentWnd
Een aanwijzer naar het bovenliggende venster.

dwCtrlStyle
Een logische OR-combinatie van extra stijlen voor het maken van het statusbalkobject.

dwStyle
De besturingsstijl van de statusbalk.

nID
De besturings-id van de statusbalk.

Retourwaarde

WAAR als de statusbalk is gemaakt, anders ONWAAR.

CMFCRibbonStatusBar::FindByID

Zie de broncode in de map VC\atlmfc\src\mfc van uw Visual Studio-installatie voor meer informatie.

CMFCRibbonBaseElement* FindByID(UINT uiCmdID, BOOL = TRUE);

Parameterwaarden

[in] uiCmdID
[in] BOOL

Retourwaarde

Opmerkingen

CMFCRibbonStatusBar::FindElement

Retourneert een aanwijzer naar het element met de opgegeven opdracht-id.

CMFCRibbonBaseElement* FindElement(UINT uiID);

Parameterwaarden

uiID
[in] De id van het element.

Retourwaarde

Een aanwijzer naar het element met de opgegeven opdracht-id. NULL als er geen dergelijk element is.

CMFCRibbonStatusBar::GetCount

Retourneert het aantal elementen dat zich in het hoofdgebied van de statusbalk van het lint bevindt.

int GetCount() const;

Retourwaarde

Het aantal elementen dat zich in het hoofdgebied van de statusbalk van het lint bevindt.

CMFCRibbonStatusBar::GetElement

Hiermee wordt een aanwijzer geretourneerd naar het element dat zich in een opgegeven index bevindt.

CMFCRibbonBaseElement* GetElement(int nIndex);

Parameterwaarden

nIndex
[in] Hiermee geeft u een op nul gebaseerde index op van een element dat zich in het hoofdgebied van het statusbalkbesturingselement bevindt.

Retourwaarde

Een aanwijzer naar het element dat zich in de opgegeven index bevindt. NULL als de index negatief is of het aantal elementen in de statusbalk overschrijdt.

Opmerkingen

CMFCRibbonStatusBar::GetExCount

Retourneert het aantal elementen dat zich in het uitgebreide gebied van de statusbalk van het lint bevindt.

int GetExCount() const;

Retourwaarde

Het aantal elementen dat zich in het uitgebreide gebied van de statusbalk van het lint bevindt.

CMFCRibbonStatusBar::GetExElement

Hiermee wordt een aanwijzer geretourneerd naar het element dat zich in een opgegeven index bevindt in het uitgebreide gebied van de statusbalk van het lint. Het uitgebreide gebied bevindt zich aan de rechterkant van het besturingselement voor de statusbalk.

CMFCRibbonBaseElement* GetExElement(int nIndex);

Parameterwaarden

nIndex
[in] Hiermee geeft u de op nul gebaseerde index op van een element dat zich in het uitgebreide gebied van het statusbalkbesturingselement bevindt.

Retourwaarde

Een aanwijzer naar het element dat zich in een opgegeven index bevindt in het uitgebreide gebied van de statusbalk van het lint. NULL als nIndex negatief is of het aantal elementen in het uitgebreide gebied van de lintstatusbalk overschrijdt.

Opmerkingen

CMFCRibbonStatusBar::GetExtendedArea

Zie de broncode in de map VC\atlmfc\src\mfc van uw Visual Studio-installatie voor meer informatie.

virtual BOOL GetExtendedArea(CRect& rect) const;

Parameterwaarden

[in] Rect

Retourwaarde

Opmerkingen

CMFCRibbonStatusBar::GetSpace

Zie de broncode in de map VC\atlmfc\src\mfc van uw Visual Studio-installatie voor meer informatie.

int GetSpace() const;

Retourwaarde

Opmerkingen

CMFCRibbonStatusBar::IsBottomFrame

Zie de broncode in de map VC\atlmfc\src\mfc van uw Visual Studio-installatie voor meer informatie.

BOOL IsBottomFrame() const;

Retourwaarde

Opmerkingen

CMFCRibbonStatusBar::IsExtendedElement

Zie de broncode in de map VC\atlmfc\src\mfc van uw Visual Studio-installatie voor meer informatie.

BOOL IsExtendedElement(CMFCRibbonBaseElement* pElement) const;

Parameterwaarden

[in] pElement

Retourwaarde

Opmerkingen

CMFCRibbonStatusBar::IsInformationMode

Bepaalt of de informatiemodus is ingeschakeld voor de statusbalk van het lint.

BOOL IsInformationMode() const;

Retourwaarde

WAAR als de statusbalk in de informatiemodus kan werken; anders ONWAAR.

Opmerkingen

In de informatiemodus verbergt de statusbalk alle normale deelvensters en wordt een berichttekenreeks weergegeven.

CMFCRibbonStatusBar::OnDrawInformation

Geeft de tekenreeks weer die wordt weergegeven op de statusbalk van het lint wanneer de informatiemodus is ingeschakeld.

virtual void OnDrawInformation(
    CDC* pDC,
    CString& strInfo,
    CRect rectInfo);

Parameterwaarden

Pdc
[in] Een aanwijzer naar een apparaatcontext.

strInfo
[in] De informatietekenreeks.

rectInfo
[in] De begrenzingsrechthoek.

Opmerkingen

Overschrijf deze methode in een afgeleide klasse als u het uiterlijk van de informatietekenreeks op de statusbalk wilt aanpassen. Gebruik de CMFCRibbonStatusBar::SetInformation-methode om de statusbalk in de informatiemodus te plaatsen. In deze modus verbergt de statusbalk alle deelvensters en wordt de informatietekenreeks weergegeven die is opgegeven door strInfo.

CMFCRibbonStatusBar::RecalcLayout

Zie de broncode in de map VC\atlmfc\src\mfc van uw Visual Studio-installatie voor meer informatie.

virtual void RecalcLayout();

Opmerkingen

CMFCRibbonStatusBar::RemoveAll

Hiermee verwijdert u alle elementen uit de statusbalk van het lint.

void RemoveAll();

CMFCRibbonStatusBar::RemoveElement

Hiermee verwijdert u het element met een opgegeven opdracht-id uit de statusbalk van het lint.

BOOL RemoveElement(UINT uiID);

Parameterwaarden

uiID
[in] De id van het element dat moet worden verwijderd uit de statusbalk.

Retourwaarde

WAAR als een element met de opgegeven uiID wordt verwijderd. ANDERS ONWAAR.

CMFCRibbonStatusBar::SetInformation

Hiermee schakelt u de informatiemodus voor de lintstatusbalk in of uit.

void SetInformation(LPCTSTR lpszInfo);

Parameterwaarden

lpszInfo
[in] De informatietekenreeks.

Opmerkingen

Gebruik deze methode om de statusbalk in de informatiemodus te plaatsen. In deze modus verbergt de statusbalk alle deelvensters en wordt de informatiereeks weergegeven die is opgegeven door lpszInfo.

Wanneer lpszInfo NULL is, wordt de statusbalk teruggezet naar de normale modus.

Zie ook

Hiërarchiegrafiek
Klassen
CMFCRibbonBar-klasse
Klasse CMFCRibbonBaseElement
CMFCRibbonBar-klasse