ui/gfx/win/window_impl.h

   1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef UI_GFX_WIN_WINDOW_IMPL_H_
   6 #define UI_GFX_WIN_WINDOW_IMPL_H_
   7
   8 #include <string>
   9
  10 #include "base/logging.h"
  11 #include "ui/gfx/gfx_export.h"
  12 #include "ui/gfx/native_widget_types.h"
  13 #include "ui/gfx/rect.h"
  14 #include "ui/gfx/win/msg_util.h"
  15
  16 namespace gfx {
  17
  18 // An interface implemented by classes that use message maps.
  19 // ProcessWindowMessage is implemented by the BEGIN_MESSAGE_MAP_EX macro.
  20 class MessageMapInterface {
  21  public:
  22   // Processes one message from the window's message queue.
  23   virtual BOOL ProcessWindowMessage(HWND window,
  24                                     UINT message,
  25                                     WPARAM w_param,
  26                                     LPARAM l_param,
  27                                     LRESULT& result,
  28                                     DWORD msg_map_id = 0) = 0;
  29 };
  30
  31 ///////////////////////////////////////////////////////////////////////////////
  32 //
  33 // WindowImpl
  34 //  A convenience class that encapsulates the details of creating and
  35 //  destroying a HWND.  This class also hosts the windows procedure used by all
  36 //  Windows.
  37 //
  38 ///////////////////////////////////////////////////////////////////////////////
  39 class GFX_EXPORT WindowImpl : public MessageMapInterface {
  40  public:
  41   WindowImpl();
  42   virtual ~WindowImpl();
  43
  44   // Initializes the Window with a parent and an initial desired size.
  45   void Init(HWND parent, const gfx::Rect& bounds);
  46
  47   // Returns the default window icon to use for windows of this type.
  48   virtual HICON GetDefaultWindowIcon() const;
  49
  50   // Returns the HWND associated with this Window.
  51   HWND hwnd() const { return hwnd_; }
  52
  53   // Sets the window styles. This is ONLY used when the window is created.
  54   // In other words, if you invoke this after invoking Init, nothing happens.
  55   void set_window_style(DWORD style) { window_style_ = style; }
  56   DWORD window_style() const { return window_style_; }
  57
  58   // Sets the extended window styles. See comment about |set_window_style|.
  59   void set_window_ex_style(DWORD style) { window_ex_style_ = style; }
  60   DWORD window_ex_style() const { return window_ex_style_; }
  61
  62   // Sets the class style to use. The default is CS_DBLCLKS.
  63   void set_initial_class_style(UINT class_style) {
  64     // We dynamically generate the class name, so don't register it globally!
  65     DCHECK_EQ((class_style & CS_GLOBALCLASS), 0u);
  66     class_style_ = class_style;
  67   }
  68   UINT initial_class_style() const { return class_style_; }
  69
  70  protected:
  71   // Handles the WndProc callback for this object.
  72   virtual LRESULT OnWndProc(UINT message, WPARAM w_param, LPARAM l_param);
  73
  74   // Subclasses must call this method from their destructors to ensure that
  75   // this object is properly disassociated from the HWND during destruction,
  76   // otherwise it's possible this object may still exist while a subclass is
  77   // destroyed.
  78   void ClearUserData();
  79
  80  private:
  81   friend class ClassRegistrar;
  82
  83   // The window procedure used by all Windows.
  84   static LRESULT CALLBACK WndProc(HWND window,
  85                                   UINT message,
  86                                   WPARAM w_param,
  87                                   LPARAM l_param);
  88
  89   // Gets the window class atom to use when creating the corresponding HWND.
  90   // If necessary, this registers the window class.
  91   ATOM GetWindowClassAtom();
  92
  93   // All classes registered by WindowImpl start with this name.
  94   static const wchar_t* const kBaseClassName;
  95
  96   // Window Styles used when creating the window.
  97   DWORD window_style_;
  98
  99   // Window Extended Styles used when creating the window.
 100   DWORD window_ex_style_;
 101
 102   // Style of the class to use.
 103   UINT class_style_;
 104
 105   // Our hwnd.
 106   HWND hwnd_;
 107
 108   // For debugging.
 109   // TODO(sky): nuke this when get crash data.
 110   bool got_create_;
 111   bool got_valid_hwnd_;
 112   bool* destroyed_;
 113
 114   DISALLOW_COPY_AND_ASSIGN(WindowImpl);
 115 };
 116
 117 }  // namespace gfx
 118
 119 #endif  // UI_GFX_WIN_WINDOW_IMPL_H_