Top | ![]() |
![]() |
![]() |
![]() |
WnckClassGroup * | wnck_class_group_get () |
const char * | wnck_class_group_get_id () |
const char * | wnck_class_group_get_res_class () |
const char * | wnck_class_group_get_name () |
GdkPixbuf * | wnck_class_group_get_icon () |
GdkPixbuf * | wnck_class_group_get_mini_icon () |
GList * | wnck_class_group_get_windows () |
The WnckClassGroup is a group of WnckWindow that are all in the same class. It can be used to represent windows by classes, group windows by classes or to manipulate all windows of a particular class.
The class of a window is defined by the WM_CLASS property of this window. More information about the WM_CLASS property is available in the WM_CLASS Property section (section 4.1.2.5) of the ICCCM.
The WnckClassGroup objects are always owned by libwnck and must not be referenced or unreferenced.
WnckClassGroup *
wnck_class_group_get (const char *id
);
Gets the WnckClassGroup corresponding to id
.
the WnckClassGroup corresponding to
id
, or NULL
if there is no WnckClassGroup with the specified
id
. The returned WnckClassGroup is owned by libwnck and must not be
referenced or unreferenced.
[transfer none]
Since: 2.2
const char *
wnck_class_group_get_id (WnckClassGroup *class_group
);
Gets the identifier name for class_group
. This is the resource class for
class_group
.
the identifier name of class_group
, or an
empty string if the group has no identifier name.
Since: 3.2
const char *
wnck_class_group_get_res_class (WnckClassGroup *class_group
);
wnck_class_group_get_res_class
has been deprecated since version 3.2 and should not be used in newly-written code.
Use wnck_class_group_get_id()
instead.
Gets the resource class name for class_group
.
the resource class name of class_group
, or an
empty string if the group has no resource class name.
Since: 2.2
const char *
wnck_class_group_get_name (WnckClassGroup *class_group
);
Gets an human-readable name for class_group
. Since there is no way to
properly find this name, a suboptimal heuristic is used to find it. The name
is the name of all WnckApplication for each WnckWindow in class_group
if
they all have the same name. If all WnckApplication don't have the same
name, the name is the name of all WnckWindow in class_group
if they all
have the same name. If all WnckWindow don't have the same name, the
resource class name is used.
Since: 2.2
GdkPixbuf *
wnck_class_group_get_icon (WnckClassGroup *class_group
);
Gets the icon to be used for class_group
. Since there is no way to
properly find the icon, a suboptimal heuristic is used to find it. The icon
is the first icon found by looking at all the WnckApplication for each
WnckWindow in class_group
, then at all the WnckWindow in class_group
. If
no icon was found, a fallback icon is used.
the icon for class_group
. The caller should
reference the returned GdkPixbuf
if it needs to keep
the icon around.
[transfer none]
Since: 2.2
GdkPixbuf *
wnck_class_group_get_mini_icon (WnckClassGroup *class_group
);
Gets the mini-icon to be used for class_group
. Since there is no way to
properly find the mini-icon, the same suboptimal heuristic as the one for
wnck_class_group_get_icon()
is used to find it.
the mini-icon for class_group
. The caller
should reference the returned GdkPixbuf
if it needs
to keep the mini-icon around.
[transfer none]
Since: 2.2
GList *
wnck_class_group_get_windows (WnckClassGroup *class_group
);
Gets the list of WnckWindow that are grouped in class_group
.
the list of
WnckWindow grouped in class_group
, or NULL
if the group contains no
window. The list should not be modified nor freed, as it is owned by
class_group
.
[element-type WnckWindow][transfer none]
Since: 2.2
typedef struct _WnckClassGroup WnckClassGroup;
The WnckClassGroup struct contains only private fields and should not be directly accessed.
“icon-changed”
signalvoid user_function (WnckClassGroup *class_group, gpointer user_data)
Emitted when the icon of class_group
changes.
class_group |
the WnckClassGroup which emitted the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“name-changed”
signalvoid user_function (WnckClassGroup *class_group, gpointer user_data)
Emitted when the name of class_group
changes.
class_group |
the WnckClassGroup which emitted the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last