#include <traydeskbtn.h>

Inheritance diagram for CTrayShowDesktopButton:

Collaboration diagram for CTrayShowDesktopButton:

[legend]

Public Member Functions
	CTrayShowDesktopButton ()

INT	WidthOrHeight () const

HRESULT	DoCreate (HWND hwndParent)

VOID	Click ()

BOOL	PtInButton (LPPOINT pt) const

VOID	StartHovering ()

LRESULT	OnLButtonUp (UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL &bHandled)

LRESULT	OnLButtonDown (UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL &bHandled)

Public Attributes
BOOL	m_bPressed

BOOL	m_bHorizontal

Private Member Functions
VOID	OnDraw (HDC hdc, LPRECT prc)

LRESULT	OnClick (UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL &bHandled)

LRESULT	OnSettingChanged (UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL &bHandled)

LRESULT	OnThemeChanged (UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL &bHandled)

LRESULT	OnWindowPosChanged (UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL &bHandled)

VOID	EnsureWindowTheme (BOOL setTheme)

LRESULT	OnPaint (UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL &bHandled)

LRESULT	OnPrintClient (UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL &bHandled)

LRESULT	OnMouseMove (UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL &bHandled)

LRESULT	OnTimer (UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL &bHandled)

LRESULT	OnDestroy (UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL &bHandled)

Private Attributes
LONG	m_nClickedTime

HTHEME	m_hTheme

HTHEME	m_hFallbackTheme

MARGINS	m_ContentMargins

SIZE	m_inset

HICON	m_icon

SIZE	m_szIcon

BOOL	m_highContrastMode

BOOL	m_drawWithDedicatedBackground

BOOL	m_bHovering

HWND	m_hWndTaskbar

Detailed Description

Definition at line 17 of file traydeskbtn.h.

Constructor & Destructor Documentation

◆ CTrayShowDesktopButton()

CTrayShowDesktopButton::CTrayShowDesktopButton ( )

Definition at line 20 of file traydeskbtn.cpp.

                                               :
    m_nClickedTime(0),
    m_inset({2, 2}),
    m_icon(NULL),
    m_highContrastMode(FALSE),
    m_drawWithDedicatedBackground(FALSE),
    m_bHovering(FALSE),
    m_hWndTaskbar(NULL),
    m_bPressed(FALSE),
    m_bHorizontal(FALSE)
{
}

Member Function Documentation

◆ Click()

VOID CTrayShowDesktopButton::Click ( )

Definition at line 106 of file traydeskbtn.cpp.

{
    // The actual action can be delayed as an expected behaviour.
    m_nClickedTime = ::GetMessageTime();
    PostMessage(TSDB_CLICK, 0, 0);
}

Referenced by OnLButtonUp(), and CTrayWindow::OnNcLButtonUp().

◆ DoCreate()

HRESULT CTrayShowDesktopButton::DoCreate ( HWND hwndParent )

Definition at line 62 of file traydeskbtn.cpp.

{
    const DWORD style = WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS | BS_DEFPUSHBUTTON;
    Create(hwndParent, NULL, NULL, style);
 
    if (!m_hWnd)
        return E_FAIL;
 
    // Get desktop icon
    bool bIconRetrievalFailed = ExtractIconExW(L"imageres.dll", -IDI_IMAGERES_DESKTOP, NULL, &m_icon, 1) == UINT_MAX;
    if (bIconRetrievalFailed || !m_icon)
        ExtractIconExW(L"shell32.dll", -IDI_SHELL32_DESKTOP, NULL, &m_icon, 1);
 
    // Get appropriate size at which to display desktop icon
    m_szIcon.cx = GetSystemMetrics(SM_CXSMICON);
    m_szIcon.cy = GetSystemMetrics(SM_CYSMICON);
 
    // Prep visual style
    EnsureWindowTheme(TRUE);
 
    // Get HWND of Taskbar
    m_hWndTaskbar = ::GetParent(hwndParent);
    if (!::IsWindow(m_hWndTaskbar))
        return E_FAIL;
 
    return S_OK;
}

Referenced by CTrayNotifyWnd::OnCreate().

◆ EnsureWindowTheme()

VOID CTrayShowDesktopButton::EnsureWindowTheme ( BOOL setTheme )

private

Definition at line 171 of file traydeskbtn.cpp.

