DesktopWindow Struct Reference

Implementation of the Explorer desktop window. More...

#include <desktop.h>

Inheritance diagram for DesktopWindow:

Collaboration diagram for DesktopWindow:

Public Types
typedef PreTranslateWindow	super
Public Types inherited from PreTranslateWindow
typedef Window	super
Public Types inherited from Window
typedef map< HWND, Window * >	WindowMap
typedef Window *(*	CREATORFUNC) (HWND)
typedef Window *(*	CREATORFUNC_INFO) (HWND, const void *)
Public Types inherited from IShellBrowser
typedef IShellBrowser *	LPSHELLBROWSER
typedef LPTBBUTTON	LPTBBUTTONSB
Public Types inherited from IOleWindow
typedef IOleWindow *	LPOLEWINDOW
Public Types inherited from IUnknown
typedef IUnknown *	LPUNKNOWN
Public Types inherited from IServiceProvider
typedef IServiceProvider *	LPSERVICEPROVIDER
Public Types inherited from IOleCommandTarget
enum	OLECMDF {   OLECMDF_SUPPORTED = 0x1, OLECMDF_ENABLED = 0x2, OLECMDF_LATCHED = 0x4, OLECMDF_NINCHED = 0x8,   OLECMDF_INVISIBLE = 0x10, OLECMDF_DEFHIDEONCTXTMENU = 0x20 }
enum	OLECMDTEXTF { OLECMDTEXTF_NONE = 0, OLECMDTEXTF_NAME = 1, OLECMDTEXTF_STATUS = 2 }
enum	OLECMDEXECOPT { OLECMDEXECOPT_DODEFAULT = 0, OLECMDEXECOPT_PROMPTUSER = 1, OLECMDEXECOPT_DONTPROMPTUSER = 2, OLECMDEXECOPT_SHOWHELP = 3 }
enum	OLECMDID {   OLECMDID_OPEN = 1, OLECMDID_NEW = 2, OLECMDID_SAVE = 3, OLECMDID_SAVEAS = 4,   OLECMDID_SAVECOPYAS = 5, OLECMDID_PRINT = 6, OLECMDID_PRINTPREVIEW = 7, OLECMDID_PAGESETUP = 8,   OLECMDID_SPELL = 9, OLECMDID_PROPERTIES = 10, OLECMDID_CUT = 11, OLECMDID_COPY = 12,   OLECMDID_PASTE = 13, OLECMDID_PASTESPECIAL = 14, OLECMDID_UNDO = 15, OLECMDID_REDO = 16,   OLECMDID_SELECTALL = 17, OLECMDID_CLEARSELECTION = 18, OLECMDID_ZOOM = 19, OLECMDID_GETZOOMRANGE = 20,   OLECMDID_UPDATECOMMANDS = 21, OLECMDID_REFRESH = 22, OLECMDID_STOP = 23, OLECMDID_HIDETOOLBARS = 24,   OLECMDID_SETPROGRESSMAX = 25, OLECMDID_SETPROGRESSPOS = 26, OLECMDID_SETPROGRESSTEXT = 27, OLECMDID_SETTITLE = 28,   OLECMDID_SETDOWNLOADSTATE = 29, OLECMDID_STOPDOWNLOAD = 30, OLECMDID_ONTOOLBARACTIVATED = 31, OLECMDID_FIND = 32,   OLECMDID_DELETE = 33, OLECMDID_HTTPEQUIV = 34, OLECMDID_HTTPEQUIV_DONE = 35, OLECMDID_ENABLE_INTERACTION = 36,   OLECMDID_ONUNLOAD = 37, OLECMDID_PROPERTYBAG2 = 38, OLECMDID_PREREFRESH = 39, OLECMDID_SHOWSCRIPTERROR = 40,   OLECMDID_SHOWMESSAGE = 41, OLECMDID_SHOWFIND = 42, OLECMDID_SHOWPAGESETUP = 43, OLECMDID_SHOWPRINT = 44,   OLECMDID_CLOSE = 45, OLECMDID_ALLOWUILESSSAVEAS = 46, OLECMDID_DONTDOWNLOADCSS = 47, OLECMDID_UPDATEPAGESTATUS = 48,   OLECMDID_PRINT2 = 49, OLECMDID_PRINTPREVIEW2 = 50, OLECMDID_SETPRINTTEMPLATE = 51, OLECMDID_GETPRINTTEMPLATE = 52,   OLECMDID_PAGEACTIONBLOCKED = 55, OLECMDID_PAGEACTIONUIQUERY = 56, OLECMDID_FOCUSVIEWCONTROLS = 57, OLECMDID_FOCUSVIEWCONTROLSQUERY = 58,   OLECMDID_SHOWPAGEACTIONMENU = 59, OLECMDID_ADDTRAVELENTRY = 60, OLECMDID_UPDATETRAVELENTRY = 61, OLECMDID_UPDATEBACKFORWARDSTATE = 62,   OLECMDID_OPTICAL_ZOOM = 63, OLECMDID_OPTICAL_GETZOOMRANGE = 64, OLECMDID_WINDOWSTATECHANGED = 65, OLECMDID_ACTIVEXINSTALLSCOPE = 66,   OLECMDID_UPDATETRAVELENTRY_DATARECOVERY = 67, OLECMDID_SHOWTASKDLG = 68, OLECMDID_POPSTATEEVENT = 69, OLECMDID_VIEWPORT_MODE = 70,   OLECMDID_LAYOUT_VIEWPORT_WIDTH = 71, OLECMDID_VISUAL_VIEWPORT_EXCLUDE_BOTTOM = 72, OLECMDID_USER_OPTICAL_ZOOM = 73, OLECMDID_PAGEAVAILABLE = 74,   OLECMDID_GETUSERSCALABLE = 75, OLECMDID_UPDATE_CARET = 76, OLECMDID_ENABLE_VISIBILITY = 77, OLECMDID_MEDIA_PLAYBACK = 78 }
typedef IOleCommandTarget *	LPOLECOMMANDTARGET
typedef enum IOleCommandTarget::OLECMDF	OLECMDF
typedef struct IOleCommandTarget::_tagOLECMD	OLECMD
typedef struct IOleCommandTarget::_tagOLECMDTEXT	OLECMDTEXT
typedef enum IOleCommandTarget::OLECMDTEXTF	OLECMDTEXTF
typedef enum IOleCommandTarget::OLECMDEXECOPT	OLECMDEXECOPT
typedef enum IOleCommandTarget::OLECMDID	OLECMDID

