HeaderPane
Main
Hide

SftTabs/DLL 7.0 Documentation

Share Link
Print

m_flagDrawBackground

Defines background handling for the tab page.

C++

DWORD CSftTabsPage::m_flagDrawBackground;

Comments

The m_flagDrawBackground member defines background handling for the tab page.

m_flagDrawBackground defines background handling for the tab page, using one of the following values:

0CSftTabsPage::m_lpfnDrawBackground is ignored if Windows themes are active.
SFTTABS_DRAWBG_OVERRIDETHEMECSftTabsPage::m_lpfnDrawBackground is always honored, even if Windows themes are active.

When using C, the SftTabs_TransparentControls function handles background painting.

Backgrounds require Common Controls version 6. Background colors based on SFTTABS_TAB, colorClientArea are supported in all environments.

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


Last Updated 03/27/2026 - (email)
© 2026 Softel vdm, Inc.