Top | ![]() |
![]() |
![]() |
![]() |
WnckApplicationWnckApplication — an object representing a group of windows of the same application. |
WnckApplication * | wnck_application_get () |
gulong | wnck_application_get_xid () |
const char * | wnck_application_get_name () |
const char * | wnck_application_get_icon_name () |
int | wnck_application_get_pid () |
gboolean | wnck_application_get_icon_is_fallback () |
GdkPixbuf * | wnck_application_get_icon () |
GdkPixbuf * | wnck_application_get_mini_icon () |
const char * | wnck_application_get_startup_id () |
GList * | wnck_application_get_windows () |
int | wnck_application_get_n_windows () |
The WnckApplication is a group of WnckWindow that are all in the same application. It can be used to represent windows by applications, group windows by applications or to manipulate all windows of a particular application.
A WnckApplication is identified by the group leader of the WnckWindow belonging to it, and new WnckWindow are added to a WnckApplication if and only if they have the group leader of the WnckApplication.
The WnckApplication objects are always owned by libwnck and must not be referenced or unreferenced.
WnckApplication *
wnck_application_get (gulong xwindow
);
Gets the WnckApplication corresponding to the group leader with xwindow
as X window ID.
the WnckApplication corresponding to
xwindow
, or NULL
if there no such WnckApplication could be found. The
returned WnckApplication is owned by libwnck and must not be referenced or
unreferenced.
[transfer none]
gulong
wnck_application_get_xid (WnckApplication *app
);
Gets the X window ID of the group leader window for app
.
const char *
wnck_application_get_name (WnckApplication *app
);
Gets the name of app
. Since there is no way to properly find this name,
various suboptimal heuristics are used to find it. GTK+ should probably have
a function to allow applications to set the _NET_WM_NAME property on the
group leader as the application name, and the EWMH
should say that this is where the application name goes.
const char *
wnck_application_get_icon_name (WnckApplication *app
);
Gets the icon name of app
(to be used when app
is minimized). Since
there is no way to properly find this name, various suboptimal heuristics
are used to find it.
int
wnck_application_get_pid (WnckApplication *app
);
Gets the process ID of app
.
gboolean
wnck_application_get_icon_is_fallback (WnckApplication *app
);
Gets whether a default fallback icon is used for app
(because none
was set on app
).
GdkPixbuf *
wnck_application_get_icon (WnckApplication *app
);
Gets the icon to be used for app
. If no icon is set for app
, a
suboptimal heuristic is used to find an appropriate icon. If no icon was
found, a fallback icon is used.
GdkPixbuf *
wnck_application_get_mini_icon (WnckApplication *app
);
Gets the mini-icon to be used for app
. If no mini-icon is set for app
,
a suboptimal heuristic is used to find an appropriate icon. If no mini-icon
was found, a fallback mini-icon is used.
const char *
wnck_application_get_startup_id (WnckApplication *app
);
Gets the startup sequence ID used for startup notification of app
.
the startup sequence ID used for startup notification of app
,
or NULL
if none is available.
Since: 2.2
GList *
wnck_application_get_windows (WnckApplication *app
);
Gets the list of WnckWindow belonging to app
.
the list of
WnckWindow belonging to app
, or NULL
if the application contains no
window. The list should not be modified nor freed, as it is owned by app
.
[element-type WnckWindow][transfer none]
int
wnck_application_get_n_windows (WnckApplication *app
);
Gets the number of WnckWindow belonging to app
.
typedef struct _WnckApplication WnckApplication;
The WnckApplication struct contains only private fields and should not be directly accessed.
“icon-changed”
signalvoid user_function (WnckApplication *app, gpointer user_data)
Emitted when the icon of app
changes.
app |
the WnckApplication which emitted the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“name-changed”
signalvoid user_function (WnckApplication *app, gpointer user_data)
Emitted when the name of app
changes.
app |
the WnckApplication which emitted the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last