Klasse CMFCOutlookBarPane

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

Een besturingselement dat is afgeleid van DE KLASSE CMFCToolBar die kan worden ingevoegd in een Outlook-balk ( CMFCOutlookBar Class). Het deelvenster Outlook-balk bevat een kolom met grote knoppen. De gebruiker kan omhoog en omlaag schuiven in de lijst met knoppen als deze groter is dan het deelvenster. Wanneer de gebruiker een Outlook-balkvenster loskoppelt van de Outlook-balk, kan het zweven of vastmaken in het hoofdframevenster.

Syntaxis

class CMFCOutlookBarPane : public CMFCToolBar

Leden

Openbare constructors

Openbare methoden

Beveiligde methoden

Opmerkingen

Zie CMFCOutlookBar Class voor informatie over het implementeren van een Outlook-balk.

Zie het OutlookDemo-voorbeeldproject voor een voorbeeld van een Outlook-balk.

Example

In het volgende voorbeeld ziet u hoe u verschillende methoden van de CMFCOutlookBarPane klasse gebruikt. In het voorbeeld ziet u hoe u een Outlook-balkvenster maakt, de pagina scrollmodus inschakelt, docking inschakelt en de achtergrondkleur van de Outlook-balk instelt. Dit codefragment maakt deel uit van het outlook-voorbeeld met meerdere weergaven.

CMFCOutlookBarPane m_wndShortcutsPane1;

CImageList images;
images.Create(IDB_SHORTCUTS, 32, 0, RGB(255, 0, 255));

// Create first page:
m_wndShortcutsPane1.Create(&m_wndShortcutsBar, AFX_DEFAULT_TOOLBAR_STYLE, ID_SHORTCUTS_PANE_1);
// The this pointer points to a CMainFrame class which extends the CFrameWnd class
m_wndShortcutsPane1.SetOwner(this);
m_wndShortcutsPane1.EnableTextLabels();
m_wndShortcutsPane1.EnableDocking(CBRS_ALIGN_ANY);
m_wndShortcutsPane1.EnablePageScrollMode();
m_wndShortcutsPane1.SetBackColor(RGB(0, 255, 0));

m_wndShortcutsPane1.AddButton(images.ExtractIcon(0), _T("View 1"), ID_SHORTCUT_1);
m_wndShortcutsPane1.AddButton(images.ExtractIcon(1), _T("View 2"), ID_SHORTCUT_2);
m_wndShortcutsPane1.AddButton(images.ExtractIcon(2), _T("View 3"), ID_SHORTCUT_3);
m_wndShortcutsPane1.AddButton(images.ExtractIcon(3), _T("View 4"), ID_SHORTCUT_4);

Overnamehiërarchie

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCBaseToolBar

CMFCToolBar

CMFCOutlookBarPane

Requirements

Koptekst: afxoutlookbarpane.h

CMFCOutlookBarPane::AddButton

Hiermee voegt u een knop toe aan het deelvenster van de Outlook-balk.

BOOL AddButton(
    UINT uiImage,
    LPCTSTR lpszLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    UINT uiImage,
    UINT uiLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    LPCTSTR szBmpFileName,
    LPCTSTR szLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    HBITMAP hBmp,
    LPCTSTR lpszLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    HICON hIcon,
    LPCTSTR lpszLabel,
    UINT iIdCommand,
    int iInsertAt=-1,
    BOOL bAlphaBlend=FALSE);

Parameterwaarden

uiImage
[in] Hiermee geeft u de resource-id van een bitmap.

lpszLabel
[in] Hiermee geeft u de tekst van de knop op.

iIdCommand
[in] Hiermee geeft u de id van het knop besturingselement.

iInsertAt
[in] Hiermee geeft u de index op basis van nul op de pagina van de Outlook-balk waarop de knop moet worden ingevoegd.

uiLabel
[in] Een tekenreeksresource-id.

szBmpFileName
[in] Hiermee geeft u de naam van het schijfinstallatiekopieënbestand dat moet worden geladen.

szLabel
[in] Hiermee geeft u de tekst van de knop op.

hBmp
[in] Een greep naar de bitmap van een knop.

hIcon
[in] Een greep naar het pictogram van een knoppen.

Retourwaarde

WAAR als een knop is toegevoegd; anders ONWAAR.

Opmerkingen

