Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of mappen te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen om mappen te wijzigen.
Opmerking
De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.
De CMFCStatusBar klasse implementeert een statusbalk die vergelijkbaar is met de CStatusBar klasse. De CMFCStatusBar klasse heeft echter functies die niet door de CStatusBar klasse worden aangeboden, zoals de mogelijkheid om afbeeldingen, animaties en voortgangsbalken weer te geven; en de mogelijkheid om te reageren op muisklikken.
Zie de broncode in de map VC\atlmfc\src\mfc van uw Visual Studio-installatie voor meer informatie.
Syntaxis
class CMFCStatusBar : public CPane
Leden
Openbare methoden
| Naam | Description |
|---|---|
| CMFCStatusBar::CalcFixedLayout | (Overschrijft CBasePane::CalcFixedLayout.) |
| CMFCStatusBar::CommandToIndex | |
| CMFCStatusBar::Create | Hiermee maakt u een besturingsbalk en koppelt u deze aan het CPane-object . (Overschrijft CPane::Maken.) |
| CMFCStatusBar::CreateEx | Hiermee maakt u een besturingsbalk en koppelt u deze aan het CPane-object . (Overschrijft CPane::CreateEx.) |
| CMFCStatusBar::D oesAllowDynInsertBefore | Bepaalt of een ander deelvenster dynamisch kan worden ingevoegd tussen dit deelvenster en het bovenliggende frame. (Overschrijft CBasePane::D oesAllowDynInsertBefore.) |
| CMFCStatusBar::EnablePaneDoubleClick | Hiermee schakelt u de verwerking van muisklikken op de statusbalk in of uit. |
| CMFCStatusBar::EnablePaneProgressBar | Geeft een voortgangsbalk weer in het opgegeven deelvenster. |
| CMFCStatusBar::GetCount | Retourneert het aantal deelvensters op de statusbalk. |
| CMFCStatusBar::GetDrawExtendedArea | |
| CMFCStatusBar::GetExtendedArea | |
| CMFCStatusBar::GetItemID | |
| CMFCStatusBar::GetItemRect | |
| CMFCStatusBar::GetPaneInfo | |
| CMFCStatusBar::GetPaneProgress | |
| CMFCStatusBar::GetPaneStyle | Retourneert de deelvensterstijl. (Overschrijft CBasePane::GetPaneStyle.) |
| CMFCStatusBar::GetPaneText | |
| CMFCStatusBar::GetPaneWidth | Retourneert de breedte, in pixels, van het opgegeven deelvenster van de statusbalk. |
| CMFCStatusBar::GetTipText | Retourneert de tekst van de knopinfo voor het opgegeven deelvenster van de statusbalk. |
| CMFCStatusBar::InvalidatePaneContent | Hiermee wordt het opgegeven deelvenster ongeldig en wordt de inhoud opnieuw getekend. |
| CMFCStatusBar::P reCreateWindow | Aangeroepen door het framework vóór het maken van het Windows-venster dat aan dit CWnd object is gekoppeld. (Overschrijft CWnd::P reCreateWindow.) |
| CMFCStatusBar::SetDrawExtendedArea | |
| CMFCStatusBar::SetIndicators | |
| CMFCStatusBar::SetPaneAnimation | Hiermee wijst u een animatie toe aan het opgegeven deelvenster. |
| CMFCStatusBar::SetPaneBackgroundColor | Hiermee stelt u de achtergrondkleur voor het opgegeven deelvenster van de statusbalk in. |
| CMFCStatusBar::SetPaneIcon | Hiermee stelt u het indicatorpictogram voor het opgegeven deelvenster van de statusbalk in. |
| CMFCStatusBar::SetPaneInfo | |
| CMFCStatusBar::SetPaneProgress | Hiermee stelt u de huidige voortgang van de voortgangsbalk voor het opgegeven deelvenster van de statusbalk in. |
| CMFCStatusBar::SetPaneStyle | Hiermee stelt u de stijl van het deelvenster in. (Hiermee wordt CBasePane::SetPaneStyle overschreven.) |
| CMFCStatusBar::SetPaneText | |
| CMFCStatusBar::SetPaneTextColor | Hiermee stelt u de tekstkleur in voor het opgegeven deelvenster van de statusbalk. |
| CMFCStatusBar::SetPaneWidth | Hiermee stelt u de breedte in pixels van het opgegeven deelvenster van de statusbalk in. |
| CMFCStatusBar::SetTipText | Hiermee stelt u de tekst van de knopinfo in voor het opgegeven deelvenster van de statusbalk. |
Beveiligde methoden
| Naam | Description |
|---|---|
| CMFCStatusBar::OnDrawPane | Aangeroepen door het framework wanneer het deelvenster van de statusbalk opnieuw wordt getekend. |
Opmerkingen
In het volgende diagram ziet u een afbeelding van de statusbalk uit de voorbeeldtoepassing Status Bar Demo .
Voorbeelden
In het volgende voorbeeld ziet u de lokale variabelen die door de toepassing worden gebruikt om verschillende methoden in de CMFCStatusBar klasse aan te roepen. Deze variabelen worden gedeclareerd in StatusBarDemoView.h. Het hoofdframe wordt gedeclareerd in MainFrm.h, het document wordt gedeclareerd in StatusBarDemoDoc.h en de weergave wordt gedeclareerd in StatusBarDemoView.h. Dit codefragment maakt deel uit van het voorbeeld van de statusbalkdemo.
int m_nProgressCurr;
BOOL m_bInProgress;
CImageList m_imlStatusAnimation;
BOOL m_bInAnimation;
CBitmap m_bmpIcon1;
CBitmap m_bmpIcon2;
In het volgende voorbeeld ziet u hoe u een verwijzing naar een object opzoekt door de GetStatusBar methode in MainFrm.h te CMFCStatusBar introduceren en deze methode vervolgens aan te roepen vanuit de GetStatusBar methode in StatusBarDemoView.h. Dit codefragment maakt deel uit van het voorbeeld van de statusbalkdemo.
// in MainFrm.h
public:
CMFCStatusBar &GetStatusBar()
{
return m_wndStatusBar;
}
// in StatusBarDemoView.h
CMFCStatusBar &GetStatusBar() const
{
return ((CMainFrame *)AfxGetMainWnd())->GetStatusBar();
}
In het volgende voorbeeld ziet u hoe u verschillende methoden aanroept in de CMFCStatusBar klasse in StatusBarDemoView.cpp. De constanten worden gedeclareerd in MainFrm.h. In het voorbeeld ziet u hoe u het pictogram instelt, de knopinfotekst van het statusbalkvenster instelt, een voortgangsbalk weergeeft in het opgegeven deelvenster, een animatie toewijst aan het opgegeven deelvenster, de tekst en de breedte van het deelvenster statusbalk instelt en de huidige voortgangsindicator van de voortgangsbalk voor het statusbalkvenster instelt. Dit codefragment maakt deel uit van het voorbeeld van de statusbalkdemo.
// 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);
Overnamehiërarchie
Requirements
Koptekst: afxstatusbar.h
CMFCStatusBar::CalcFixedLayout
virtual CSize CalcFixedLayout(
BOOL bStretch,
BOOL bHorz);
Parameterwaarden
[in] bStretch
[in] bHorz
Retourwaarde
Opmerkingen
CMFCStatusBar::CommandToIndex
int CommandToIndex(UINT nIDFind) const;
Parameterwaarden
[in] nIDFind
Retourwaarde
Opmerkingen
CMFCStatusBar::Create
BOOL Create(
CWnd* pParentWnd,
DWORD dwStyle = WS_CHILD | WS_VISIBLE | CBRS_BOTTOM,
UINT nID = AFX_IDW_STATUS_BAR);
Parameterwaarden
[in] pParentWnd
[in] dwStyle
[in] Nid
Retourwaarde
Opmerkingen
CMFCStatusBar::CreateEx
BOOL CreateEx(
CWnd* pParentWnd,
DWORD dwCtrlStyle = 0,
DWORD dwStyle = WS_CHILD | WS_VISIBLE | CBRS_BOTTOM,
UINT nID = AFX_IDW_STATUS_BAR);
Parameterwaarden
[in] pParentWnd
[in] dwCtrlStyle
[in] dwStyle
[in] Nid
Retourwaarde
Opmerkingen
CMFCStatusBar::D oesAllowDynInsertBefore
virtual BOOL DoesAllowDynInsertBefore() const;
Retourwaarde
Opmerkingen
CMFCStatusBar::EnablePaneDoubleClick
Hiermee schakelt u de verwerking van muisklikken op de statusbalk in of uit.
void EnablePaneDoubleClick(BOOL bEnable=TRUE);
Parameterwaarden
bEnable
[in] Als WAAR is, schakelt u de verwerking van de muis in. Schakel anders de verwerking van de muis uit.
Opmerkingen
Als de statusbalk is ingeschakeld om dubbelklikken te verwerken, verzendt Windows de WM_COMMAND melding samen met een resource-id naar de eigenaar van de statusbalk telkens wanneer de gebruiker dubbelklikt op het deelvenster statusbalk.
CMFCStatusBar::EnablePaneProgressBar
Een voortgangsbalk weergeven in het opgegeven deelvenster.
void EnablePaneProgressBar(
int nIndex,
long nTotal=100,
BOOL bDisplayText=FALSE,
COLORREF clrBar=-1,
COLORREF clrBarDest=-1,
COLORREF clrProgressText=-1);
Parameterwaarden
nIndex
[in] Hiermee geeft u de index van het deelvenster waarvan de voortgangsbalk moet worden ingeschakeld.
nTotaal
[in] Hiermee geeft u de maximumwaarde voor de voortgangsbalk.
bDisplayText
[in] Hiermee geeft u op of de voortgangsbalk de huidige voortgangswaarde moet weergeven.
clrBar
[in] Hiermee geeft u de achtergrondkleur van de voortgangsbalk.
clrBarDest
[in] Hiermee geeft u de secundaire kleur van de voortgangsbalkachtergrond op. Gebruik een andere waarde dan clrBar om een kleur op te vullen die is gemengd in een kleurovergang.
clrProgressText
[in] Hiermee geeft u de kleur van de tekst van de voortgangsbalk.
Opmerkingen
Als u de voortgangsbalkaanroep EnablePaneProgressBar wilt uitschakelen met nTotal ingesteld op -1. Standaard is nTotal ingesteld op 100. Daarom hebt u geen extra berekeningen nodig om de voortgang als percentage weer te geven.
U moet verschillende waarden doorgeven voor clrBar en clrBarDest , zodat in de achtergrondkleur van de voortgangsbalk een kleur wordt weergegeven die is gemengd in een kleurovergang. .
Als u de huidige voortgang wilt instellen, roept u de methode CMFCStatusBar::SetPaneProgress aan.
CMFCStatusBar::GetCount
Hiermee haalt u het aantal deelvensters op de statusbalk op.
int GetCount() const;
Retourwaarde
Het aantal deelvensters op de statusbalk.
CMFCStatusBar::GetDrawExtendedArea
BOOL GetDrawExtendedArea() const;
Retourwaarde
Opmerkingen
CMFCStatusBar::GetExtendedArea
virtual BOOL GetExtendedArea(CRect& rect) const;
Parameterwaarden
[in] Rect
Retourwaarde
Opmerkingen
CMFCStatusBar::GetItemID
UINT GetItemID(int nIndex) const;
Parameterwaarden
[in] nIndex
Retourwaarde
Opmerkingen
CMFCStatusBar::GetItemRect
void GetItemRect(
int nIndex,
LPRECT lpRect) const;
Parameterwaarden
[in] nIndex
[in] lpRect
Opmerkingen
CMFCStatusBar::GetPaneInfo
void GetPaneInfo(
int nIndex,
UINT& nID,
UINT& nStyle,
int& cxWidth) const;
Parameterwaarden
[in] nIndex
[in] Nid
[in] nStyle
[in] cxWidth
Opmerkingen
CMFCStatusBar::GetPaneProgress
long GetPaneProgress(int nIndex) const;
Parameterwaarden
[in] nIndex
Retourwaarde
Opmerkingen
CMFCStatusBar::GetPaneStyle
UINT GetPaneStyle(int nIndex) const;
Parameterwaarden
[in] nIndex
Retourwaarde
Opmerkingen
CMFCStatusBar::GetPaneText
void GetPaneText(
int nIndex,
CString& s) const;
CString GetPaneText(int nIndex) const;
Parameterwaarden
[in] nIndex
[in] S
Retourwaarde
Opmerkingen
CMFCStatusBar::GetPaneWidth
Hiermee wordt de breedte van het deelvenster van een statusbalk opgehaald.
int GetPaneWidth(int nIndex) const;
Parameterwaarden
nIndex
[in] Hiermee geeft u de index van het deelvenster statusbalk.
Retourwaarde
De breedte van het deelvenster statusbalk dat nIndex aangeeft; anders nul als er geen deelvenster met de statusbalk bestaat.
CMFCStatusBar::GetTipText
Haal de knopinfotekst van het deelvenster van een statusbalk op.
CString GetTipText(int nIndex) const;
Parameterwaarden
nIndex
[in] Hiermee geeft u de index van het deelvenster waarvoor knopinfotekst moet worden opgehaald.
Retourwaarde
De knopinfotekst van het deelvenster statusbalk dat nIndex opgeeft. Anders bestaat de lege tekenreeks als er geen statusbalkvenster bestaat voor de opgegeven nIndex of als de tekst van de knopinfo leeg is.
CMFCStatusBar::InvalidatePaneContent
Het statusbalkvenster ongeldig maken en de inhoud opnieuw tekenen.
void InvalidatePaneContent(int nIndex);
Parameterwaarden
nIndex
[in] Hiermee geeft u de index op van het deelvenster waarvan de inhoud ongeldig moet worden gemaakt en opnieuw moet worden getekend.
Opmerkingen
Wanneer de statusbalk ongeldig is, wordt deze gemarkeerd voor opnieuw tekenen. Windows tekent deze opnieuw wanneer de UpdateWindow methode een WM_PAINT bericht naar de OnPaint methode verzendt.
CMFCStatusBar::OnDrawPane
Het deelvenster van de statusbalk opnieuw tekenen.
virtual void OnDrawPane(
CDC* pDC,
CMFCStatusBarPaneInfo* pPane);
Parameterwaarden
Pdc
[in] Een aanwijzer naar een apparaatcontext voor tekenen.
pPane
[in] Een aanwijzer naar een CMFCStatusBarPaneInfo structuur die de informatie over het deelvenster bevat die opnieuw moet worden getekend.
Opmerkingen
OnDrawPane Standaard wordt het deelvenster opnieuw getekend met behulp van de pDC van de apparaatcontext op basis van de stijl en inhoud van het deelvenster.
Overschrijf deze methode in een CMFCStatusBar-afgeleide klasse om het uiterlijk van een deelvenster aan te passen.
CMFCStatusBar::P reCreateWindow
virtual BOOL PreCreateWindow(CREATESTRUCT& cs);
Parameterwaarden
[in] Cs
Retourwaarde
Opmerkingen
CMFCStatusBar::SetDrawExtendedArea
void SetDrawExtendedArea(BOOL bSet = TRUE);
Parameterwaarden
[in] bSet
Opmerkingen
CMFCStatusBar::SetIndicators
BOOL SetIndicators(
const UINT* lpIDArray,
int nIDCount);
Parameterwaarden
[in] lpIDArray
[in] nIDCount
Retourwaarde
Opmerkingen
CMFCStatusBar::SetPaneAnimation
Hiermee wijst u een animatie toe aan het opgegeven deelvenster.
void SetPaneAnimation(
int nIndex,
HIMAGELIST hImageList,
UINT nFrameRate=500,
BOOL bUpdate=TRUE);
Parameterwaarden
nIndex
[in] Hiermee geeft u de index op van het deelvenster waaraan u een animatie wilt toewijzen.
hImageList
[in] Hiermee geeft u een ingang op voor de lijst met afbeeldingen die de animatieframes bevat.
nFrameRate
[in] Hiermee geeft u de framesnelheid in milliseconden voor de animatie.
bUpdate
[in] Als WAAR is, werkt u de inhoud van het deelvenster onmiddellijk bij. Anders wordt de inhoud van het deelvenster bijgewerkt wanneer deze ongeldig is.
Opmerkingen
Als u de huidige animatie wilt uitschakelen, roept u de aanroep SetPaneAnimation in op hImageList NULL.
CMFCStatusBar::SetPaneBackgroundColor
Hiermee stelt u de achtergrondkleur van het deelvenster statusbalk in.
void SetPaneBackgroundColor(
int nIndex,
COLORREF clrBackground=(COLORREF)-1,
BOOL bUpdate=TRUE);
Parameterwaarden
nIndex
[in] Hiermee geeft u de index van het deelvenster waarvoor een nieuwe achtergrondkleur moet worden ingesteld.
clrBackground
[in] Hiermee geeft u de nieuwe achtergrondkleur.
bUpdate
[in] Als WAAR is, werkt u de inhoud van het deelvenster onmiddellijk bij. Werk anders de inhoud van het deelvenster pas bij als het deelvenster ongeldig is door een andere methode.
CMFCStatusBar::SetPaneIcon
Stel het pictogram van het deelvenster statusbalk in.
void SetPaneIcon(
int nIndex,
HICON hIcon,
BOOL bUpdate=TRUE);
void SetPaneIcon(
int nIndex,
HBITMAP hBmp,
COLORREF clrTransparent=RGB(255, 0, 255),
BOOL bUpdate=TRUE);
Parameterwaarden
nIndex
[in] Hiermee geeft u de index van het deelvenster waarvoor de afbeelding moet worden ingesteld.
hIcon
[in] Hiermee geeft u een ingang voor het pictogram dat moet worden ingesteld als de deelvensterafbeelding.
bUpdate
[in] Hiermee geeft u op of de inhoud van het deelvenster onmiddellijk moet worden bijgewerkt.
hBmp
[in] Hiermee geeft u een greep voor de bitmap die moet worden ingesteld als de deelvensterafbeelding.
clrTransparent
[in] Hiermee geeft u de transparante kleur van de bitmap die de hBmp aangeeft.
Opmerkingen
U kunt HICON of HBITMAP doorgeven samen met de transparante kleur om de afbeelding van het deelvenster in te stellen. Als u de afbeelding niet meer wilt weergeven, geeft u de NULL-waarde door als de afbeeldingsgreep.
Als er actieve animaties zijn die CMFCStatusBar::SetPaneAnimation heeft ingesteld, wordt de animatie gestopt.
CMFCStatusBar::SetPaneInfo
void SetPaneInfo(
int nIndex,
UINT nID,
UINT nStyle,
int cxWidth);
Parameterwaarden
[in] nIndex
[in] Nid
[in] nStyle
[in] cxWidth
Opmerkingen
CMFCStatusBar::SetPaneProgress
Stel de huidige voortgangsindicator in van de voortgangsbalk voor het opgegeven deelvenster.
void SetPaneProgress(
int nIndex,
long nCurr,
BOOL bUpdate=TRUE);
Parameterwaarden
nIndex
[in] Hiermee geeft u de index van het deelvenster waarvoor de voortgangsindicator moet worden bijgewerkt.
nCurr
[in] Hiermee geeft u de huidige waarde van de voortgangsindicator.
bUpdate
[in] Hiermee geeft u op of het deelvenster onmiddellijk moet worden bijgewerkt.
Opmerkingen
Roep deze methode aan wanneer u de voortgangsindicator voor de voortgangsbalk in het opgegeven deelvenster wilt bijwerken.
Als u deze functie wilt gebruiken voor het opgegeven deelvenster, moet u eerst CMFCStatusBar::EnablePaneProgressBar aanroepen.
CMFCStatusBar::SetPaneStyle
void SetPaneStyle(
int nIndex,
UINT nStyle);
Parameterwaarden
[in] nIndex
[in] nStyle
Opmerkingen
CMFCStatusBar::SetPaneText
virtual BOOL SetPaneText(
int nIndex,
LPCTSTR lpszNewText,
BOOL bUpdate = TRUE);
Parameterwaarden
[in] nIndex
[in] lpszNewText
[in] bUpdate
Retourwaarde
Opmerkingen
CMFCStatusBar::SetPaneTextColor
Hiermee stelt u de tekstkleur van het opgegeven deelvenster in.
void SetPaneTextColor(
int nIndex,
COLORREF clrText=(COLORREF)-1,
BOOL bUpdate=TRUE);
Parameterwaarden
nIndex
[in] Hiermee geeft u de index van het deelvenster waaraan u een nieuwe tekstkleur wilt toewijzen.
clrText
[in] Hiermee geeft u de tekstkleur op.
bUpdate
[in] Als WAAR is, werkt u de inhoud van het deelvenster onmiddellijk bij. Werk anders de inhoud van het deelvenster pas bij als het deelvenster ongeldig is door een andere methode.
CMFCStatusBar::SetPaneWidth
Stel de breedte van het deelvenster van de statusbalk in.
void SetPaneWidth(
int nIndex,
int cx);
Parameterwaarden
nIndex
[in] De index van het deelvenster statusbalk waarvoor een nieuwe breedte moet worden ingesteld.
Cx
[in] De nieuwe breedte van het deelvenster statusbalk, in pixels.
CMFCStatusBar::SetTipText
Stel de knopinfotekst van een statusbalkvenster in.
void SetTipText(
int nIndex,
LPCTSTR pszTipText);
Parameterwaarden
nIndex
[in] De index van het deelvenster waaraan u de knopinfotekst wilt toewijzen.
pszTipText
[in] De nieuwe tekst voor knopinfo.