athena/screen/public/screen_manager.h

// Copyright 2014 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 ATHENA_SCREEN_PUBLIC_SCREEN_MANAGER_H_
#define ATHENA_SCREEN_PUBLIC_SCREEN_MANAGER_H_

#include <string>

#include "athena/athena_export.h"
#include "ui/gfx/display.h"

namespace aura {
class Window;
}

namespace ui {
class LayerAnimator;
}

namespace wm {
class FocusRules;
}

namespace athena {
class ScreenManagerDelegate;

// Mananges basic UI components on the screen such as background, and provide
// API for other UI components, such as window manager, home card, to
// create and manage their windows on the screen.
class ATHENA_EXPORT ScreenManager {
 public:
  struct ContainerParams {
    ContainerParams(const std::string& name, int z_order_priority);
    std::string name;

    // True if the container can activate its child window.
    bool can_activate_children;

    // True if the container will grab all of input events.
    bool grab_inputs;

    // Defines the z_order priority of the container.
    int z_order_priority;
  };

  // Creates, returns and deletes the singleton object of the ScreenManager
  // implementation.
  static ScreenManager* Create(aura::Window* root);
  static ScreenManager* Get();
  static void Shutdown();

  virtual ~ScreenManager() {}

  // Creates the container window that is used when creating a normal
  // widget without specific parent.
  virtual aura::Window* CreateDefaultContainer(
      const ContainerParams& params) = 0;

  // Creates the container window on the screen.
  virtual aura::Window* CreateContainer(const ContainerParams& params) = 0;

  // Return the context object to be used for widget creation.
  virtual aura::Window* GetContext() = 0;

  // Set screen rotation.
  // TODO(flackr): Extract and use ash DisplayManager to set rotation
  // instead: http://crbug.com/401044.
  virtual void SetRotation(gfx::Display::Rotation rotation) = 0;
  virtual void SetRotationLocked(bool rotation_locked) = 0;

  // Returns the LayerAnimator to use to animate the entire screen (e.g. fade
  // screen to white).
  virtual ui::LayerAnimator* GetScreenAnimator() = 0;
};

}  // namespace athena

#endif  // ATHENA_SCREEN_PUBLIC_SCREEN_MANAGER_H_