Window Struct Reference

#include <window.h>

Inheritance diagram for Window:

Collaboration diagram for Window:

Classes
struct	StaticWindowData
	structure for managing critical sections as static class information in struct Window More...

Public Types
typedef map< HWND, Window * >	WindowMap
typedef Window *(*	CREATORFUNC) (HWND)
typedef Window *(*	CREATORFUNC_INFO) (HWND, const void *)

Public Member Functions
	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)

Static Public Member Functions
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 ()

Public Attributes
IAccessible	IAccessible_iface
IOleWindow	IOleWindow_iface
IEnumVARIANT	IEnumVARIANT_iface
LONG	ref

Protected Member Functions
virtual LRESULT	Init (LPCREATESTRUCT pcs)
virtual LRESULT	WndProc (UINT nmsg, WPARAM wparam, LPARAM lparam)
virtual int	Command (int id, int code)
virtual int	Notify (int id, NMHDR *pnmh)

Static Protected Member Functions
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
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

Class Window is the base class for several C++ window wrapper classes. Window objects are allocated from the heap. They are automatically freed when the window gets destroyed.

Definition at line 28 of file window.c.

Member Typedef Documentation

CREATORFUNC

typedef Window*(* Window::CREATORFUNC) (HWND)

Definition at line 66 of file window.h.

CREATORFUNC_INFO

typedef Window*(* Window::CREATORFUNC_INFO) (HWND, const void *)

Definition at line 67 of file window.h.

WindowMap

typedef map<HWND,Window*> Window::WindowMap

Definition at line 64 of file window.h.

Constructor & Destructor Documentation

Window()

Window::Window

(

HWND

hwnd

)

Definition at line 71 of file window.cpp.

 :  WindowHandle(hwnd)
{
    Lock lock(GetStaticWindowData()._map_crit_sect);    // protect access to s_wnd_map

    s_wnd_map[_hwnd] = this;
}

~Window()

Window::~Window ( )

virtual

Definition at line 79 of file window.cpp.

{
    Lock lock(GetStaticWindowData()._map_crit_sect);    // protect access to s_wnd_map

    s_wnd_map.erase(_hwnd);
}

Member Function Documentation

CancelModes()

void Window::CancelModes ( )

static

Definition at line 295 of file window.cpp.

{
    PostMessage(HWND_BROADCAST, WM_CANCELMODE, 0, 0);
}

Command()

int Window::Command ( int  id, int  code  )

protectedvirtual

Reimplemented in FavoritesMenu, PropSheetPageDlg, Dialog, StartMenuRoot, StartMenuHandler, TrayNotifyDlg, StartMenu, SubclassedWindow, DesktopShellView, SDIMainFrame, NotifyArea, MDIMainFrame, DesktopBar, FindProgramDlg, MdiSdiDlg, FileChildWindow, TaskBar, StartmenuSettingsDlg, MainFrameBase, TaskbarSettingsDlg, QuickLaunchBar, and DesktopSettingsDlg.

Definition at line 285 of file window.cpp.

{
    return 1;   // no command handler found
}

Referenced by TaskBar::Command(), StartMenu::Command(), DialogProc(), and WindowWndProc().

Create() [1/2]

HWND Window::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

Definition at line 87 of file window.cpp.

{
    Lock lock(GetStaticWindowData()._create_crit_sect); // protect access to s_window_creator and s_new_info

    s_window_creator = creator;
    s_new_info = NULL;

    return CreateWindowEx(dwExStyle, lpClassName, lpWindowName, dwStyle,
                            x, y, w, h,
                            hwndParent, hMenu, g_Globals._hInstance, 0/*lpParam*/);
}

Referenced by DesktopWindow::Create(), TaskBar::Create(), DesktopBar::Create(), MDIMainFrame::Create(), NotifyArea::Create(), SDIMainFrame::Create(), StartMenu::Create(), ClockWindow::Create(), and StartMenuRoot::Create().

Create() [2/2]

HWND Window::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

Definition at line 102 of file window.cpp.

