CTrayShowDesktopButton Class Reference

#include <traydeskbtn.h>

Inheritance diagram for CTrayShowDesktopButton:

Collaboration diagram for CTrayShowDesktopButton:

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
CTooltips	m_tooltip

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 119 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);
 
    // Create tooltip
    m_tooltip.Create(m_hWnd, WS_POPUP | TTS_NOPREFIX | TTS_ALWAYSTIP);
 
    TOOLINFOW ti = { 0 };
    ti.cbSize = TTTOOLINFOW_V1_SIZE;
    ti.uFlags = TTF_IDISHWND | TTF_SUBCLASS;
    ti.hwnd = m_hWnd;
    ti.uId = reinterpret_cast<UINT_PTR>(m_hWnd);
    ti.hinst = hExplorerInstance;
    ti.lpszText = MAKEINTRESOURCEW(IDS_TRAYDESKBTN_TOOLTIP);
 
    m_tooltip.AddTool(&ti);
 
    // 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 184 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 103 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 300 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 316 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 139 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 126 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 275 of file traydeskbtn.cpp.

{
    StartHovering();
    return 0;
}

OnPaint()

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

private

Definition at line 220 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 233 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 147 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 154 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 281 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 178 of file traydeskbtn.cpp.

{
    EnsureWindowTheme(TRUE);
    return 0;
}

PtInButton()

BOOL CTrayShowDesktopButton::PtInButton

(

LPPOINT

pt

)

const

Definition at line 247 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 262 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 35 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 34 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().

m_tooltip

CTooltips CTrayShowDesktopButton::m_tooltip

private

Definition at line 31 of file traydeskbtn.h.

Referenced by DoCreate().

---

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

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