|  |  |  | libbamf Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Signals | ||||
struct BamfMatcher; struct BamfMatcherClass; gboolean bamf_matcher_application_is_running (BamfMatcher *matcher,const gchar *application); BamfApplication * bamf_matcher_get_active_application (BamfMatcher *matcher); BamfWindow * bamf_matcher_get_active_window (BamfMatcher *matcher); BamfApplication * bamf_matcher_get_application_for_desktop_file (BamfMatcher *matcher,const gchar *desktop_file_path,gboolean create_if_not_found); BamfApplication * bamf_matcher_get_application_for_window (BamfMatcher *matcher,BamfWindow *window); BamfApplication * bamf_matcher_get_application_for_xid (BamfMatcher *matcher,guint32 xid); GList * bamf_matcher_get_applications (BamfMatcher *matcher); BamfMatcher * bamf_matcher_get_default (void); GList * bamf_matcher_get_running_applications (BamfMatcher *matcher); GList * bamf_matcher_get_tabs (BamfMatcher *matcher); GList * bamf_matcher_get_window_stack_for_monitor (BamfMatcher *matcher,gint monitor); GList * bamf_matcher_get_windows (BamfMatcher *matcher); GArray * bamf_matcher_get_xids_for_application (BamfMatcher *matcher,const gchar *application); void bamf_matcher_register_favorites (BamfMatcher *matcher,const gchar **favorites);
"active-application-changed" "active-window-changed" "stacking-order-changed" "view-closed" "view-opened"
gboolean bamf_matcher_application_is_running (BamfMatcher *matcher,const gchar *application);
BamfApplication *   bamf_matcher_get_active_application (BamfMatcher *matcher);
Used to fetch the active BamfApplication.
| 
 | a BamfMatcher | 
| Returns : | The active BamfApplication. [transfer none] | 
BamfWindow *        bamf_matcher_get_active_window      (BamfMatcher *matcher);
Used to fetch the active BamfWindow.
| 
 | a BamfMatcher | 
| Returns : | The active BamfWindow. [transfer none] | 
BamfApplication * bamf_matcher_get_application_for_desktop_file (BamfMatcher *matcher,const gchar *desktop_file_path,gboolean create_if_not_found);
BamfApplication * bamf_matcher_get_application_for_window (BamfMatcher *matcher,BamfWindow *window);
Used to fetch the BamfApplication containing the passed window.
| 
 | a BamfMatcher | 
| 
 | The window to look for | 
| Returns : | The BamfApplication representing the xid passed, or NULL if none exists. [transfer container] | 
BamfApplication * bamf_matcher_get_application_for_xid (BamfMatcher *matcher,guint32 xid);
Used to fetch the BamfApplication containing the passed xid.
| 
 | a BamfMatcher | 
| 
 | The XID to search for | 
| Returns : | The BamfApplication representing the xid passed, or NULL if none exists. [transfer container] | 
GList *             bamf_matcher_get_applications       (BamfMatcher *matcher);
Used to fetch all xid's associated with an application. Useful for performing window
| 
 | a BamfMatcher | 
| Returns : | A list of xids. [element-type guint32][transfer none] | 
BamfMatcher *       bamf_matcher_get_default            (void);
Returns the default matcher. This matcher is owned by bamf and shared between other callers.
| Returns : | A new BamfMatcher. [transfer none] | 
GList *             bamf_matcher_get_running_applications
                                                        (BamfMatcher *matcher);
Used to fetch all BamfApplication's which are running.
| 
 | a BamfMatcher | 
| Returns : | A list of BamfApplication's. [element-type Bamf.Application][transfer container] | 
GList *             bamf_matcher_get_tabs               (BamfMatcher *matcher);
Used to fetch all BamfView's representing tabs. Currently unused.
| 
 | a BamfMatcher | 
| Returns : | A list of BamfViews's. [element-type Bamf.View][transfer container] | 
GList * bamf_matcher_get_window_stack_for_monitor (BamfMatcher *matcher,gint monitor);
Used to fetch all windows that BAMF knows about in the requested screen, in stacking bottom-to-top order.
| 
 | a BamfMatcher | 
| 
 | the monitor you want the stack from, negative value to get all | 
| Returns : | A list of BamfWindow. [element-type Bamf.View][transfer container] | 
GList *             bamf_matcher_get_windows            (BamfMatcher *matcher);
Used to fetch all windows that BAMF knows about.
| 
 | a BamfMatcher | 
| Returns : | A list of windows. [element-type Bamf.View][transfer container] | 
GArray * bamf_matcher_get_xids_for_application (BamfMatcher *matcher,const gchar *application);
void bamf_matcher_register_favorites (BamfMatcher *matcher,const gchar **favorites);
Used to effect how bamf performs matching. Desktop files passed to this method will be prefered by bamf to system desktop files.
| 
 | a BamfMatcher | 
| 
 | an array of strings, each containing an absolute path to a .desktop file | 
"active-application-changed" signalvoid user_function (BamfMatcher *bamfmatcher, GObject *arg1, GObject *arg2, gpointer user_data)
| 
 | the object which received the signal. | 
| 
 | user data set when the signal handler was connected. | 
"active-window-changed" signalvoid user_function (BamfMatcher *bamfmatcher, GObject *arg1, GObject *arg2, gpointer user_data)
| 
 | the object which received the signal. | 
| 
 | user data set when the signal handler was connected. | 
"stacking-order-changed" signalvoid user_function (BamfMatcher *bamfmatcher, gpointer user_data)
| 
 | the object which received the signal. | 
| 
 | user data set when the signal handler was connected. | 
"view-closed" signalvoid user_function (BamfMatcher *bamfmatcher, GObject *arg1, gpointer user_data)
| 
 | the object which received the signal. | 
| 
 | user data set when the signal handler was connected. | 
"view-opened" signalvoid user_function (BamfMatcher *bamfmatcher, GObject *arg1, gpointer user_data)
| 
 | the object which received the signal. | 
| 
 | user data set when the signal handler was connected. |