{
    if (setTheme)
        SetWindowTheme(m_hWnd, m_bHorizontal ? L"ShowDesktop" : L"VerticalShowDesktop", NULL);
 
    if (::IsWindow(m_hWndTaskbar))
    {
        m_hFallbackTheme = ::OpenThemeData(m_hWndTaskbar, L"Toolbar");
        GetThemeMargins(m_hFallbackTheme, NULL, TP_BUTTON, 0, TMT_CONTENTMARGINS, NULL, &m_ContentMargins);
    }
    else
    {
        m_hFallbackTheme = NULL;
    }
 
    MARGINS contentMargins;
    if (GetThemeMargins(GetWindowTheme(GetParent().m_hWnd), NULL, TNP_BACKGROUND, 0, TMT_CONTENTMARGINS, NULL, &contentMargins) == S_OK)
    {
        m_inset.cx = max(0, contentMargins.cxRightWidth - 5);
        m_inset.cy = max(0, contentMargins.cyBottomHeight - 5);
    }
    else
    {
        m_inset.cx = 2;
        m_inset.cy = 2;
    }
 
    m_drawWithDedicatedBackground = FALSE;
    if (IsThemeActive())
    {
        m_hTheme = OpenThemeData(m_hWnd, L"Button");
        if (m_hTheme != NULL)
            m_drawWithDedicatedBackground = !IsThemePartDefined(m_hTheme, BP_PUSHBUTTON, 0);
    }
}

Referenced by DoCreate(), OnSettingChanged(), OnThemeChanged(), and OnWindowPosChanged().

◆ OnClick()

LRESULT CTrayShowDesktopButton::OnClick	(	UINT	uMsg,
		WPARAM	wParam,
		LPARAM	lParam,
		BOOL &	bHandled
	)

private

Definition at line 90 of file traydeskbtn.cpp.

{
    // The actual action can be delayed as an expected behaviour.
    // But a too late action is an unexpected behaviour.
    LONG nTime0 = m_nClickedTime;
    LONG nTime1 = ::GetMessageTime();
    if (nTime1 - nTime0 >= 600) // Ignore after 0.6 sec
        return 0;
 
    // Show/Hide Desktop
    ::SendMessage(m_hWndTaskbar, WM_COMMAND, TRAYCMD_TOGGLE_DESKTOP, 0);
 
    return 0;
}

◆ OnDestroy()

LRESULT CTrayShowDesktopButton::OnDestroy	(	UINT	uMsg,
		WPARAM	wParam,
		LPARAM	lParam,
		BOOL &	bHandled
	)

private

Definition at line 287 of file traydeskbtn.cpp.

{
    if (m_hTheme)
    {
        ::CloseThemeData(m_hTheme);
        m_hTheme = NULL;
    }
    if (m_hFallbackTheme)
    {
        ::CloseThemeData(m_hFallbackTheme);
        m_hFallbackTheme = NULL;
    }
 
    return 0;
}

◆ OnDraw()

VOID CTrayShowDesktopButton::OnDraw	(	HDC	hdc,
		LPRECT	prc
	)

private

Definition at line 303 of file traydeskbtn.cpp.

{
    RECT rc = { prc->left, prc->top, prc->right, prc->bottom };
    LPRECT lpRc = &rc;
    HBRUSH hbrBackground = NULL;
 
    if (m_hTheme)
    {
        HTHEME theme;
        int part = 0;
        int state = 0;
        if (m_drawWithDedicatedBackground)
        {
            theme = m_hTheme;
 
            if (m_bPressed)
                state = PBS_PRESSED;
            else if (m_bHovering)
                state = PBS_HOT;
            else
                state = PBS_NORMAL;
        }
        else
        {
            part = TP_BUTTON;
            theme = m_hFallbackTheme;
 
            if (m_bPressed)
                state = TS_PRESSED;
            else if (m_bHovering)
                state = TS_HOT;
            else
                state = TS_NORMAL;
 
            if (m_bHorizontal)
                rc.right -= m_inset.cx;
            else
                rc.bottom -= m_inset.cy;
        }
 
        if (::IsThemeBackgroundPartiallyTransparent(theme, part, state))
            ::DrawThemeParentBackground(m_hWnd, hdc, NULL);
 
        ::DrawThemeBackground(theme, hdc, part, state, lpRc, lpRc);
    }
    else
    {
        hbrBackground = ::GetSysColorBrush(COLOR_3DFACE);
        ::FillRect(hdc, lpRc, hbrBackground);
 
        if (m_bPressed || m_bHovering)
        {
            UINT edge = m_bPressed ? BDR_SUNKENOUTER : BDR_RAISEDINNER;
            DrawEdge(hdc, lpRc, edge, BF_RECT);
        }
    }
 
    if (m_highContrastMode || !m_drawWithDedicatedBackground)
    {
        /* Prepare to draw icon */
 
        // Determine X-position of icon's top-left corner
        int iconX = rc.left;
        iconX += (rc.right - iconX) / 2;
        iconX -= m_szIcon.cx / 2;
 
        // Determine Y-position of icon's top-left corner
        int iconY = rc.top;
        iconY += (rc.bottom - iconY) / 2;
        iconY -= m_szIcon.cy / 2;
 
        // Ok now actually draw the icon itself
        if (m_icon)
        {
            DrawIconEx(hdc, iconX, iconY,
                       m_icon, 0, 0,
                       0, hbrBackground, DI_NORMAL);
        }
    }
}