Public Member Functions
	DesktopWindow (HWND hwnd)
	~DesktopWindow ()
virtual HRESULT STDMETHODCALLTYPE	GetWindow (HWND *lphwnd)
virtual HRESULT STDMETHODCALLTYPE	QueryActiveShellView (IShellView **ppshv)
virtual HRESULT STDMETHODCALLTYPE	GetControlWindow (UINT id, HWND *lphwnd)
virtual HRESULT STDMETHODCALLTYPE	SendControlMsg (UINT id, UINT uMsg, WPARAM wParam, LPARAM lParam, LRESULT *pret)
Public Member Functions inherited from PreTranslateWindow
	PreTranslateWindow (HWND)
	~PreTranslateWindow ()
Public Member Functions inherited from Window
	Window (HWND hwnd)
virtual	~Window ()
LRESULT	SendParent (UINT nmsg, WPARAM wparam=0, LPARAM lparam=0)
LRESULT	PostParent (UINT nmsg, WPARAM wparam=0, LPARAM lparam=0)
Public Member Functions inherited from IShellBrowserImpl
	IShellBrowserImpl ()
virtual	~IShellBrowserImpl ()
virtual HRESULT STDMETHODCALLTYPE	QueryInterface (REFIID iid, void **ppvObject)
virtual ULONG STDMETHODCALLTYPE	AddRef ()
virtual ULONG STDMETHODCALLTYPE	Release ()
virtual HRESULT STDMETHODCALLTYPE	ContextSensitiveHelp (BOOL fEnterMode)
virtual HRESULT STDMETHODCALLTYPE	OnDefaultCommand (IShellView *ppshv)
virtual HRESULT STDMETHODCALLTYPE	OnStateChange (IShellView *ppshv, ULONG uChange)
virtual HRESULT STDMETHODCALLTYPE	IncludeObject (IShellView *ppshv, LPCITEMIDLIST pidl)
virtual HRESULT STDMETHODCALLTYPE	InsertMenusSB (HMENU hmenuShared, LPOLEMENUGROUPWIDTHS lpMenuWidths)
virtual HRESULT STDMETHODCALLTYPE	SetMenuSB (HMENU hmenuShared, HOLEMENU holemenuReserved, HWND hwndActiveObject)
virtual HRESULT STDMETHODCALLTYPE	RemoveMenusSB (HMENU hmenuShared)
virtual HRESULT STDMETHODCALLTYPE	SetStatusTextSB (LPCOLESTR lpszStatusText)
virtual HRESULT STDMETHODCALLTYPE	EnableModelessSB (BOOL fEnable)
virtual HRESULT STDMETHODCALLTYPE	BrowseObject (LPCITEMIDLIST pidl, UINT wFlags)
virtual HRESULT STDMETHODCALLTYPE	GetViewStateStream (DWORD grfMode, LPSTREAM *ppStrm)
virtual HRESULT STDMETHODCALLTYPE	OnViewWindowActive (IShellView *ppshv)
virtual HRESULT STDMETHODCALLTYPE	SetToolbarItems (LPTBBUTTON lpButtons, UINT nButtons, UINT uFlags)
virtual HRESULT STDMETHODCALLTYPE	TranslateAcceleratorSB (LPMSG lpmsg, WORD wID)
virtual HRESULT STDMETHODCALLTYPE	QueryService (REFGUID guidService, REFIID riid, void **ppvObject)
virtual HRESULT STDMETHODCALLTYPE	QueryStatus (const GUID *pguidCmdGroup, ULONG cCmds, OLECMD prgCmds[], OLECMDTEXT *pCmdText)
virtual HRESULT STDMETHODCALLTYPE	Exec (const GUID *pguidCmdGroup, DWORD nCmdID, DWORD nCmdexecopt, VARIANT *pvaIn, VARIANT *pvaOut)
Public Member Functions inherited from IShellBrowser
HRESULT	TranslateAcceleratorSB ([in] MSG *pmsg, [in] WORD wID)
HRESULT	GetViewStateStream ([in] DWORD grfMode, [out] IStream **ppStrm)
Public Member Functions inherited from IServiceProvider
HRESULT	RemoteQueryService ([in] REFGUID guidService, [in] REFIID riid, [out, iid_is(riid)] IUnknown **ppvObject)

