Index: chrome/browser/window_sizer.h |
=================================================================== |
--- chrome/browser/window_sizer.h (revision 68008) |
+++ chrome/browser/window_sizer.h (working copy) |
@@ -1,184 +0,0 @@ |
-// Copyright (c) 2010 The Chromium Authors. All rights reserved. |
-// Use of this source code is governed by a BSD-style license that can be |
-// found in the LICENSE file. |
- |
-#ifndef CHROME_BROWSER_WINDOW_SIZER_H_ |
-#define CHROME_BROWSER_WINDOW_SIZER_H_ |
-#pragma once |
- |
-#include <vector> |
- |
-#include "base/basictypes.h" |
-#include "gfx/rect.h" |
- |
-class Browser; |
- |
-/////////////////////////////////////////////////////////////////////////////// |
-// WindowSizer |
-// |
-// A class that determines the best new size and position for a window to be |
-// shown at based several factors, including the position and size of the last |
-// window of the same type, the last saved bounds of the window from the |
-// previous session, and default system metrics if neither of the above two |
-// conditions exist. The system has built-in providers for monitor metrics |
-// and persistent storage (using preferences) but can be overrided with mocks |
-// for testing. |
-// |
-class WindowSizer { |
- public: |
- class MonitorInfoProvider; |
- class StateProvider; |
- |
- // The WindowSizer assumes ownership of these objects. |
- WindowSizer(StateProvider* state_provider, |
- MonitorInfoProvider* monitor_info_provider); |
- virtual ~WindowSizer(); |
- |
- // Static factory methods to create default MonitorInfoProvider |
- // instances. The returned object is owned by the caller. |
- static MonitorInfoProvider* CreateDefaultMonitorInfoProvider(); |
- |
- // An interface implemented by an object that can retrieve information about |
- // the monitors on the system. |
- class MonitorInfoProvider { |
- public: |
- MonitorInfoProvider(); |
- virtual ~MonitorInfoProvider(); |
- |
- // Returns the bounds of the work area of the primary monitor. |
- virtual gfx::Rect GetPrimaryMonitorWorkArea() const = 0; |
- |
- // Returns the bounds of the primary monitor. |
- virtual gfx::Rect GetPrimaryMonitorBounds() const = 0; |
- |
- // Returns the bounds of the work area of the monitor that most closely |
- // intersects the provided bounds. |
- virtual gfx::Rect GetMonitorWorkAreaMatching( |
- const gfx::Rect& match_rect) const = 0; |
- |
- // Returns the delta between the work area and the monitor bounds for the |
- // monitor that most closely intersects the provided bounds. |
- virtual gfx::Point GetBoundsOffsetMatching( |
- const gfx::Rect& match_rect) const = 0; |
- |
- // Ensures number and coordinates of work areas are up-to-date. You must |
- // call this before calling either of the below functions, as work areas can |
- // change while the program is running. |
- virtual void UpdateWorkAreas() = 0; |
- |
- // Returns the number of monitors on the system. |
- size_t GetMonitorCount() const { |
- return work_areas_.size(); |
- } |
- |
- // Returns the bounds of the work area of the monitor at the specified |
- // index. |
- gfx::Rect GetWorkAreaAt(size_t index) const { |
- return work_areas_[index]; |
- } |
- |
- protected: |
- std::vector<gfx::Rect> work_areas_; |
- }; |
- |
- // An interface implemented by an object that can retrieve state from either a |
- // persistent store or an existing window. |
- class StateProvider { |
- public: |
- virtual ~StateProvider() { } |
- |
- // Retrieve the persisted bounds of the window. Returns true if there was |
- // persisted data to retrieve state information, false otherwise. |
- virtual bool GetPersistentState(gfx::Rect* bounds, |
- bool* maximized, |
- gfx::Rect* work_area) const = 0; |
- |
- // Retrieve the bounds of the most recent window of the matching type. |
- // Returns true if there was a last active window to retrieve state |
- // information from, false otherwise. |
- virtual bool GetLastActiveWindowState(gfx::Rect* bounds) const = 0; |
- }; |
- |
- // Determines the position, size and maximized state for a window as it is |
- // created. This function uses several strategies to figure out optimal size |
- // and placement, first looking for an existing active window, then falling |
- // back to persisted data from a previous session, finally utilizing a default |
- // algorithm. If |specified_bounds| are non-empty, this value is returned |
- // instead. For use only in testing. |
- // |
- // NOTE: |maximized| is only set if we're restoring a saved maximized window. |
- // When creating a new window based on an existing active window, standard |
- // Windows behavior is to have it always be nonmaximized, even if the existing |
- // window is maximized. |
- void DetermineWindowBounds(const gfx::Rect& specified_bounds, |
- gfx::Rect* bounds, |
- bool* maximized) const; |
- |
- // Determines the size, position and maximized state for the browser window. |
- // See documentation for DetermineWindowBounds above. Normally, |
- // |window_bounds| is calculated by calling GetLastActiveWindowState(). To |
- // explicitly specify a particular window to base the bounds on, pass in a |
- // non-NULL value for |browser|. |
- static void GetBrowserWindowBounds(const std::string& app_name, |
- const gfx::Rect& specified_bounds, |
- Browser* browser, |
- gfx::Rect* window_bounds, |
- bool* maximized); |
- |
- // Returns the default origin for popups of the given size. |
- static gfx::Point GetDefaultPopupOrigin(const gfx::Size& size); |
- |
- // How much horizontal and vertical offset there is between newly |
- // opened windows. This value may be different on each platform. |
- static const int kWindowTilePixels; |
- |
- private: |
- // The edge of the screen to check for out-of-bounds. |
- enum Edge { TOP, LEFT, BOTTOM, RIGHT }; |
- |
- explicit WindowSizer(const std::string& app_name); |
- |
- void Init(StateProvider* state_provider, |
- MonitorInfoProvider* monitor_info_provider); |
- |
- // Gets the size and placement of the last window. Returns true if this data |
- // is valid, false if there is no last window and the application should |
- // restore saved state from preferences using RestoreWindowPosition. |
- bool GetLastWindowBounds(gfx::Rect* bounds) const; |
- |
- // Gets the size and placement of the last window in the last session, saved |
- // in local state preferences. Returns true if local state exists containing |
- // this information, false if this information does not exist and a default |
- // size should be used. |
- bool GetSavedWindowBounds(gfx::Rect* bounds, bool* maximized) const; |
- |
- // Gets the default window position and size if there is no last window and |
- // no saved window placement in prefs. This function determines the default |
- // size based on monitor size, etc. |
- void GetDefaultWindowBounds(gfx::Rect* default_bounds) const; |
- |
- // Returns true if the specified position is "offscreen" for the given edge, |
- // meaning that it's outside all work areas in the direction of that edge. |
- bool PositionIsOffscreen(int position, Edge edge) const; |
- |
- // Adjusts |bounds| to be visible onscreen, biased toward the work area of the |
- // monitor containing |other_bounds|. Despite the name, this doesn't |
- // guarantee the bounds are fully contained within this monitor's work rect; |
- // it just tried to ensure the edges are visible on _some_ work rect. |
- // If |saved_work_area| is non-empty, it is used to determine whether the |
- // monitor cofiguration has changed. If it has, bounds are repositioned and |
- // resized if necessary to make them completely contained in the current work |
- // area. |
- void AdjustBoundsToBeVisibleOnMonitorContaining( |
- const gfx::Rect& other_bounds, |
- const gfx::Rect& saved_work_area, |
- gfx::Rect* bounds) const; |
- |
- // Providers for persistent storage and monitor metrics. |
- StateProvider* state_provider_; |
- MonitorInfoProvider* monitor_info_provider_; |
- |
- DISALLOW_COPY_AND_ASSIGN(WindowSizer); |
-}; |
- |
-#endif // CHROME_BROWSER_WINDOW_SIZER_H_ |