chromium/ui/aura/client/window_parenting_client.h

// Copyright 2013 The Chromium Authors
// 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 <cstdint>

#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 { … };

// 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);

AURA_EXPORT WindowParentingClient* GetWindowParentingClient(Window* window);

// Adds |window| to an appropriate parent by consulting an implementation of
// WindowParentingClient attached at the root Window resolved by 'context',
// 'screen_bounds' and 'display_id'. 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 and `display_id` maybe invalid.
AURA_EXPORT void ParentWindowWithContext(Window* window,
                                         Window* context,
                                         const gfx::Rect& screen_bounds,
                                         const int64_t display_id);

}  // namespace client
}  // namespace aura

#endif  // UI_AURA_CLIENT_WINDOW_PARENTING_CLIENT_H_