Referenced by OnPaint(), and OnPrintClient().

◆ OnLButtonDown()

LRESULT CTrayShowDesktopButton::OnLButtonDown	(	UINT	uMsg,
		WPARAM	wParam,
		LPARAM	lParam,
		BOOL &	bHandled
	)

Definition at line 126 of file traydeskbtn.cpp.

{
    m_bPressed = TRUE;
    SetCapture();
    Invalidate(TRUE);
    return 0;
}

Referenced by CTrayWindow::OnNcLButtonDown().

◆ OnLButtonUp()

LRESULT CTrayShowDesktopButton::OnLButtonUp	(	UINT	uMsg,
		WPARAM	wParam,
		LPARAM	lParam,
		BOOL &	bHandled
	)

Definition at line 113 of file traydeskbtn.cpp.

{
    m_bPressed = FALSE;
    ReleaseCapture();
    Invalidate(TRUE);
 
    POINT pt;
    ::GetCursorPos(&pt);
    if (PtInButton(&pt))
        Click(); // Left-click
    return 0;
}

Referenced by CTrayWindow::OnLButtonUp(), and CTrayWindow::OnNcLButtonUp().

◆ OnMouseMove()

LRESULT CTrayShowDesktopButton::OnMouseMove	(	UINT	uMsg,
		WPARAM	wParam,
		LPARAM	lParam,
		BOOL &	bHandled
	)

private

Definition at line 262 of file traydeskbtn.cpp.

{
    StartHovering();
    return 0;
}

◆ OnPaint()

LRESULT CTrayShowDesktopButton::OnPaint	(	UINT	uMsg,
		WPARAM	wParam,
		LPARAM	lParam,
		BOOL &	bHandled
	)

private

Definition at line 207 of file traydeskbtn.cpp.

{
    RECT rc;
    GetClientRect(&rc);
 
    PAINTSTRUCT ps;
    HDC hdc = BeginPaint(&ps);
    OnDraw(hdc, &rc);
    EndPaint(&ps);
 
    return 0;
}

◆ OnPrintClient()

LRESULT CTrayShowDesktopButton::OnPrintClient	(	UINT	uMsg,
		WPARAM	wParam,
		LPARAM	lParam,
		BOOL &	bHandled
	)

private

Definition at line 220 of file traydeskbtn.cpp.

{
    if ((lParam & PRF_CHECKVISIBLE) && !IsWindowVisible())
        return 0;
 
    RECT rc;
    GetClientRect(&rc);
 
    HDC hdc = (HDC)wParam;
    OnDraw(hdc, &rc);
 
    return 0;
}

◆ OnSettingChanged()

LRESULT CTrayShowDesktopButton::OnSettingChanged	(	UINT	uMsg,
		WPARAM	wParam,
		LPARAM	lParam,
		BOOL &	bHandled
	)

private

Definition at line 134 of file traydeskbtn.cpp.

{
    LRESULT ret = OnThemeChanged(uMsg, wParam, lParam, bHandled);
    EnsureWindowTheme(TRUE);
    return ret;
}

◆ OnThemeChanged()

LRESULT CTrayShowDesktopButton::OnThemeChanged	(	UINT	uMsg,
		WPARAM	wParam,
		LPARAM	lParam,
		BOOL &	bHandled
	)

private

Definition at line 141 of file traydeskbtn.cpp.

