![]() |
![]() |
![]() |
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. |