CMFCOutlookBar::CreateCustomPage

Creates a custom Outlook bar tab.

CMFCOutlookBarPane* CreateCustomPage(
   LPCTSTR lpszPageName,
   BOOL bActivatePage=TRUE,
   DWORD dwEnabledDocking=CBRS_ALIGN_ANY,
   BOOL bEnableTextLabels=TRUE 
);

Parameters

  • [in] lpszPageName
    The page label.

  • [in] bActivatePage
    If TRUE, the page becomes active upon creation.

  • [in] dwEnabledDocking
    A combination of CBRS_ALIGN_ flags that specifies the enabled docking sides when the page is detached.

  • [in] bEnableTextLabels
    If TRUE, the text labels are enabled for the buttons that reside on the page.

Return Value

A pointer to the newly created page, or NULL if the creation failed.

Remarks

Use this method to enable the users to create custom Outlook bar pages. You can create up to 100 pages per application. The page control IDs start from 0xF000. The creation fails if the total number of custom Outlook bar pages exceeds 100.

Use CMFCOutlookBar::RemoveCustomPage to delete custom pages.

Requirements

Header: afxoutlookbar.h

See Also

Reference

CMFCOutlookBar Class

Hierarchy Chart