{
    Lock lock(GetStaticWindowData()._create_crit_sect); // protect access to s_window_creator and s_new_info

    s_window_creator = (CREATORFUNC) creator;
    s_new_info = info;

    return CreateWindowEx(dwExStyle, lpClassName, lpWindowName, dwStyle,
                            x, y, w, h,
                            hwndParent, hMenu, g_Globals._hInstance, 0/*lpParam*/);
}

create_controller()

Window * Window::create_controller ( HWND  hwnd )

staticprotected

create controller for a new window

Definition at line 220 of file window.cpp.

{
    if (s_window_creator) { // protect for recursion and create the window object only for the first window
        Lock lock(GetStaticWindowData()._create_crit_sect); // protect access to s_window_creator and s_new_info

        const void* info = s_new_info;
        s_new_info = NULL;

        CREATORFUNC window_creator = s_window_creator;
        s_window_creator = NULL;

        if (info)
            return CREATORFUNC_INFO(window_creator)(hwnd, info);
        else
            return CREATORFUNC(window_creator)(hwnd);
    }

    return NULL;
}

Referenced by DialogProc(), MDICBTHookProc(), PropSheetCBTHookProc(), and WindowWndProc().

create_mdi_child()

Window * Window::create_mdi_child ( const ChildWndInfo &  info, const MDICREATESTRUCT &  mcs, CREATORFUNC_INFO  creator  )

static

Definition at line 118 of file window.cpp.

{
    Lock lock(GetStaticWindowData()._create_crit_sect); // protect access to s_window_creator and s_new_info

    s_window_creator = (CREATORFUNC) creator;
    s_new_info = &info;

    s_hcbtHook = SetWindowsHookEx(WH_CBT, MDICBTHookProc, 0, GetCurrentThreadId());

    HWND hwnd = (HWND) SendMessage(info._hmdiclient, WM_MDICREATE, 0, (LPARAM)&mcs);

     // end hook in case it's not already done
    if (s_hcbtHook)
        UnhookWindowsHookEx(s_hcbtHook);

    Window* child = get_window(hwnd);
    s_new_info = NULL;

    if (child && (!hwnd || !child->_hwnd))
        child = NULL;

    return child;
}

Referenced by FileChildWindow::create(), and ChildWindow::create().

DialogProc()

INT_PTR CALLBACK Window::DialogProc ( HWND  hwnd, UINT  nmsg, WPARAM  wparam, LPARAM  lparam  )

static

Definition at line 725 of file window.cpp.

{
    Window* pThis = get_window(hwnd);

    if (pThis) {
        switch(nmsg) {
          case WM_COMMAND:
            pThis->Command(LOWORD(wparam), HIWORD(wparam));
            return TRUE;    // message has been processed

          case WM_NOTIFY:
            pThis->Notify(wparam, (NMHDR*)lparam);
            return TRUE;    // message has been processed

          case WM_NOTIFYFORMAT:
            SetWindowLongPtr(hwnd, DWLP_MSGRESULT, NFR_CURRENT);    // set return value NFR_CURRENT
            return TRUE;    // message has been processed

          case WM_NCDESTROY:
            delete pThis;
            return TRUE;    // message has been processed

          default:
            return pThis->WndProc(nmsg, wparam, lparam);
        }
    } else if (nmsg == WM_INITDIALOG) {
        pThis = create_controller(hwnd);

        if (pThis)
            return pThis->Init(NULL);
    }

    return FALSE;   // message has not been processed
}

Referenced by Dialog::DoModal().

dispatch_dialog_msg()

BOOL Window::dispatch_dialog_msg ( LPMSG  pmsg )

static

Definition at line 619 of file window.cpp.

{
    for(WindowSet::const_iterator it=Window::s_dialogs.begin(); it!=s_dialogs.end(); ++it)
        if (IsDialogMessage(*it, pmsg))
            return TRUE;

    return FALSE;
}

Referenced by PropertySheetDialog::DoModal(), MessageLoop(), and StartMenuRoot::TrackStartmenu().

get_window() [1/2]

Window * Window::get_window ( HWND  hwnd )

static

get window controller from window handle

