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 <unordered_set>
9
10#include "molybden/app/app.hpp"
11#include "molybden/browser/browser_delegates.hpp"
12#include "molybden/browser/browser_events.hpp"
13#include "molybden/ui/geometry.hpp"
14#include "molybden/ui/window.hpp"
15
16namespace molybden {
17
18class CaptureSession;
19class BrowserSettings;
20class Dialogs;
21class DevTools;
22class Frame;
23class FullScreen;
24class Media;
25class Navigation;
26class Profile;
27class TextFinder;
28class Zoom;
29class JavaScript;
30class JsValue;
31
47class Browser : public BrowserEvents, public BrowserDelegates {
48 public:
54 static std::shared_ptr<Browser> create(std::shared_ptr<App> app);
55
61 static std::shared_ptr<Browser> create(std::shared_ptr<Profile> profile);
62
66 virtual std::shared_ptr<App> app() = 0;
67
71 virtual std::shared_ptr<Profile> profile() = 0;
72
76 virtual std::shared_ptr<BrowserSettings> settings() = 0;
77
81 virtual std::shared_ptr<Media> media() = 0;
82
86 virtual std::shared_ptr<Navigation> navigation() = 0;
87
91 virtual std::shared_ptr<DevTools> devTools() = 0;
92
96 virtual std::shared_ptr<TextFinder> textFinder() = 0;
97
102 virtual std::shared_ptr<Zoom> zoom() = 0;
103
108 virtual std::string pageUrl() = 0;
109
114 virtual std::string pageTitle() = 0;
115
120 virtual std::shared_ptr<Frame> mainFrame() = 0;
121
126 virtual std::shared_ptr<Frame> focusedFrame() = 0;
127
132 virtual std::unordered_set<std::shared_ptr<Frame>> frames() = 0;
133
137 virtual std::vector<std::shared_ptr<CaptureSession>> captureSessions() = 0;
138
151 virtual void loadUrl(const std::string& url) = 0;
152
168 virtual JsValue executeJavaScript(const std::string& script) = 0;
169
182 virtual void executeJavaScript(const std::string& script,
183 std::function<void(JsValue)> callback) = 0;
184
188 virtual void setSize(const Size& size) = 0;
189
193 virtual void setSize(uint32_t width, uint32_t height) = 0;
194
198 virtual void setPosition(const Point& position_on_screen) = 0;
199
203 virtual void setPosition(int32_t x, int32_t y) = 0;
204
210 virtual void setBounds(const Rect& bounds) = 0;
211
215 virtual Rect bounds() = 0;
216
220 virtual void centerWindow() = 0;
221
225 virtual void show() = 0;
226
230 virtual bool isVisible() = 0;
231
235 virtual void hide() = 0;
236
249 virtual void close() = 0;
250
254 virtual bool isClosed() = 0;
255
260 virtual void activate() = 0;
261
265 virtual bool isActive() = 0;
266
271 virtual void deactivate() = 0;
272
276 virtual void maximize() = 0;
277
281 virtual bool isMaximized() = 0;
282
286 virtual void minimize() = 0;
287
291 virtual bool isMinimized() = 0;
292
296 virtual void restore() = 0;
297
304 virtual void enterFullScreen() = 0;
305
309 virtual bool isFullScreen() = 0;
310
317 virtual void exitFullScreen() = 0;
318
329 virtual void setTitle(const std::string& title) = 0;
330
337 virtual std::string title() = 0;
338
342 virtual void setWindowTitleVisible(bool visible) = 0;
343
347 virtual bool isWindowTitleVisible() = 0;
348
361 virtual void setWindowTitlebarVisible(bool visible) = 0;
362
366 virtual bool isWindowTitlebarVisible() = 0;
367
371 virtual void setWindowButtonVisible(WindowButtonType button_type,
372 bool visible) = 0;
373
378 virtual bool isWindowButtonVisible(WindowButtonType button_type) = 0;
379};
380
381} // namespace molybden
382
383#endif // MOLYBDEN_BROWSER_HPP
A class that contains all browser delegates.
Definition browser_delegates.hpp:1143
A class that contains all browser events.
Definition browser_events.hpp:315
An object that displays web content inside a native window.
Definition browser.hpp:47
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< 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