|
|
|
|
XfwApplication represents an application in the common or abstract sense, i.e. it can have several windows belonging to different instances, identified by their process ID.
Note that XfwApplication is actually an interface; when obtaining an instance, an instance of a windowing-environment-specific object that implements this interface will be returned.
const gchar *
xfw_application_get_class_id (XfwApplication *app);
Fetches this application's class id. On X11 this should be the class name of the WM_CLASS property. On Wayland, it's the application ID, which should correspond to the basename of the application's desktop file.
Since: 4.19.3
const gchar *
xfw_application_get_name (XfwApplication *app);
Fetches this application's human-readable name.
GdkPixbuf * xfw_application_get_icon (XfwApplication *app,gint size,gint scale);
Fetches app
's icon. If app
has no icon, a fallback icon may be
returned. Whether or not the returned icon is a fallback icon can be
determined using xfw_application_icon_is_fallback().
GIcon *
xfw_application_get_gicon (XfwApplication *app);
Fetches app
's icon as a size-independent GIcon. If an icon cannot be
found, a GIcon representing a fallback icon will be returned. Whether or
not the returned icon is a fallback icon can be determined using
xfw_application_icon_is_fallback().
Since: 4.19.1
gboolean
xfw_application_icon_is_fallback (XfwApplication *app);
Determines if app
does not have an icon, and thus a fallback icon
will be returned from xfw_application_get_icon() and
xfw_application_get_gicon().
Since: 4.19.1
GList *
xfw_application_get_windows (XfwApplication *app);
Lists all windows belonging to the application.
The list of XfwWindow belonging to app
. The list and its contents are owned
by app
.
[not nullable][element-type XfwWindow][transfer none]
GList *
xfw_application_get_instances (XfwApplication *app);
Lists all instances of the application.
The list of XfwApplicationInstance of app
, or NULL if listing instances is
not supported on the windowing environment in use. The list and its contents
are owned by app
.
[nullable][element-type XfwApplicationInstance][transfer none]
XfwApplicationInstance * xfw_application_get_instance (XfwApplication *app,XfwWindow *window);
Finds the XfwApplicationInstance to which window
belongs.
The XfwApplicationInstance to which window
belongs, or NULL if window
does not belong to app
, or if listing instances is not supported on the
windowing environment in use. The returned XfwApplicationInstance is owned
by app
.
[nullable][transfer none]
gint
xfw_application_instance_get_pid (XfwApplicationInstance *instance);
Fetches instance
's PID.
Since: 4.19.1
const gchar *
xfw_application_instance_get_name (XfwApplicationInstance *instance);
Fetches instance
's name, which can often be the same as the application name.
Since: 4.19.1
GList *
xfw_application_instance_get_windows (XfwApplicationInstance *instance);
Lists all windows belonging to the application instance.
The list of XfwWindow belonging to instance
. The list and its contents are owned
by instance
.
[not nullable][element-type XfwWindow][transfer none]
Since: 4.19.1
typedef struct _XfwApplicationInstance XfwApplicationInstance;
An opaque structure representing an instance of an XfwApplication.
“class-id” property“class-id” char *
The application class id.
Owner: XfwApplication
Flags: Read
Default value: ""
Since: 4.19.3
“gicon” property“gicon” GIcon *
The GIcon that represents this application.
Owner: XfwApplication
Flags: Read
“instances” property“instances” gpointer
The list of XfwApplicationInstance belonging to the application.
Owner: XfwApplication
Flags: Read
“name” property“name” char *
The application name.
Owner: XfwApplication
Flags: Read
Default value: NULL
“icon-changed” signalvoid user_function (XfwApplication *app, gpointer user_data)
Emitted when app
's icon changes.
app |
the object which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last