Definition at line 203 of file window.cpp.

{
    {
        Lock lock(GetStaticWindowData()._map_crit_sect);    // protect access to s_wnd_map

        WindowMap::const_iterator found = s_wnd_map.find(hwnd);

        if (found!=s_wnd_map.end())
            return found->second;
    }

    return NULL;
}

Referenced by create_mdi_child(), DialogProc(), MDICBTHookProc(), PropSheetCBTHookProc(), and WindowWndProc().

get_window() [2/2]

template<typename CLASS >

static CLASS* Window::get_window ( HWND  hwnd )

inlinestatic

Definition at line 87 of file window.h.

{return static_cast<CLASS*>(get_window(hwnd));}

Referenced by get_window().

GetStaticWindowData()

Window::StaticWindowData & Window::GetStaticWindowData ( )

staticprotected

Definition at line 63 of file window.cpp.

{
    static StaticWindowData s_initialized_data;

    return s_initialized_data;
}

Referenced by Create(), create_controller(), create_mdi_child(), Dialog::DoModal(), get_window(), Window(), and ~Window().

Init()

LRESULT Window::Init ( LPCREATESTRUCT  pcs )

protectedvirtual

Reimplemented in StartMenuRoot, MDIShellBrowserChild, StartMenu, NotifyArea, DesktopBar, TaskBar, and DesktopWindow.

Definition at line 241 of file window.cpp.

{
    return 0;
}

Referenced by DialogProc(), PropSheetPageDlg::DialogProc(), DesktopWindow::Init(), TaskBar::Init(), DesktopBar::Init(), NotifyArea::Init(), StartMenu::Init(), MDIShellBrowserChild::Init(), SubclassedWindow::SubclassedWndProc(), and WindowWndProc().

MDICBTHookProc()

LRESULT CALLBACK Window::MDICBTHookProc ( int  code, WPARAM  wparam, LPARAM  lparam  )

staticprotected

Definition at line 142 of file window.cpp.

{
    if (code == HCBT_CREATEWND) {
        UnhookWindowsHookEx(s_hcbtHook);    // use the hook only for the first created window
        s_hcbtHook = 0;

        HWND hwnd = (HWND)wparam;

         // create Window controller and associate it with the window handle
        Window* child = get_window(hwnd);

        if (!child)
            child = create_controller(hwnd);
    }

    return CallNextHookEx(s_hcbtHook, code, wparam, lparam);
}

Referenced by create_mdi_child().

MessageLoop()

int Window::MessageLoop ( )

static

Definition at line 629 of file window.cpp.

{
    MSG msg;

    while(GetMessage(&msg, 0, 0, 0)) {
        try {
            if (pretranslate_msg(&msg))
                continue;

            if (dispatch_dialog_msg(&msg))
                continue;

            TranslateMessage(&msg);

            try {
                DispatchMessage(&msg);
            } catch(COMException& e) {
                HandleException(e, 0);
            }
        } catch(COMException& e) {
            HandleException(e, 0);
        }
    }

    return msg.wParam;
}

Referenced by explorer_main().

Notify()

int Window::Notify ( int  id, NMHDR *  pnmh  )

protectedvirtual

Reimplemented in ClockWindow, TrayNotifyDlg, ShellBrowserChildT< ChildWindow >, ShellBrowserChildT< MainFrameBase >, SubclassedWindow, DesktopShellView, NotifyArea, DesktopBar, FindProgramDlg, FileChildWindow, Pane, TaskBar, MainFrameBase, TaskbarSettingsDlg, QuickLaunchBar, and DesktopSettingsDlg.

Definition at line 290 of file window.cpp.

{
    return 0;
}

Referenced by DialogProc(), PropSheetPageDlg::DialogProc(), DesktopSettingsDlg::Notify(), TaskbarSettingsDlg::Notify(), TaskBar::Notify(), and WindowWndProc().

PostParent()

LRESULT Window::PostParent	(	UINT	nmsg,
		WPARAM	wparam = 0,
		LPARAM	lparam = 0
	)

Definition at line 667 of file window.cpp.

