| Top | |
|
|
|
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.
guint64
xfw_application_get_id (XfwApplication *app);
Fetches this application's ID, which is the “id” of the first window in “windows”.
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().
a GdkPixbuf, owned by app
,
or NULL if app
has no icon and a fallback cannot be rendered.
[nullable][transfer none]
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.
“gicon” property“gicon” GIcon *
The GIcon that represents this application.
Owner: XfwApplication
Flags: Read
“id” property“id” guint64
The “id” of the first window in “windows”.
Owner: XfwApplication
Flags: Read
Default value: 0
“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