Gebruik deze methode om een nieuwe knop in te voegen op de pagina van een Outlook-balk. De installatiekopieën van de knop kunnen worden geladen vanuit de toepassingsbronnen of vanuit een schijfbestand.

Als de pagina-id die is opgegeven door uiPageID -1 is, wordt de knop ingevoegd op de eerste pagina.

Als de index die is opgegeven door iInsertAt -1 is, wordt de knop toegevoegd aan het einde van de pagina.

CMFCOutlookBarPane::CanBeAttached

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

virtual BOOL CanBeAttached() const;

Retourwaarde

Opmerkingen

CMFCOutlookBarPane::ClearAll

Hiermee worden de resources die door de afbeeldingen in het deelvenster van de Outlook-balk worden gebruikt, vrijgemaakt.

void ClearAll();

Opmerkingen

Deze methode roept RECHTSTREEKS CMFCToolBarImages::Clear aan, die wordt aangeroepen op de afbeeldingen die worden gebruikt door het outlookbalkvenster.

CMFCOutlookBarPane::Create

Hiermee maakt u het deelvenster Outlook-balk.

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
    UINT uiID=(UINT)-1,
    DWORD dwControlBarStyle=0);

Parameterwaarden

pParentWnd
[in] Hiermee geeft u het bovenliggende venster van het deelvenster Outlook-balk. Mag niet NULL zijn.

dwStyle
[in] De vensterstijl. Zie Vensterstijlen voor een lijst met vensterstijlen.

uiID
[in] De besturingselement-id. Moet uniek zijn om het opslaan van de status van het besturingselement mogelijk te maken.

dwControlBarStyle
[in] Hiermee geeft u speciale stijlen op waarmee het gedrag van het deelvenster Outlook-balk wordt gedefinieerd wanneer deze wordt losgekoppeld van de Outlook-balk.

Retourwaarde

WAAR als de methode is geslaagd; anders ONWAAR.

Opmerkingen

Als u een CMFCOutlookBarPane object wilt maken, roept u eerst de constructor aan en roept Createu vervolgens het besturingselement van het Outlook-balkvenster aan en koppelt u het aan het CMFCOutlookBarPane object.

Zie CBasePane::CreateEx voor meer informatiedwControlBarStyle.

CMFCOutlookBarPane::EnableContextMenuItems

Hiermee geeft u op welke snelmenu-items worden weergegeven in de aanpassingsmodus.

virtual BOOL EnableContextMenuItems(
    CMFCToolBarButton* pButton,
    CMenu* pPopup);

Parameterwaarden

pButton
[in] Een aanwijzer naar een werkbalkknop waarop een gebruiker heeft geklikt.

pPopup
[in] Een aanwijzer naar het snelmenu.

Retourwaarde

Retourneert TRUE als het snelmenu moet worden weergegeven; anders ONWAAR.

Opmerkingen

Overschrijf deze methode om het standaardsnelmenu van het framework te wijzigen dat het framework weergeeft in de aanpassingsmodus.

De standaardimplementatie controleert de aanpassingsmodus ( CMFCToolBar::IsCustomizeMode) en als deze is ingesteld op TRUE, schakelt u alle snelmenu-items uit, behalve Verwijderen. Vervolgens worden de invoerparameters doorgegeven aan CMFCToolBar::EnableContextMenuItems.

CMFCOutlookBarPane::EnablePageScrollMode

Hiermee geeft u op of de schuifpijlen in het deelvenster van de Outlook-balk de lijst met knoppen per pagina of knop op knop doorschakelen.

void EnablePageScrollMode(BOOL bPageScroll=TRUE);

Parameterwaarden

bPageScroll
[in] Als WAAR is, schakelt u de pagina scrollmodus in. Als ONWAAR is, schakelt u de paginaschuifmodus uit.

CMFCOutlookBarPane::GetRegularColor

Retourneert de normale tekstkleur (dat wil gezegd, niet-geselecteerd) van het outlook-balkvenster.

DECLARE_MESSAGE_MAPCOLORREF GetRegularColor() const;

Retourwaarde

De huidige tekstkleur als een RGB-kleurwaarde.

Opmerkingen

Gebruik CMFCOutlookBarPane::SetTextColor om de huidige tekstkleur (normaal en geselecteerd) van de Outlook-balk in te stellen. U kunt de standaardtekstkleur verkrijgen door de functie GetSysColor aan te roepen met de COLOR_WINDOW index.

CMFCOutlookBarPane::IsBackgroundTexture

