|
|
|
Libwnck Reference Manual | |
|---|---|---|---|---|
WnckApplicationWnckApplication — an object representing a group of windows of the same application. |
#include <libwnck/libwnck.h>
WnckApplication;
WnckApplication* wnck_application_get (gulong xwindow);
gulong wnck_application_get_xid (WnckApplication *app);
const char* wnck_application_get_name (WnckApplication *app);
const char* wnck_application_get_icon_name (WnckApplication *app);
int wnck_application_get_pid (WnckApplication *app);
gboolean wnck_application_get_icon_is_fallback
(WnckApplication *app);
GdkPixbuf* wnck_application_get_icon (WnckApplication *app);
GdkPixbuf* wnck_application_get_mini_icon (WnckApplication *app);
const char* wnck_application_get_startup_id (WnckApplication *app);
GList* wnck_application_get_windows (WnckApplication *app);
int wnck_application_get_n_windows (WnckApplication *app);
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.
typedef struct _WnckApplication WnckApplication;
The WnckApplication struct contains only private fields and should not be directly accessed.
WnckApplication* wnck_application_get (gulong xwindow);
Returns the WnckApplication corresponding to the group leader with xwindow
as X window ID.
xwindow : |
the X window ID of a group leader. |
| Returns : | 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.
|
gulong wnck_application_get_xid (WnckApplication *app);
Returns the X window ID of the group leader window for app.
app : |
a WnckApplication. |
| Returns : | the X window ID of the group leader window for app.
|
const char* wnck_application_get_name (WnckApplication *app);
Returns 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.
app : |
a WnckApplication. |
| Returns : | the name of app, or a fallback name if no name is available.
|
const char* wnck_application_get_icon_name (WnckApplication *app);
Returns 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.
app : |
a WnckApplication |
| Returns : | the icon name of app, or a fallback icon name if no icon name
is available.
|
int wnck_application_get_pid (WnckApplication *app);
Returns the process ID of app.
app : |
a WnckApplication. |
| Returns : | the process ID of app, or 0 if none is available.
|
gboolean wnck_application_get_icon_is_fallback
(WnckApplication *app);
Returns whether a default fallback icon is used for app (because none
was set on app).
app : |
a WnckApplication |
| Returns : | TRUE if the icon for app is a fallback, FALSE otherwise.
|
GdkPixbuf* wnck_application_get_icon (WnckApplication *app);
Returns 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.
app : |
a WnckApplication. |
| Returns : | the icon for app. The caller should reference the returned
GdkPixbuf if it needs to keep the icon around.
|
GdkPixbuf* wnck_application_get_mini_icon (WnckApplication *app);
Returns 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.
app : |
a WnckApplication. |
| Returns : | the mini-icon for app. The caller should reference the
returned GdkPixbuf if it needs to keep the mini-icon
around.
|
const char* wnck_application_get_startup_id (WnckApplication *app);
Returns the startup sequence ID used for startup notification of app.
app : |
a WnckApplication. |
| Returns : | 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);
Returns the list of WnckWindow belonging to app.
app : |
a WnckApplication. |
| Returns : | 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.
|
int wnck_application_get_n_windows (WnckApplication *app);
Returns the number of WnckWindow belonging to app.
app : |
a WnckApplication. |
| Returns : | the number of WnckWindow belonging to app.
|
"icon-changed" signalvoid user_function (WnckApplication *app, gpointer user_data) : Run Last
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. |
"name-changed" signalvoid user_function (WnckApplication *app, gpointer user_data) : Run Last
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. |