/// /// @file Overlay.h /// /// @brief The header for the Overlay class. /// /// @author /// /// This file is a part of Ultralight, a fast, lightweight, HTML UI engine /// /// Website: /// /// Copyright (C) 2019 Ultralight, Inc. All rights reserved. /// #pragma once #include "Window.h" #include namespace ultralight { /// /// Web-content overlay. Displays a web-page within an area of the main window. /// /// @note Each Overlay is essentially a View and an on-screen quad. You should /// create the Overlay then load content into the underlying View. /// class AExport Overlay : public RefCounted { public: /// /// Create a new Overlay. /// /// @param window The window to create the Overlay in. (we currently only /// support one window per application) /// /// @param width The width in device coordinates. /// /// @param height The height in device coordinates. /// /// @param x The x-position (offset from the left of the Window), in /// device coordinates. /// /// @param y The y-position (offset from the top of the Window), in /// device coordinates. /// static Ref Create(Ref window, uint32_t width, uint32_t height, int x, int y); /// /// Create a new Overlay, wrapping an existing View. /// /// @param window The window to create the Overlay in. (we currently only /// support one window per application) /// /// @param view The View to wrap (will use its width and height). /// /// @param x The x-position (offset from the left of the Window), in /// device coordinates. /// /// @param y The y-position (offset from the top of the Window), in /// device coordinates. /// static Ref Create(Ref window, Ref view, int x, int y); /// /// Get the underlying View. /// virtual ultralight::Ref view() = 0; /// /// Get the width (in device coordinates). /// virtual uint32_t width() const = 0; /// /// Get the height (in device coordinates). /// virtual uint32_t height() const = 0; /// /// Get the x-position (offset from the left of the Window), in device /// coordinates. /// virtual int x() const = 0; /// /// Get the y-position (offset from the top of the Window), in device /// coordinates. /// virtual int y() const = 0; /// /// Whether or not the overlay is hidden (not drawn). /// virtual bool is_hidden() const = 0; /// /// Hide the overlay (will no longer be drawn) /// virtual void Hide() = 0; /// /// Show the overlay. /// virtual void Show() = 0; /// /// Whether or not this overlay has keyboard focus. /// virtual bool has_focus() const = 0; /// /// Grant this overlay exclusive keyboard focus. /// virtual void Focus() = 0; /// /// Remove keyboard focus. /// virtual void Unfocus() = 0; /// /// Move the overlay to a new position (in device coordinates). /// virtual void MoveTo(int x, int y) = 0; /// /// Resize the overlay (and underlying View), dimensions should be /// specified in device coordinates. /// virtual void Resize(uint32_t width, uint32_t height) = 0; protected: virtual ~Overlay(); virtual void Draw() = 0; friend class OverlayManager; }; } // namespace framework