Static Public Member Functions
static HWND	Create ()
Static Public Member Functions inherited from Window
static HWND	Create (CREATORFUNC creator, DWORD dwExStyle, LPCTSTR lpClassName, LPCTSTR lpWindowName, DWORD dwStyle, int x, int y, int w, int h, HWND hwndParent=0, HMENU hMenu=0)
static HWND	Create (CREATORFUNC_INFO creator, const void *info, DWORD dwExStyle, LPCTSTR lpClassName, LPCTSTR lpWindowName, DWORD dwStyle, int x, int y, int w, int h, HWND hwndParent=0, HMENU hMenu=0)
static Window *	create_mdi_child (const ChildWndInfo &info, const MDICREATESTRUCT &mcs, CREATORFUNC_INFO creator)
static LRESULT CALLBACK	WindowWndProc (HWND hwnd, UINT nmsg, WPARAM wparam, LPARAM lparam)
static INT_PTR CALLBACK	DialogProc (HWND hwnd, UINT nmsg, WPARAM wparam, LPARAM lparam)
static Window *	get_window (HWND hwnd)
	get window controller from window handle More...
template<typename CLASS >
static CLASS *	get_window (HWND hwnd)
static void	register_pretranslate (HWND hwnd)
static void	unregister_pretranslate (HWND hwnd)
static BOOL	pretranslate_msg (LPMSG pmsg)
static void	register_dialog (HWND hwnd)
static void	unregister_dialog (HWND hwnd)
static BOOL	dispatch_dialog_msg (LPMSG pmsg)
static int	MessageLoop ()
static void	CancelModes ()