{
    HIGHCONTRAST hcInfo;
    hcInfo.cbSize = sizeof(hcInfo);
    if (SystemParametersInfo(SPI_GETHIGHCONTRAST, sizeof(hcInfo), &hcInfo, FALSE))
        m_highContrastMode = (hcInfo.dwFlags & HCF_HIGHCONTRASTON);
 
    if (m_hTheme)
    {
        ::CloseThemeData(m_hTheme);
        m_hTheme = NULL;
    }
    if (m_hFallbackTheme)
    {
        ::CloseThemeData(m_hFallbackTheme);
        m_hFallbackTheme = NULL;
    }
 
    EnsureWindowTheme(FALSE);
 
    Invalidate(TRUE);
    return 0;
}

Referenced by OnSettingChanged().

◆ OnTimer()

LRESULT CTrayShowDesktopButton::OnTimer	(	UINT	uMsg,
		WPARAM	wParam,
		LPARAM	lParam,
		BOOL &	bHandled
	)

private

Definition at line 268 of file traydeskbtn.cpp.

{
    if (wParam != SHOW_DESKTOP_TIMER_ID || !m_bHovering)
        return 0;
 
    POINT pt;
    ::GetCursorPos(&pt);
    if (!PtInButton(&pt)) // The end of hovering?
    {
        m_bHovering = FALSE;
        KillTimer(SHOW_DESKTOP_TIMER_ID);
        Invalidate(TRUE);
 
        ::PostMessage(m_hWndTaskbar, WM_NCPAINT, 0, 0);
    }
 
    return 0;
}

◆ OnWindowPosChanged()

LRESULT CTrayShowDesktopButton::OnWindowPosChanged	(	UINT	uMsg,
		WPARAM	wParam,
		LPARAM	lParam,
		BOOL &	bHandled
	)

private

Definition at line 165 of file traydeskbtn.cpp.

{
    EnsureWindowTheme(TRUE);
    return 0;
}

◆ PtInButton()

BOOL CTrayShowDesktopButton::PtInButton ( LPPOINT pt ) const

Definition at line 234 of file traydeskbtn.cpp.

{
    if (!ppt || !IsWindow())
        return FALSE;
 
    RECT rc;
    GetWindowRect(&rc);
    INT cxEdge = ::GetSystemMetrics(SM_CXEDGE), cyEdge = ::GetSystemMetrics(SM_CYEDGE);
    ::InflateRect(&rc, max(cxEdge, 1), max(cyEdge, 1));
 
    return m_bHorizontal
        ? (ppt->x > rc.left)
        : (ppt->y > rc.top);
}

Referenced by OnLButtonUp(), CTrayNotifyWnd::OnMouseMove(), CTrayNotifyWnd::OnNcHitTest(), CTrayWindow::OnNcHitTest(), CTrayWindow::OnNcLButtonDown(), and OnTimer().

◆ StartHovering()

VOID CTrayShowDesktopButton::StartHovering ( )

Definition at line 249 of file traydeskbtn.cpp.

{
    if (m_bHovering)
        return;
 
    m_bHovering = TRUE;
    Invalidate(TRUE);
 
    SetTimer(SHOW_DESKTOP_TIMER_ID, SHOW_DESKTOP_TIMER_INTERVAL, NULL);
 
    ::PostMessage(m_hWndTaskbar, WM_NCPAINT, 0, 0);
}

Referenced by OnMouseMove(), and CTrayNotifyWnd::OnMouseMove().

◆ WidthOrHeight()

INT CTrayShowDesktopButton::WidthOrHeight ( ) const

Definition at line 33 of file traydeskbtn.cpp.

{
    if (IsThemeActive() && !m_highContrastMode)
    {
        if (m_drawWithDedicatedBackground)
        {
            if (GetSystemMetrics(SM_TABLETPC))
            {
                //TODO: DPI scaling - return logical-to-physical conversion of 24, not fixed value
                return 24;
            }
            else
                return 15;
        }
        else
        {
            INT CurMargin = m_bHorizontal
                ? (m_ContentMargins.cxLeftWidth + m_ContentMargins.cxRightWidth)
                : (m_ContentMargins.cyTopHeight + m_ContentMargins.cyBottomHeight);
            return max(16 + CurMargin, 18) + 6;
        }
    }
    else
    {
        return max(2 * GetSystemMetrics(SM_CXBORDER) + GetSystemMetrics(SM_CXSMICON),
                   2 * GetSystemMetrics(SM_CYBORDER) + GetSystemMetrics(SM_CYSMICON));
    }
}

