blob: b17930efa7e0b72de4e023aa0823d6977e7be73f [file] [log] [blame]
// Copyright (c) 2013 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 UI_AURA_CLIENT_WINDOW_PARENTING_CLIENT_H_
#define UI_AURA_CLIENT_WINDOW_PARENTING_CLIENT_H_
#include "ui/aura/aura_export.h"
namespace gfx {
class Rect;
}
namespace aura {
class Window;
namespace client {
// Implementations of this object are used to help locate a default parent for
// NULL-parented Windows.
class AURA_EXPORT WindowParentingClient {
public:
virtual ~WindowParentingClient() {}
// Called by the Window when it looks for a default parent. Returns the
// window that |window| should be added to instead. |context| provides a
// Window (generally a RootWindow) that can be used to determine which
// desktop type the default parent should be chosen from. NOTE: this may
// have side effects. It should only be used when |window| is going to be
// immediately added.
//
// TODO(erg): Remove |context|, and maybe after oshima's patch lands,
// |bounds|.
virtual Window* GetDefaultParent(Window* context,
Window* window,
const gfx::Rect& bounds) = 0;
};
// Set/Get a window tree client for the RootWindow containing |window|. |window|
// must not be NULL.
AURA_EXPORT void SetWindowParentingClient(
Window* window,
WindowParentingClient* window_tree_client);
WindowParentingClient* GetWindowParentingClient(Window* window);
// Adds |window| to an appropriate parent by consulting an implementation of
// WindowParentingClient attached at the root Window containing |context|. The
// final
// location may be a window hierarchy other than the one supplied via
// |context|, which must not be NULL. |screen_bounds| may be empty.
AURA_EXPORT void ParentWindowWithContext(Window* window,
Window* context,
const gfx::Rect& screen_bounds);
} // namespace client
} // namespace aura
#endif // UI_AURA_CLIENT_WINDOW_PARENTING_CLIENT_H_