Protected Member Functions
LRESULT	Init (LPCREATESTRUCT pcs)
LRESULT	WndProc (UINT nmsg, WPARAM wparam, LPARAM lparam)
virtual HRESULT	OnDefaultCommand (LPIDA pida)
Protected Member Functions inherited from Window
virtual int	Command (int id, int code)
virtual int	Notify (int id, NMHDR *pnmh)

Protected Attributes
IShellView *	_pShellView
WindowHandle	_desktopBar
Protected Attributes inherited from IShellBrowserImpl
DWORD	_dwRef

Additional Inherited Members
Public Attributes inherited from Window
IAccessible	IAccessible_iface
IOleWindow	IOleWindow_iface
IEnumVARIANT	IEnumVARIANT_iface
LONG	ref
Public Attributes inherited from IShellBrowserImpl
IShellBrowser	IShellBrowser_iface
ICommDlgBrowser	ICommDlgBrowser_iface
IServiceProvider	IServiceProvider_iface
LONG	ref
HWND	hwndOwner
Public Attributes inherited from IShellBrowser
FCT_ADDTOEND typedef LPARAM	LPTBBUTTONSB
Public Attributes inherited from ICommDlgBrowser
CDBOSC_STATECHANGE typedef ICommDlgBrowser *	LPCOMMDLGBROWSER
Static Protected Member Functions inherited from Window
static Window *	create_controller (HWND hwnd)
	create controller for a new window More...
static StaticWindowData &	GetStaticWindowData ()
static LRESULT CALLBACK	MDICBTHookProc (int code, WPARAM wparam, LPARAM lparam)
static LRESULT CALLBACK	PropSheetCBTHookProc (int code, WPARAM wparam, LPARAM lparam)
Static Protected Attributes inherited from Window
static WindowMap	s_wnd_map
static const void *	s_new_info = NULL
static CREATORFUNC	s_window_creator = NULL
static HHOOK	s_hcbtHook = 0
static WindowSet	s_pretranslate_windows
static WindowSet	s_dialogs

Detailed Description

Implementation of the Explorer desktop window.

Definition at line 51 of file desktop.h.

Member Typedef Documentation

super

typedef PreTranslateWindow DesktopWindow::super

Definition at line 53 of file desktop.h.

Constructor & Destructor Documentation

DesktopWindow()

DesktopWindow::DesktopWindow

(

HWND

hwnd

)

Definition at line 313 of file desktop.cpp.

 :  super(hwnd)
{
    _pShellView = NULL;
}

~DesktopWindow()

DesktopWindow::~DesktopWindow

(

)

Definition at line 319 of file desktop.cpp.

{
    if (_pShellView)
        _pShellView->Release();
}

Member Function Documentation

Create()

HWND DesktopWindow::Create ( )

static

Definition at line 326 of file desktop.cpp.

Referenced by _tWinMain(), and Desktops::init().

{
    static IconWindowClass wcDesktop(TEXT("Progman"), IDI_REACTOS, CS_DBLCLKS);
    /* (disabled because of small ugly temporary artefacts when hiding start menu)
    wcDesktop.hbrBackground = (HBRUSH)(COLOR_BACKGROUND+1); */

    int width = GetSystemMetrics(SM_CXSCREEN);
    int height = GetSystemMetrics(SM_CYSCREEN);

    HWND hwndDesktop = Window::Create(WINDOW_CREATOR(DesktopWindow),
                    WS_EX_TOOLWINDOW, wcDesktop, TEXT("Program Manager"), WS_POPUP|WS_VISIBLE,  //|WS_CLIPCHILDREN for SDI frames
                    0, 0, width, height, 0);

     // work around to display desktop bar in Wine
    ShowWindow(GET_WINDOW(DesktopWindow, hwndDesktop)->_desktopBar, SW_SHOW);

     // work around for Windows NT, Win 98, ...
     // Without this the desktop has mysteriously only a size of 800x600 pixels.
    MoveWindow(hwndDesktop, 0, 0, width, height, TRUE);

    return hwndDesktop;
}

