![]() |
![]() |
![]() |
liblauncher Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
#include <launcher-application.h> LauncherApplicationWindow; void (*LauncherApplicationWindowActivateFunc) (WnckWindow *window
,guint32 timestamp
,void *callback_d
); LauncherApplication; LauncherApplication * launcher_application_new (void
); LauncherApplication * launcher_application_new_from_desktop_file (const gchar *desktop_file
,gboolean dont_check_windows
); LauncherApplication * launcher_application_new_from_wnck_window (WnckWindow *window
); gboolean launcher_application_launch (LauncherApplication *application
,GError **error
); const gchar * launcher_application_get_unique_string (LauncherApplication *application
); GSList * launcher_application_get_windows (LauncherApplication *application
); gboolean launcher_application_owns_window (LauncherApplication *application
,WnckWindow *window
); void launcher_application_update_windows (LauncherApplication *application
); void launcher_application_ensure_state (LauncherApplication *application
); const gchar * launcher_application_get_name (LauncherApplication *application
); const gchar * launcher_application_get_comment (LauncherApplication *application
); const gchar * launcher_application_get_icon_name (LauncherApplication *application
); const gchar * launcher_application_get_exec_string (LauncherApplication *application
); const gchar * launcher_application_get_desktop_file (LauncherApplication *application
); void launcher_application_set_desktop_file (LauncherApplication *application
,const gchar *desktop_file
,gboolean dont_check_windows
); gboolean launcher_application_get_urgent (LauncherApplication *application
); gboolean launcher_application_get_running (LauncherApplication *application
); gboolean launcher_application_get_favorite (LauncherApplication *application
); gboolean launcher_application_get_focused (LauncherApplication *application
); void launcher_application_show (LauncherApplication *application
,guint32 timestamp
); void launcher_application_minimize (LauncherApplication *application
); gboolean launcher_application_has_minimized (LauncherApplication *application
); void launcher_application_restore (LauncherApplication *application
,guint32 timestamp
); void launcher_application_close (LauncherApplication *application
,guint32 timestamp
); void launcher_application_set_window_activate_func (LauncherApplicationWindowActivateFunc func
,void *callback_d
); gboolean launcher_application_has_gathered_windows (LauncherApplication *application
);
LauncherApplication objects exist in order to acquire data about specific applications and to launch applications. it also provides a method for returning a libwnck application
void (*LauncherApplicationWindowActivateFunc) (WnckWindow *window
,guint32 timestamp
,void *callback_d
);
|
|
|
|
|
typedef struct { GObject parent_instance; /* Private */ LauncherApplicationPrivate *priv; } LauncherApplication;
LauncherApplication * launcher_application_new_from_desktop_file (const gchar *desktop_file
,gboolean dont_check_windows
);
|
|
|
|
Returns : |
LauncherApplication * launcher_application_new_from_wnck_window
(WnckWindow *window
);
creates a new LauncherApplication object based on information from window
|
A WnckWindow object |
Returns : |
gboolean launcher_application_launch (LauncherApplication *application
,GError **error
);
This method will attempt to launch the application using the exec string associated with it
|
a LauncherApplication object |
|
a GError error |
Returns : |
A truth value dictating whether the launching was successful |
const gchar * launcher_application_get_unique_string
(LauncherApplication *application
);
Provides a unique string that can be used to identify this application
|
|
Returns : |
a unique string |
GSList * launcher_application_get_windows (LauncherApplication *application
);
Provides a list of WnckApplications associated with this app
|
|
Returns : |
a GSList containing WnckApplications. transfer none. |
gboolean launcher_application_owns_window (LauncherApplication *application
,WnckWindow *window
);
|
|
|
|
Returns : |
void launcher_application_update_windows (LauncherApplication *application
);
|
void launcher_application_ensure_state (LauncherApplication *application
);
|
const gchar * launcher_application_get_name (LauncherApplication *application
);
Get the internationalized name of the application. Suitable for display.
|
a LauncherApplication object |
Returns : |
a string containing the name |
const gchar * launcher_application_get_comment (LauncherApplication *application
);
Get the internationalized comment string assigned to this application. Suitable for display as a short description of the application.
|
A LauncherApplication object |
Returns : |
An internationalized string containing the comment |
const gchar * launcher_application_get_icon_name (LauncherApplication *application
);
Get icon-name associated with the application
|
A LauncherApplication object |
Returns : |
an icon-name string |
const gchar * launcher_application_get_exec_string
(LauncherApplication *application
);
Get the command line used to start this application
|
A LauncherApplication |
Returns : |
the command line used to start this application |
const gchar * launcher_application_get_desktop_file
(LauncherApplication *application
);
Get the absolute path to the .desktop file for this application
|
A LauncherApplication |
Returns : |
the path to the .desktop file |
void launcher_application_set_desktop_file (LauncherApplication *application
,const gchar *desktop_file
,gboolean dont_check_windows
);
sets the desktop file for this application and will also regenerate its information
|
A LauncherApplication |
|
A string describing the path to a desktop file |
|
gboolean launcher_application_get_urgent (LauncherApplication *application
);
|
|
Returns : |
gboolean launcher_application_get_running (LauncherApplication *application
);
Method to tell if the application
is currently running or not
|
A LauncherApplication |
Returns : |
A Truth value |
gboolean launcher_application_get_favorite (LauncherApplication *application
);
Method to tell if the application
is a favorite or not
|
A LauncherApplication |
Returns : |
A Truth value |
gboolean launcher_application_get_focused (LauncherApplication *application
);
provides a method that will return true if any of this applicaiton
's windows
are currently "focused"
|
A LauncherApplication |
Returns : |
a gboolean value |
void launcher_application_show (LauncherApplication *application
,guint32 timestamp
);
this method will focus the latest un-minimized window this application
has
all this application
's windows are minimized then this method will
unminimize them all
|
a LauncherApplication |
|
void launcher_application_minimize (LauncherApplication *application
);
|
gboolean launcher_application_has_minimized (LauncherApplication *application
);
|
|
Returns : |
void launcher_application_restore (LauncherApplication *application
,guint32 timestamp
);
|
|
|
void launcher_application_close (LauncherApplication *application
,guint32 timestamp
);
|
|
|
void launcher_application_set_window_activate_func (LauncherApplicationWindowActivateFunc func
,void *callback_d
);
Allows external control of showing windows
|
a LauncherApplicationWindowActivateFunc handler |
|
gboolean launcher_application_has_gathered_windows
(LauncherApplication *application
);
|
|
Returns : |