Top | ![]() |
![]() |
![]() |
![]() |
ShellGlobal * | shell_global_get () |
ClutterStage * | shell_global_get_stage () |
MetaDisplay * | shell_global_get_display () |
GList * | shell_global_get_window_actors () |
GSettings * | shell_global_get_settings () |
guint32 | shell_global_get_current_time () |
void | shell_global_set_stage_input_region () |
void | shell_global_get_pointer () |
void | shell_global_begin_work () |
void | shell_global_end_work () |
void | (*ShellLeisureFunction) () |
void | shell_global_run_at_leisure () |
GDBusProxy * | shell_global_get_switcheroo_control () |
GAppLaunchContext * | shell_global_create_app_launch_context () |
void | shell_global_notify_error () |
void | shell_global_reexec_self () |
const char * | shell_global_get_session_mode () |
void | shell_global_set_runtime_state () |
GVariant * | shell_global_get_runtime_state () |
void | shell_global_set_persistent_state () |
GVariant * | shell_global_get_persistent_state () |
ShellGlobal *
shell_global_get (void
);
Gets the singleton global object that represents the desktop.
GList *
shell_global_get_window_actors (ShellGlobal *global
);
Gets the list of MetaWindowActor for the plugin's screen
GSettings *
shell_global_get_settings (ShellGlobal *global
);
Get the global GSettings instance.
void shell_global_set_stage_input_region (ShellGlobal *global
,GSList *rectangles
);
Sets the area of the stage that is responsive to mouse clicks when we don't have a modal or grab.
global |
the ShellGlobal |
|
rectangles |
a list of MetaRectangle describing the input region. |
[element-type Meta.Rectangle] |
void shell_global_get_pointer (ShellGlobal *global
,int *x
,int *y
,ClutterModifierType *mods
);
Gets the pointer coordinates and current modifier key state.
global |
the ShellGlobal |
|
x |
the X coordinate of the pointer, in global coordinates. |
[out] |
y |
the Y coordinate of the pointer, in global coordinates. |
[out] |
mods |
the current set of modifier keys that are pressed down. |
[out] |
void
shell_global_begin_work (ShellGlobal *global
);
Marks that we are currently doing work. This is used to to track
whether we are busy for the purposes of shell_global_run_at_leisure()
.
A count is kept and shell_global_end_work()
must be called exactly
as many times as shell_global_begin_work()
.
void
shell_global_end_work (ShellGlobal *global
);
Marks the end of work that we started with shell_global_begin_work()
.
If no other work is ongoing and functions have been added with
shell_global_run_at_leisure()
, they will be run at the next
opportunity.
void shell_global_run_at_leisure (ShellGlobal *global
,ShellLeisureFunction func
,gpointer user_data
,GDestroyNotify notify
);
Schedules a function to be called the next time the shell is idle. Idle means here no animations, no redrawing, and no ongoing background work. Since there is currently no way to hook into the Clutter master clock and know when is running, the implementation here is somewhat approximation. Animations may be detected as terminating early if they can be drawn fast enough so that the event loop goes idle between frames.
The intent of this function is for performance measurement runs where a number of actions should be run serially and each action is timed individually. Using this function for other purposes will interfere with the ability to use it for performance measurement so should be avoided.
global |
the ShellGlobal |
|
func |
function to call at leisure |
|
user_data |
data to pass to |
|
notify |
function to call to free |
GDBusProxy *
shell_global_get_switcheroo_control (ShellGlobal *global
);
Get the global GDBusProxy instance for the switcheroo-control daemon.
GAppLaunchContext * shell_global_create_app_launch_context (ShellGlobal *global
,guint32 timestamp
,int workspace
);
Create a GAppLaunchContext set up with the correct timestamp, and targeted to activate on the current workspace.
void shell_global_notify_error (ShellGlobal *global
,const char *msg
,const char *details
);
Show a system error notification. Use this function when a user-initiated action results in a non-fatal problem from causes that may not be under system control. For example, an application crash.
void
shell_global_reexec_self (ShellGlobal *global
);
Restart the current process. Only intended for development purposes.
void shell_global_set_runtime_state (ShellGlobal *global
,const char *property_name
,GVariant *variant
);
Change the value of serialized runtime state.
GVariant * shell_global_get_runtime_state (ShellGlobal *global
,const char *property_type
,const char *property_name
);
The shell maintains "runtime" state which does not persist across logout or reboot.
void shell_global_set_persistent_state (ShellGlobal *global
,const char *property_name
,GVariant *variant
);
Change the value of serialized persistent state.
GVariant * shell_global_get_persistent_state (ShellGlobal *global
,const char *property_type
,const char *property_name
);
The shell maintains "persistent" state which will persist after logout or reboot.