GetControlWindow()

virtual HRESULT STDMETHODCALLTYPE DesktopWindow::GetControlWindow ( UINT  id, HWND *  lphwnd  )

inlinevirtual

Implements IShellBrowser.

Definition at line 73 of file desktop.h.

    {
        return E_NOTIMPL;
    }

GetWindow()

virtual HRESULT STDMETHODCALLTYPE DesktopWindow::GetWindow ( HWND *  lphwnd )

inlinevirtual

Implements IOleWindow.

Definition at line 60 of file desktop.h.

    {
        *lphwnd = _hwnd;
        return S_OK;
    }

Init()

LRESULT DesktopWindow::Init ( LPCREATESTRUCT  pcs )

protectedvirtual

Todo:

use IShellBrowser::GetViewStateStream() to restore previous view state -> see SHOpenRegStream()

Reimplemented from Window.

Definition at line 350 of file desktop.cpp.

{
    if (super::Init(pcs))
        return 1;

    HRESULT hr = GetDesktopFolder()->CreateViewObject(_hwnd, IID_IShellView, (void**)&_pShellView);
/* also possible:
    SFV_CREATE sfv_create;

    sfv_create.cbSize = sizeof(SFV_CREATE);
    sfv_create.pshf = GetDesktopFolder();
    sfv_create.psvOuter = NULL;
    sfv_create.psfvcb = NULL;

    HRESULT hr = SHCreateShellFolderView(&sfv_create, &_pShellView);
*/
    HWND hWndView = 0;

    if (SUCCEEDED(hr)) {
        FOLDERSETTINGS fs;

        fs.ViewMode = FVM_ICON;
        fs.fFlags = FWF_DESKTOP|FWF_NOCLIENTEDGE|FWF_NOSCROLL|FWF_BESTFITWINDOW|FWF_SNAPTOGRID; //|FWF_AUTOARRANGE;

        ClientRect rect(_hwnd);

        hr = _pShellView->CreateViewWindow(NULL, &fs, this, &rect, &hWndView);


        if (SUCCEEDED(hr)) {
            g_Globals._hwndShellView = hWndView;

             // subclass shellview window
            new DesktopShellView(hWndView, _pShellView);

            _pShellView->UIActivate(SVUIA_ACTIVATE_FOCUS);

        /*
            IShellView2* pShellView2;

            hr = _pShellView->QueryInterface(IID_IShellView2, (void**)&pShellView2);

            SV2CVW2_PARAMS params;
            params.cbSize = sizeof(SV2CVW2_PARAMS);
            params.psvPrev = _pShellView;
            params.pfs = &fs;
            params.psbOwner = this;
            params.prcView = ▭
            params.pvid = params.pvid;//@@

            hr = pShellView2->CreateViewWindow2(&params);
            params.pvid;
        */

        /*
            IFolderView* pFolderView;

            hr = _pShellView->QueryInterface(IID_IFolderView, (void**)&pFolderView);

            if (SUCCEEDED(hr)) {
                hr = pFolderView->GetAutoArrange();
                hr = pFolderView->SetCurrentViewMode(FVM_DETAILS);
            }
        */
        }
    }

    if (hWndView && SetShellWindowEx)
        SetShellWindowEx(_hwnd, hWndView);
    else if (SetShellWindow)
        SetShellWindow(_hwnd);

     // create the explorer bar
    _desktopBar = DesktopBar::Create();
    g_Globals._hwndDesktopBar = _desktopBar;

    return 0;
}

OnDefaultCommand()

HRESULT DesktopWindow::OnDefaultCommand ( LPIDA  pida )

protectedvirtual

Reimplemented from IShellBrowserImpl.

Definition at line 509 of file desktop.cpp.

{
#ifndef ROSSHELL    // in shell-only-mode fall through and let shell32 handle the command
    if (MainFrameBase::OpenShellFolders(pida, 0))
        return S_OK;
#endif

    return E_NOTIMPL;
}

