1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
|
/*
* Copyright (c) 2008, 2015, Oracle and/or its affiliates. All rights reserved.
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License as
* published by the Free Software Foundation; version 2 of the
* License.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA
*/
#pragma once
#include <map>
#include "mforms/dockingpoint.h"
#include "base/geometry.h"
#include "base/drawing.h"
namespace mforms {
// Known system colors.
enum SystemColor
{
SystemColorHighlight, // The system-defined color of the background of selected items.
// This includes selected menu items as well as selected text.
SystemColorEditor, // Background color for editor controls.
SystemColorDisabled, // Background color for disabled controls.
SystemColorContainer, // Usually a gray. The default background for container controls. TODO: Linux.
};
class App;
class AppView;
class View;
#ifndef DOXYGEN_SHOULD_SKIP_THIS
#ifndef SWIG
struct AppImplPtrs
{
void (*set_status_text)(App *app, const std::string &title);
std::string (*get_resource_path)(App *app, const std::string &file);
std::string (*get_executable_path)(App *app, const std::string &file);
base::Rect (*get_application_bounds)(App *app);
int (*enter_event_loop)(App *app, float max_wait_time);
void (*exit_event_loop)(App *app, int result);
base::Color (*get_system_color)(SystemColor type);
float (*backing_scale_factor)(App *app);
};
#endif
#endif
/** Proxy class for interfacing with the host application window.
Provides some utility functions to perform certain actions in the main window
of the host application. This class uses a singleton.
*/
class MFORMS_EXPORT App : public DockingPoint
{
private:
App() : DockingPoint() {}
App(DockingPointDelegate *delegate, bool delete_on_destroy);
public:
#ifndef SWIG
// for use by host application
static void instantiate(DockingPointDelegate *delegate, bool delete_on_destroy);
#endif
public:
/** Gets the instance of the App class.
*/
static App *get();
/** Sets the status text at the bottom of the window.
*/
void set_status_text(const std::string &text);
/** Gets the path to a resource file bundled in the application.
Passing an empty string will return the path to the resource directory. */
std::string get_resource_path(const std::string &file);
std::string get_executable_path(const std::string &file);
std::string get_user_data_folder() { return _user_data_folder; }
/** Gets the bounds of the main window. */
base::Rect get_application_bounds();
/** Enters the event loop and exit only once exit_event_loop() is called.
@param timeout Given in seconds. If > 0.0, the function will return -1 after that time.
*/
int enter_event_loop(float timeout = 0.0);
/** Exits from enter_event_loop() */
void exit_event_loop(int retcode);
// Retrieve system information like predefined colors, screen size, monitor count etc.
base::Color get_system_color(SystemColor type);
float backing_scale_factor();
#ifndef DOXYGEN_SHOULD_SKIP_THIS
#ifndef SWIG
void set_user_data_folder_path(const std::string &path) { _user_data_folder = path; }
#endif
#endif
protected:
AppImplPtrs *_app_impl;
private:
std::string _user_data_folder;
};
};
|