Bepaalt of er een achtergrondafbeelding is geladen voor het outlook-balkvenster.

BOOL IsBackgroundTexture() const;

Retourwaarde

WAAR als er achtergrondafbeelding moet worden weergegeven; anders ONWAAR.

Opmerkingen

U kunt een achtergrondafbeelding toevoegen door de functie CMFCOutlookBarPane::SetBackImage aan te roepen.

Als er geen achtergrondafbeelding is, wordt de achtergrond geschilderd met een kleur die is opgegeven met behulp van CMFCOutlookBarPane::SetBackColor.

CMFCOutlookBarPane::IsDrawShadedHighlight

Bepaalt of de knoprand gearceerd is wanneer een knop is gemarkeerd en een achtergrondafbeelding wordt weergegeven.

BOOL IsDrawShadedHighlight() const;

Retourwaarde

WAAR als de randen van de knop gearceerd zijn; anders ONWAAR.

CMFCOutlookBarPane::RemoveAllButtons

Hiermee verwijdert u alle knoppen uit het deelvenster van de Outlook-balk.

virtual void RemoveAllButtons();

CMFCOutlookBarPane::RemoveButton

Hiermee verwijdert u de knop met een opgegeven opdracht-id.

BOOL RemoveButton(UINT iIdCommand);

Parameterwaarden

iIdCommand
[in] Hiermee geeft u de opdracht-id van een knop te verwijderen.

Retourwaarde

WAAR als de knop is verwijderd; FALSE als de opgegeven opdracht-id ongeldig is.

CMFCOutlookBarPane::SetBackColor

Hiermee stelt u de achtergrondkleur van de Outlook-balk in.

void SetBackColor(COLORREF color);

Parameterwaarden

kleur
[in] Hiermee geeft u de nieuwe achtergrondkleur.

Opmerkingen

Roep deze functie aan om de huidige achtergrondkleur voor de Outlook-balk in te stellen. De achtergrondkleur wordt alleen gebruikt als er geen achtergrondafbeelding is.

CMFCOutlookBarPane::SetBackImage

Hiermee stelt u de achtergrondafbeelding in.

void SetBackImage(UINT uiImageID);

Parameterwaarden

uiImageID
[in] Hiermee geeft u de resource-id van de installatiekopieën op.

Opmerkingen

Roep deze methode aan om de achtergrondafbeelding van de Outlook-balk in te stellen. De lijst met achtergrondafbeeldingen wordt beheerd door het ingesloten CMFCToolBarImages Class-object .

CMFCOutlookBarPane::SetDefaultState

Hiermee stelt u het outlook-balkvenster opnieuw in op de oorspronkelijke set knoppen.

void SetDefaultState();

Opmerkingen

Met deze methode worden de Outlook-balkknoppen teruggezet naar de oorspronkelijke set. Deze methode is als CMFCOutlookBarPane::RestoreOriginalstatevolgt, behalve dat er geen hertekening van het Outlook-balkvenster wordt geactiveerd.

CMFCOutlookBarPane::SetExtraSpace

Hiermee stelt u het aantal pixels van opvulling in dat wordt gebruikt rond knoppen in het deelvenster van de Outlook-balk.

void SetExtraSpace()

CMFCOutlookBarPane::SetTextColor

Hiermee stelt u de kleuren van normale en gemarkeerde tekst in het outlook-balkvenster in.

void SetTextColor(
    COLORREF clrRegText,
    COLORREF clrSelText=0);

Parameterwaarden

clrRegText
[in] Hiermee geeft u de nieuwe kleur voor niet-geselecteerde tekst.

clrSelText
[in] Hiermee geeft u de nieuwe kleur voor geselecteerde tekst.

CMFCOutlookBarPane::SetTransparentColor

Hiermee stelt u de transparante kleur in voor het deelvenster van de Outlook-balk.

void SetTransparentColor(COLORREF color);

Parameterwaarden

kleur
Hiermee geeft u de nieuwe transparante kleur.

Opmerkingen

De transparante kleur is vereist om transparante afbeeldingen weer te geven. Elk exemplaar van deze kleur in een afbeelding wordt in plaats daarvan geschilderd met de achtergrondkleur. Er is geen combinatie van achtergrond- en voorgrondafbeeldingen.

Zie ook

Hiërarchiegrafiek
Klassen
CMFCToolBar-klasse
KLASSE CMFCOutlookBar
CMFCOutlookBarTabCtrl-klasse