QueryActiveShellView()

virtual HRESULT STDMETHODCALLTYPE DesktopWindow::QueryActiveShellView ( IShellView **  ppshv )

inlinevirtual

Implements IShellBrowser.

Definition at line 66 of file desktop.h.

    {
        _pShellView->AddRef();
        *ppshv = _pShellView;
        return S_OK;
    }

SendControlMsg()

virtual HRESULT STDMETHODCALLTYPE DesktopWindow::SendControlMsg ( UINT  id, UINT  uMsg, WPARAM  wParam, LPARAM  lParam, LRESULT *  pret  )

inlinevirtual

Implements IShellBrowser.

Definition at line 78 of file desktop.h.

    {
        return E_NOTIMPL;
    }

WndProc()

LRESULT DesktopWindow::WndProc ( UINT  nmsg, WPARAM  wparam, LPARAM  lparam  )

protectedvirtual

Todo:

use IShellBrowser::GetViewStateStream() and _pShellView->SaveViewState() to store view state

Reimplemented from Window.

Definition at line 431 of file desktop.cpp.

{
    switch(nmsg) {
      case WM_LBUTTONDBLCLK:
      case WM_RBUTTONDBLCLK:
      case WM_MBUTTONDBLCLK:
        explorer_show_frame(SW_SHOWNORMAL);
        break;

      case WM_DISPLAYCHANGE:
        MoveWindow(_hwnd, 0, 0, LOWORD(lparam), HIWORD(lparam), TRUE);
        MoveWindow(g_Globals._hwndShellView, 0, 0, LOWORD(lparam), HIWORD(lparam), TRUE);
        MoveWindow(_desktopBar, 0, HIWORD(lparam) - DESKTOPBARBAR_HEIGHT, LOWORD(lparam), DESKTOPBARBAR_HEIGHT, TRUE);
        break;

      case WM_GETISHELLBROWSER:
        return (LRESULT)static_cast<IShellBrowser*>(this);

      case WM_DESTROY:


        if (SetShellWindow)
            SetShellWindow(0);
        break;

      case WM_CLOSE:
        ShowExitWindowsDialog(_hwnd);
        break;

      case WM_SYSCOMMAND:
        if (wparam == SC_TASKLIST) {
            if (_desktopBar)
                SendMessage(_desktopBar, nmsg, wparam, lparam);
        }
        goto def;

      case WM_SYSCOLORCHANGE:
        // redraw background window - it's done by system
        //InvalidateRect(g_Globals._hwndShellView, NULL, TRUE);

        // forward message to common controls
        SendMessage(g_Globals._hwndShellView, WM_SYSCOLORCHANGE, 0, 0);
        SendMessage(_desktopBar, WM_SYSCOLORCHANGE, 0, 0);
        break;

      case WM_SETTINGCHANGE:
        SendMessage(g_Globals._hwndShellView, nmsg, wparam, lparam);
        break;

      case PM_TRANSLATE_MSG:
      {
            /* TranslateAccelerator is called for all explorer windows that are open 
               so we have to decide if this is the correct recipient */
            LPMSG lpmsg = (LPMSG)lparam;
            HWND hwnd = lpmsg->hwnd;

            while(hwnd)
            {
                if(hwnd == _hwnd)
                    break;

                hwnd = GetParent(hwnd);
            }

            if (hwnd)
                return _pShellView->TranslateAccelerator(lpmsg) == S_OK;
            return false;
      }

      default: def:
        return super::WndProc(nmsg, wparam, lparam);
    }

    return 0;
}

Member Data Documentation

_desktopBar

WindowHandle DesktopWindow::_desktopBar

protected

Definition at line 88 of file desktop.h.

Referenced by Create(), Init(), and WndProc().

_pShellView

IShellView* DesktopWindow::_pShellView

protected

Definition at line 87 of file desktop.h.

Referenced by DesktopWindow(), Init(), WndProc(), and ~DesktopWindow().

---

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

• modules/rosapps/applications/explorer-old/desktop/desktop.h
• modules/rosapps/applications/explorer-old/desktop/desktop.cpp