gtkmm
3.91.2
|
Main application class. More...
#include <gtkmm/main.h>
Public Member Functions | |
Main (bool set_locale=true) | |
Initialization without command-line arguments. More... | |
virtual | ~Main () |
![]() | |
trackable () noexcept | |
trackable (const trackable &src) noexcept | |
trackable (trackable &&src) | |
~trackable () | |
void | add_destroy_notify_callback (void *data, func_destroy_notify func) const |
void | notify_callbacks () |
trackable & | operator= (const trackable &src) |
trackable & | operator= (trackable &&src) |
void | remove_destroy_notify_callback (void *data) const |
Static Public Member Functions | |
static Gtk::Main* | instance () |
Access to the one global instance of Gtk::Main. More... | |
static void | run () |
Start the event loop. More... | |
static void | run (Window& window) |
Returns from the main loop when the window is closed. More... | |
static void | quit () |
Makes the innermost invocation of the main loop return when it regains control. More... | |
static guint | level () |
static bool | iteration (bool blocking=true) |
Runs a single iteration of the main loop. More... | |
static bool | events_pending () |
Checks if any events are pending. More... | |
static void | init_gtkmm_internals () |
Initialize the table of wrap_new functions. More... | |
Protected Member Functions | |
void | init (bool set_locale) |
virtual void | run_impl () |
virtual void | quit_impl () |
virtual guint | level_impl () |
virtual bool | iteration_impl (bool blocking) |
virtual bool | events_pending_impl () |
virtual void | on_window_hide () |
Additional Inherited Members | |
![]() | |
typedef internal::func_destroy_notify | func_destroy_notify |
Main application class.
Every application must have one of these objects. It may not be global and must be the first gtkmm object created. It is a singleton so declaring more than one will simply access the first created.
You would normally use this class in your main() function to initialize gtkmm and optionally to give argc and argv to the GTK+ initialization. After calling Gtk::Main::run(), you may use Gtk::Main::quit() to exit from the application, or just pass your main window to run(), to make run() return when that window closes.
A minimal gtkmm application would be something like this:
|
explicit |
Initialization without command-line arguments.
set_locale | Passing false prevents GTK+ from automatically calling setlocale(LC_ALL, ""). You would want to pass false if you wanted to set the locale for your program to something other than the user's locale, or if you wanted to set different values for different locale categories. |
|
virtual |
|
static |
Checks if any events are pending.
This can be used to update the GUI and invoke timeouts etc. while doing some time intensive computation.
Example: Updating the GUI during a long computation.
|
protectedvirtual |
|
protected |
|
static |
|
static |
Access to the one global instance of Gtk::Main.
|
static |
Runs a single iteration of the main loop.
If no events are waiting to be processed GTK+ will block until the next event is noticed. If you don't want to block then pass false for blocking or check if any events are pending with pending() first.
blocking | Whether the caller must wait until the next event is noticed, or return immediately if there are no events. |
|
protectedvirtual |
|
static |
|
protectedvirtual |
|
protectedvirtual |
|
static |
Makes the innermost invocation of the main loop return when it regains control.
|
protectedvirtual |
|
static |
Start the event loop.
This begins the event loop which handles events. No events propagate until this has been called. It may be called recursively to popup dialogs
|
static |
Returns from the main loop when the window is closed.
When using this override, you should not use Gtk::Main::quit() to close the application, but just call hide() on your Window class.
window | The window to show. This method will return when the window is hidden. |
|
protectedvirtual |