Referenced by CTrayNotifyWnd::AlignControls(), and CTrayNotifyWnd::GetMinimumSize().

Member Data Documentation

◆ m_bHorizontal

BOOL CTrayShowDesktopButton::m_bHorizontal

Definition at line 34 of file traydeskbtn.h.

Referenced by EnsureWindowTheme(), OnDraw(), CTrayNotifyWnd::OnGetMinimumSize(), PtInButton(), and WidthOrHeight().

◆ m_bHovering

BOOL CTrayShowDesktopButton::m_bHovering

private

Definition at line 29 of file traydeskbtn.h.

Referenced by OnDraw(), OnTimer(), and StartHovering().

◆ m_bPressed

BOOL CTrayShowDesktopButton::m_bPressed

Definition at line 33 of file traydeskbtn.h.

Referenced by OnDraw(), OnLButtonDown(), OnLButtonUp(), and CTrayWindow::OnNcLButtonUp().

◆ m_ContentMargins

MARGINS CTrayShowDesktopButton::m_ContentMargins

private

Definition at line 23 of file traydeskbtn.h.

Referenced by EnsureWindowTheme(), and WidthOrHeight().

◆ m_drawWithDedicatedBackground

BOOL CTrayShowDesktopButton::m_drawWithDedicatedBackground

private

Definition at line 28 of file traydeskbtn.h.

Referenced by EnsureWindowTheme(), OnDraw(), and WidthOrHeight().

◆ m_hFallbackTheme

HTHEME CTrayShowDesktopButton::m_hFallbackTheme

private

Definition at line 22 of file traydeskbtn.h.

Referenced by EnsureWindowTheme(), OnDestroy(), OnDraw(), and OnThemeChanged().

◆ m_highContrastMode

BOOL CTrayShowDesktopButton::m_highContrastMode

private

Definition at line 27 of file traydeskbtn.h.

Referenced by OnDraw(), OnThemeChanged(), and WidthOrHeight().

◆ m_hTheme

HTHEME CTrayShowDesktopButton::m_hTheme

private

Definition at line 21 of file traydeskbtn.h.

Referenced by EnsureWindowTheme(), OnDestroy(), OnDraw(), and OnThemeChanged().

◆ m_hWndTaskbar

HWND CTrayShowDesktopButton::m_hWndTaskbar

private

Definition at line 30 of file traydeskbtn.h.

Referenced by DoCreate(), EnsureWindowTheme(), OnClick(), OnTimer(), and StartHovering().

◆ m_icon

HICON CTrayShowDesktopButton::m_icon

private

Definition at line 25 of file traydeskbtn.h.

Referenced by DoCreate(), and OnDraw().

◆ m_inset

SIZE CTrayShowDesktopButton::m_inset

private

Definition at line 24 of file traydeskbtn.h.

Referenced by EnsureWindowTheme(), and OnDraw().

◆ m_nClickedTime

LONG CTrayShowDesktopButton::m_nClickedTime

private

Definition at line 20 of file traydeskbtn.h.

Referenced by Click(), and OnClick().

◆ m_szIcon

SIZE CTrayShowDesktopButton::m_szIcon

private

Definition at line 26 of file traydeskbtn.h.

Referenced by DoCreate(), and OnDraw().

The documentation for this class was generated from the following files:

base/shell/explorer/traydeskbtn.h
base/shell/explorer/traydeskbtn.cpp

Public Member Functions

Public Attributes

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ CTrayShowDesktopButton()

Member Function Documentation

◆ Click()

◆ DoCreate()

◆ EnsureWindowTheme()

◆ OnClick()

◆ OnDestroy()

◆ OnDraw()

◆ OnLButtonDown()

◆ OnLButtonUp()

◆ OnMouseMove()

◆ OnPaint()

◆ OnPrintClient()

◆ OnSettingChanged()

◆ OnThemeChanged()

◆ OnTimer()

◆ OnWindowPosChanged()

◆ PtInButton()

◆ StartHovering()

◆ WidthOrHeight()

Member Data Documentation

◆ m_bHorizontal

◆ m_bHovering

◆ m_bPressed

◆ m_ContentMargins

◆ m_drawWithDedicatedBackground

◆ m_hFallbackTheme

◆ m_highContrastMode

◆ m_hTheme

◆ m_hWndTaskbar

◆ m_icon

◆ m_inset

◆ m_nClickedTime

◆ m_szIcon