Contains a pointer to the application supplied background handling callback for the tab page.

C++

SFTTABS_DRAWBACKGROUNDPROC CSftTabsPage::m_lpfnDrawBackground;

Comments

The m_lpfnDrawBackground member contains a pointer to the application supplied background handling callback for the tab page.

m_lpfnDrawBackground is used to define the application supplied background handling callback for the tab page.

An application can define a background color for a tab page using the SFTTABS_TAB, colorClientArea member (see SetTabInfo) or define a background bitmap using the SFTTABS_CONTROL, hInsideBitmap member (see SetControlInfo). m_lpfnDrawBackground overrides other background definitions and allows an application to render the background.

CSftTabsPage::m_flagDrawBackground can be used to define additional processing options. CSftTabsPage::m_UserDataBackground is used to define an application defined value that is passed to the background drawing callback m_lpfnDrawBackground as the UserData parameter.

When using C, the SftTabs_TransparentControls function handles background painting.

Windows Mobile Edition: m_lpfnDrawBackground is not supported.

Example

This example paints a custom tab page background by filling the tab page with a tiled bitmap.

C++

CSamplePage::CSamplePage(CWnd* pParent /*=NULL*/) : CSftTabsPage(CSamplePage::IDD, pParent)
{
    m_lpfnDrawBackground = SamplePage_DrawBackground;
    m_flagDrawBackground = SFTTABS_DRAWBG_OVERRIDETHEME;
    m_UserDataBackground = (SFTTABS_DWORD_PTR)this;
    m_BackgroundBitmap.LoadBitmap(IDB_BACKGROUND);
}
void CALLBACK SamplePage_DrawBackground(HDC hDC, HWND hwndDlg, HWND hwndTab, SFTTABS_DWORD_PTR UserData)
{
    CSamplePage* pThis = (CSamplePage*)UserData;
    RECT rect;
    GetClientRect(hwndDlg, &rect);
    SftTabs_PaintTiledBitmap(hDC, pThis->m_BackgroundBitmap, 0, 0, &rect);
}

See Also  C/C++ API  |  C++ Classes  |  Notifications