Molybden API
Loading...
Searching...
No Matches
browser.hpp
1// Copyright (c) 2000-2023 TeamDev Ltd. All rights reserved.
2// TeamDev PROPRIETARY and CONFIDENTIAL.
3// Use is subject to license terms.
4
5#ifndef MOLYBDEN_BROWSER_HPP
6#define MOLYBDEN_BROWSER_HPP
7
8#include <memory>
9#include <unordered_set>
10
11#include "molybden/app/app.hpp"
12#include "molybden/browser/browser_delegates.hpp"
13#include "molybden/browser/browser_events.hpp"
14#include "molybden/ui/geometry.hpp"
15#include "molybden/ui/window.hpp"
16
17namespace molybden {
18
19class CaptureSession;
20class BrowserSettings;
21class Dialogs;
22class DevTools;
23class Frame;
24class FullScreen;
25class Media;
26class Navigation;
27class Profile;
28class TextFinder;
29class Zoom;
30class JavaScript;
31class JsValue;
32
48class Browser : public BrowserEvents, public BrowserDelegates {
49 public:
55 static std::shared_ptr<Browser> create(std::shared_ptr<App> app);
56
62 static std::shared_ptr<Browser> create(std::shared_ptr<Profile> profile);
63
67 virtual std::shared_ptr<App> app() = 0;
68
72 virtual std::shared_ptr<Profile> profile() = 0;
73
77 virtual std::shared_ptr<BrowserSettings> settings() = 0;
78
82 virtual std::shared_ptr<Media> media() = 0;
83
87 virtual std::shared_ptr<Navigation> navigation() = 0;
88
92 virtual std::shared_ptr<FullScreen> fullScreen() = 0;
93
97 virtual std::shared_ptr<DevTools> devTools() = 0;
98
102 virtual std::shared_ptr<TextFinder> textFinder() = 0;
103
108 virtual std::shared_ptr<Zoom> zoom() = 0;
109
114 virtual std::string pageUrl() = 0;
115
120 virtual std::string pageTitle() = 0;
121
126 virtual std::shared_ptr<Frame> mainFrame() = 0;
127
132 virtual std::shared_ptr<Frame> focusedFrame() = 0;
133
138 virtual std::unordered_set<std::shared_ptr<Frame>> frames() = 0;
139
143 virtual std::vector<std::shared_ptr<CaptureSession>> captureSessions() = 0;
144
157 virtual void loadUrl(const std::string& url) = 0;
158
174 virtual JsValue executeJavaScript(const std::string& script) = 0;
175
188 virtual void executeJavaScript(const std::string& script,
189 std::function<void(JsValue)> callback) = 0;
190
194 virtual void setSize(const Size& size) = 0;
195
199 virtual void setSize(uint32_t width, uint32_t height) = 0;
200
204 virtual void setPosition(const Point& position_on_screen) = 0;
205
209 virtual void setPosition(int32_t x, int32_t y) = 0;
210
216 virtual void setBounds(const Rect& bounds) = 0;
217
221 virtual Rect bounds() = 0;
222
226 virtual void centerWindow() = 0;
227
231 virtual void show() = 0;
232
236 virtual bool isVisible() = 0;
237
241 virtual void hide() = 0;
242
255 virtual void close() = 0;
256
260 virtual bool isClosed() = 0;
261
266 virtual void activate() = 0;
267
271 virtual bool isActive() = 0;
272
277 virtual void deactivate() = 0;
278
282 virtual void maximize() = 0;
283
287 virtual bool isMaximized() = 0;
288
292 virtual void minimize() = 0;
293
297 virtual bool isMinimized() = 0;
298
302 virtual void restore() = 0;
303
310 virtual void enterFullScreen() = 0;
311
315 virtual bool isFullScreen() = 0;
316
323 virtual void exitFullScreen() = 0;
324
335 virtual void setTitle(const std::string& title) = 0;
336
343 virtual std::string title() = 0;
344
348 virtual void setWindowTitleVisible(bool visible) = 0;
349
353 virtual bool isWindowTitleVisible() = 0;
354
367 virtual void setWindowTitlebarVisible(bool visible) = 0;
368
372 virtual bool isWindowTitlebarVisible() = 0;
373
377 virtual void setWindowButtonVisible(WindowButtonType button_type,
378 bool visible) = 0;
379
384 virtual bool isWindowButtonVisible(WindowButtonType button_type) = 0;
385};
386
387} // namespace molybden
388
389#endif // MOLYBDEN_BROWSER_HPP
A class that contains all browser delegates.
Definition browser_delegates.hpp:1439
A class that contains all browser events.
Definition browser_events.hpp:310
An object that displays web content inside a native window.
Definition browser.hpp:48
virtual void setPosition(const Point &position_on_screen)=0
Sets the browser window's position on screen.
virtual std::string title()=0
Returns the current browser window title.
virtual std::shared_ptr< DevTools > devTools()=0
Returns the DevTools of this browser.
virtual std::shared_ptr< Zoom > zoom()=0
Returns a service that allows zooming content of a web page loaded in the current browser.
virtual std::shared_ptr< App > app()=0
Returns the application instance for this browser.
virtual void executeJavaScript(const std::string &script, std::function< void(JsValue)> callback)=0
Executes the given script in the main frame of this browser and returns the result of the execution.
virtual void exitFullScreen()=0
Brings the browser window out of full screen mode.
virtual void deactivate()=0
Deactivates the browser window, making the next window in the Z order the active window.
virtual void close()=0
Hides and destroys the browser window and releases all allocated resources including the browser inst...
virtual void setWindowButtonVisible(WindowButtonType button_type, bool visible)=0
Configures visibility of the given standard browser window button.
virtual bool isFullScreen()=0
Indicates whether the browser window is running in full screen mode.
virtual bool isWindowTitleVisible()=0
Indicates whether the title is visible in the browser window title bar.
virtual std::shared_ptr< Navigation > navigation()=0
Returns the navigation controller of this browser.
virtual std::shared_ptr< BrowserSettings > settings()=0
Returns the content settings of this browser.
static std::shared_ptr< Browser > create(std::shared_ptr< Profile > profile)
Creates a new browser instance.
virtual void setWindowTitlebarVisible(bool visible)=0
Configures visibility of the browser window title bar.
virtual void setTitle(const std::string &title)=0
Updates the browser window title.
virtual std::vector< std::shared_ptr< CaptureSession > > captureSessions()=0
Returns the list of all active capture sessions initiated by this browser.
virtual void restore()=0
Restores the browser window.
virtual void hide()=0
Hides the browser window.
virtual std::string pageTitle()=0
Returns a string that represents the title of the currently loaded web page or an empty string if the...
virtual void setPosition(int32_t x, int32_t y)=0
Sets the browser window's position on screen.
virtual void minimize()=0
Minimizes the browser window.
virtual void setBounds(const Rect &bounds)=0
Sets the browser window's size and location on screen.
virtual bool isActive()=0
Indicates if the browser window is currently the active/focused window.
virtual bool isWindowTitlebarVisible()=0
Indicates whether the browser window title bar is visible.
virtual bool isMaximized()=0
Indicates whether the browser window is maximized.
virtual bool isVisible()=0
Indicates whether the browser window is visible.
virtual bool isWindowButtonVisible(WindowButtonType button_type)=0
Indicates whether the standard browser window button with the given type is visible.
virtual void centerWindow()=0
Centers the browser window on the primary screen.
virtual void maximize()=0
Maximizes the browser window.
static std::shared_ptr< Browser > create(std::shared_ptr< App > app)
Creates a new browser instance.
virtual bool isMinimized()=0
Indicates whether the browser window is minimized.
virtual void loadUrl(const std::string &url)=0
Starts a navigation to the resource identified by the given url.
virtual std::string pageUrl()=0
Gets URL of the currently loaded web page or an empty string if the browser hasn't loaded any web pag...
virtual Rect bounds()=0
Returns the browser window's size and position on screen.
virtual bool isClosed()=0
Checks if the browser window is closed.
virtual void enterFullScreen()=0
Sets the browser window to full screen.
virtual void setSize(const Size &size)=0
Sets the browser window's size.
virtual JsValue executeJavaScript(const std::string &script)=0
Executes the given script in the main frame of this browser and returns the result of the execution.
virtual std::shared_ptr< TextFinder > textFinder()=0
Returns the text finder of this browser.
virtual std::shared_ptr< FullScreen > fullScreen()=0
Returns the fullscreen controller of this browser.
virtual std::shared_ptr< Profile > profile()=0
Returns the profile of this browser.
virtual std::unordered_set< std::shared_ptr< Frame > > frames()=0
Returns all the frames on the currently loaded web page or an empty set if the current browser did no...
virtual void setWindowTitleVisible(bool visible)=0
Configures visibility of the title in the browser window title bar.
virtual std::shared_ptr< Frame > focusedFrame()=0
Returns the focused frame of the currently loaded web page if it exists, otherwise an empty std::shar...
virtual void activate()=0
Activates (brings to front) the browser window.
virtual std::shared_ptr< Frame > mainFrame()=0
Returns the main frame of the currently loaded web page if it exists, otherwise an empty std::shared_...
virtual void show()=0
Shows the browser window, or activates it if it's already visible.
virtual std::shared_ptr< Media > media()=0
Returns the media controller of this browser.
virtual void setSize(uint32_t width, uint32_t height)=0
Sets the browser window's size.
A JavaScript value.
Definition js_value.hpp:44
A pair of numbers that in general are used to define coordinates in the two-dimensional space.
Definition geometry.hpp:16
A rectangle described by the location and dimensions.
Definition geometry.hpp:75
A pair of numbers that in general are used to define dimensions in the two-dimensional space.
Definition geometry.hpp:35