{
    HWND parent = GetParent(_hwnd);

    if (!parent)
        return 0;

    return PostMessage(parent, nmsg, wparam, lparam);
}

Referenced by StartMenuButton::WndProc().

pretranslate_msg()

BOOL Window::pretranslate_msg ( LPMSG  pmsg )

static

Definition at line 589 of file window.cpp.

{
    if ((pmsg->message != WM_KEYDOWN) &&
        (pmsg->message != WM_SYSKEYDOWN) &&
        (pmsg->message != WM_SYSCHAR) &&
        (pmsg->message != WM_CHAR))
    {
        return FALSE;
    }

    for(WindowSet::const_iterator it=Window::s_pretranslate_windows.begin(); it!=s_pretranslate_windows.end(); ++it)
        if (SendMessage(*it, PM_TRANSLATE_MSG, 0, (LPARAM)pmsg))
            return TRUE;

    return FALSE;
}

Referenced by PropertySheetDialog::DoModal(), MessageLoop(), and StartMenuRoot::TrackStartmenu().

PropSheetCBTHookProc()

LRESULT CALLBACK Window::PropSheetCBTHookProc ( int  code, WPARAM  wparam, LPARAM  lparam  )

staticprotected

Definition at line 185 of file window.cpp.

{
    if (code == HCBT_CREATEWND) {
        HWND hwnd = (HWND)wparam;

         // create Window controller and associate it with the window handle
        Window* child = get_window(hwnd);

        if (!child)
            child = create_controller(hwnd);
    }

    return CallNextHookEx(s_hcbtHook, code, wparam, lparam);
}

register_dialog()

void Window::register_dialog ( HWND  hwnd )

static

Definition at line 609 of file window.cpp.

{
    s_dialogs.insert(hwnd);
}

Referenced by Dialog::Dialog(), and DialogWindow::DialogWindow().

register_pretranslate()

void Window::register_pretranslate ( HWND  hwnd )

static

Definition at line 579 of file window.cpp.

{
    s_pretranslate_windows.insert(hwnd);
}

Referenced by FindProgramDlg::FindProgramDlg(), PreTranslateWindow::PreTranslateWindow(), and TrayNotifyDlg::TrayNotifyDlg().

SendParent()

LRESULT Window::SendParent	(	UINT	nmsg,
		WPARAM	wparam = 0,
		LPARAM	lparam = 0
	)

Definition at line 657 of file window.cpp.

{
    HWND parent = GetParent(_hwnd);

    if (!parent)
        return 0;

    return SendMessage(parent, nmsg, wparam, lparam);
}

Referenced by StartMenu::CloseStartMenu(), NotifyArea::Command(), StartMenuButton::WndProc(), StartMenu::WndProc(), EditController::WndProc(), and StartMenu::~StartMenu().

unregister_dialog()

void Window::unregister_dialog ( HWND  hwnd )

static

Definition at line 614 of file window.cpp.

{
    s_dialogs.erase(hwnd);
}

Referenced by Dialog::~Dialog(), and DialogWindow::~DialogWindow().

unregister_pretranslate()

void Window::unregister_pretranslate ( HWND  hwnd )

static

Definition at line 584 of file window.cpp.

{
    s_pretranslate_windows.erase(hwnd);
}

Referenced by FindProgramDlg::~FindProgramDlg(), PreTranslateWindow::~PreTranslateWindow(), and TrayNotifyDlg::~TrayNotifyDlg().

WindowWndProc()

LRESULT CALLBACK Window::WindowWndProc ( HWND  hwnd, UINT  nmsg, WPARAM  wparam, LPARAM  lparam  )

static

Definition at line 247 of file window.cpp.

{
    Window* pThis = get_window(hwnd);

    if (!pThis)
        pThis = create_controller(hwnd);

    if (pThis) {
        switch(nmsg) {
          case WM_COMMAND:
            return pThis->Command(LOWORD(wparam), HIWORD(wparam));

          case WM_NOTIFY:
            return pThis->Notify(wparam, (NMHDR*)lparam);

          case WM_NOTIFYFORMAT:
            return NFR_CURRENT;

          case WM_CREATE:
            return pThis->Init((LPCREATESTRUCT)lparam);

          case WM_NCDESTROY:
            delete pThis;
            return 0;

          default:
            return pThis->WndProc(nmsg, wparam, lparam);
        }
    }
    else
        return DefWindowProc(hwnd, nmsg, wparam, lparam);
}

