|  |  |  | Libmatewnck Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Signals | ||||
| MatewnckClassGroupMatewnckClassGroup — an object representing a group of windows of the same class. | 
#include <libmatewnck/libmatewnck.h>
                    MatewnckClassGroup;
MatewnckClassGroup * matewnck_class_group_get           (const char *res_class);
const char *        matewnck_class_group_get_res_class  (MatewnckClassGroup *class_group);
const char *        matewnck_class_group_get_name       (MatewnckClassGroup *class_group);
GdkPixbuf *         matewnck_class_group_get_icon       (MatewnckClassGroup *class_group);
GdkPixbuf *         matewnck_class_group_get_mini_icon  (MatewnckClassGroup *class_group);
GList *             matewnck_class_group_get_windows    (MatewnckClassGroup *class_group);
The MatewnckClassGroup is a group of MatewnckWindow 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 MatewnckClassGroup objects are always owned by libmatewnck and must not be referenced or unreferenced.
typedef struct _MatewnckClassGroup MatewnckClassGroup;
The MatewnckClassGroup struct contains only private fields and should not be directly accessed.
MatewnckClassGroup * matewnck_class_group_get           (const char *res_class);
Gets the MatewnckClassGroup corresponding to res_class.
| 
 | name of the sought resource class. | 
| Returns : | the MatewnckClassGroup corresponding to res_class, orNULLif there is no MatewnckClassGroup with the specifiedres_class. The returned MatewnckClassGroup is owned by libmatewnck and must not be
referenced or unreferenced. [transfer none] | 
Since 2.2
const char *        matewnck_class_group_get_res_class  (MatewnckClassGroup *class_group);
Gets the resource class name for class_group.
| 
 | a MatewnckClassGroup. | 
| Returns : | the resource class name of class_group, or an
empty string if the group has no resource class name. | 
Since 2.2
const char *        matewnck_class_group_get_name       (MatewnckClassGroup *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 MatewnckApplication for each MatewnckWindow in class_group if
they all have the same name. If all MatewnckApplication don't have the same
name, the name is the name of all MatewnckWindow in class_group if they all
have the same name. If all MatewnckWindow don't have the same name, the
resource class name is used.
| 
 | a MatewnckClassGroup. | 
| Returns : | an human-readable name for class_group. | 
Since 2.2
GdkPixbuf *         matewnck_class_group_get_icon       (MatewnckClassGroup *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 MatewnckApplication for each
MatewnckWindow in class_group, then at all the MatewnckWindow in class_group. If
no icon was found, a fallback icon is used.
| 
 | a MatewnckClassGroup. | 
| Returns : | the icon for class_group. The caller should reference the
returnedGdkPixbufif it needs to keep the icon
around. | 
Since 2.2
GdkPixbuf *         matewnck_class_group_get_mini_icon  (MatewnckClassGroup *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
matewnck_class_group_get_icon() is used to find it.
| 
 | a MatewnckClassGroup. | 
| Returns : | the mini-icon for class_group. The caller should reference
the returnedGdkPixbufif it needs to keep the
mini-icon around. | 
Since 2.2
GList *             matewnck_class_group_get_windows    (MatewnckClassGroup *class_group);
Gets the list of MatewnckWindow that are grouped in class_group.
| 
 | a MatewnckClassGroup. | 
| Returns : | the list of
MatewnckWindow grouped in class_group, orNULLif the group contains no
window. The list should not be modified nor freed, as it is owned byclass_group. [element-type MatewnckWindow][transfer none] | 
Since 2.2
"icon-changed" signalvoid                user_function                      (MatewnckClassGroup *class_group,
                                                        gpointer            user_data)        : Run Last
Emitted when the icon of class_group changes.
| 
 | the MatewnckClassGroup which emitted the signal. | 
| 
 | user data set when the signal handler was connected. | 
"name-changed" signalvoid                user_function                      (MatewnckClassGroup *class_group,
                                                        gpointer            user_data)        : Run Last
Emitted when the name of class_group changes.
| 
 | the MatewnckClassGroup which emitted the signal. | 
| 
 | user data set when the signal handler was connected. |