WndProc()

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

protectedvirtual

Reimplemented in ExtContextMenuHandlerT< ShellBrowserChildT< MainFrameBase > >, ExtContextMenuHandlerT< ChildWindow >, ExtContextMenuHandlerT< OwnerDrawParent< DialogWindow > >, ExtContextMenuHandlerT< SubclassedWindow >, ExtContextMenuHandlerT< ShellBrowserChildT< ChildWindow > >, EditController, WebChildWindow, ExplorerAboutDlg, HyperlinkCtrl, ColorStatic, FlatButton, OwnerdrawnButton, OwnerDrawParent< PropSheetPageDlg >, OwnerDrawParent< Window >, OwnerDrawParent< DialogWindow >, OwnerDrawParent< Dialog >, CtlColorParent< OwnerDrawParent< Dialog > >, ResizeController< Dialog >, Dialog, StartMenuRoot, IPCtrlWindow< ChildWindow, SIfacePtr< IWebBrowser2 > >, ChildWindow, MDIShellBrowserChild, ClockWindow, TrayNotifyDlg, StartMenu, ShellBrowserChildT< ChildWindow >, ShellBrowserChildT< MainFrameBase >, SubclassedWindow, DesktopShellView, SDIMainFrame, NotifyArea, StartButton, MDIMainFrame, Pane, DesktopBar, StartMenuButton, FindProgramDlg, FileChildWindow, TaskBar, DesktopWindow, MainFrameBase, QuickLaunchBar, and BackgroundWindow.

Definition at line 280 of file window.cpp.

{
    return DefWindowProc(_hwnd, nmsg, wparam, lparam);
}

Referenced by DialogProc(), WindowWndProc(), MainFrameBase::WndProc(), DesktopWindow::WndProc(), TaskBar::WndProc(), NotifyArea::WndProc(), and ClockWindow::WndProc().

Member Data Documentation

IAccessible_iface

IAccessible Window::IAccessible_iface

Definition at line 29 of file window.c.

IEnumVARIANT_iface

IEnumVARIANT Window::IEnumVARIANT_iface

Definition at line 31 of file window.c.

IOleWindow_iface

IOleWindow Window::IOleWindow_iface

Definition at line 30 of file window.c.

ref

LONG Window::ref

Definition at line 33 of file window.c.

s_dialogs

WindowSet Window::s_dialogs

staticprotected

Definition at line 138 of file window.h.

Referenced by dispatch_dialog_msg(), register_dialog(), and unregister_dialog().

s_hcbtHook

HHOOK Window::s_hcbtHook = 0

staticprotected

Definition at line 133 of file window.h.

Referenced by create_mdi_child(), MDICBTHookProc(), and PropSheetCBTHookProc().

s_new_info

const void * Window::s_new_info = NULL

staticprotected

Definition at line 119 of file window.h.

Referenced by Create(), create_controller(), create_mdi_child(), and Dialog::DoModal().

s_pretranslate_windows

WindowSet Window::s_pretranslate_windows

staticprotected

Definition at line 137 of file window.h.

Referenced by pretranslate_msg(), register_pretranslate(), and unregister_pretranslate().

s_window_creator

Window::CREATORFUNC Window::s_window_creator = NULL

staticprotected

Definition at line 120 of file window.h.

Referenced by Create(), create_controller(), create_mdi_child(), and Dialog::DoModal().

s_wnd_map

Window::WindowMap Window::s_wnd_map

staticprotected

Definition at line 117 of file window.h.

Referenced by get_window(), Window(), and ~Window().

---

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

• dll/win32/oleacc/window.c
• modules/rosapps/applications/explorer-old/utility/window.h
• modules/rosapps/applications/explorer-old/utility/window.cpp