![]() |
![]() |
![]() |
libhildondesktop Reference Manual | ![]() |
---|---|---|---|---|
#include <libhildondesktop/libhildondesktop.h> HDHomePluginItem; DBusConnection* hd_home_plugin_item_get_dbus_connection (HDHomePluginItem *item, DBusBusType type, DBusError *error); DBusGConnection* hd_home_plugin_item_get_dbus_g_connection (HDHomePluginItem *item, DBusBusType type, GError **error); const gchar* hd_home_plugin_item_get_dl_filename (HDHomePluginItem *item); guint hd_home_plugin_item_heartbeat_signal_add (HDHomePluginItem *item, guint mintime, guint maxtime, GSourceFunc source_func, gpointer data, GDestroyNotify destroy); gchar* hd_home_plugin_item_get_applet_id (HDHomePluginItem *item); void hd_home_plugin_item_set_settings (HDHomePluginItem *item, gboolean settings);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkWindow +----HDHomePluginItem
HDHomePluginItem implements HDPluginItem, AtkImplementorIface and GtkBuildable.
Base class for Home widgets. To create ur own Home widgets create a subclass of HDHomePluginItem.
To support a settings dialog in the layout mode in the Hildon desktop
connect to the "show-settings" signal. And set the
property "settings" to TRUE
.
To start and stop animations of the widgets listen to the "notify" signal of
the "is-on-current-desktop" property. And show animations
only when "is-on-current-desktop" is TRUE
.
To create an transparent Home widget you have to set the colormap of the widget to RGBA. See the following example:
Example 3. Create a transparent Home widget
static void example_clock_applet_realize (GtkWidget *widget) { GdkScreen *screen = gtk_widget_get_screen (widget); gtk_widget_set_colormap (widget, gdk_screen_get_rgba_colormap (screen)); gtk_widget_set_app_paintable (widget, TRUE); GTK_WIDGET_CLASS (example_clock_applet_parent_class)->realize (widget); } static gboolean example_clock_applet_expose_event (GtkWidget *widget, GdkExposeEvent *event) { cairo_t *cr; cr = gdk_cairo_create (GDK_DRAWABLE (widget->window)); gdk_cairo_region (cr, event->region); cairo_clip (cr); cairo_set_operator (cr, CAIRO_OPERATOR_SOURCE); cairo_set_source_rgba (cr, 0.0, 0.0, 0.0, 0.0); cairo_paint (cr); cairo_destroy (cr); return GTK_WIDGET_CLASS (example_clock_applet_parent_class)->expose_event (widget, event); } static void example_clock_applet_class_init (ExampleClockAppletClass *klass) { GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass); widget_class->realize = example_clock_applet_realize; widget_class->expose_event = example_clock_applet_expose_event; }
DBusConnection* hd_home_plugin_item_get_dbus_connection (HDHomePluginItem *item, DBusBusType type, DBusError *error);
Creates a new private DBusConnection to the D-Bus session or system bus.
It is similar to the dbus_bus_get_private()
function but in contrast to the
dbus_bus_get_private()
function the application will not exit if the connection
closes. Additionally this function is used to map the unique D-Bus name to the
plugin.
So this function should be used by plugins to create D-Bus connections.
item : |
A HDHomePluginItem |
type : |
The DBusBusType DBUS_BUS_SESSION or DBUS_BUS_SYSTEM
|
error : |
A DBusError to return error messages |
Returns : | A new private connection to bus type . The connection must be unrefed with
dbus_connection_unref() when it is not longer needed.
|
DBusGConnection* hd_home_plugin_item_get_dbus_g_connection (HDHomePluginItem *item, DBusBusType type, GError **error);
Creates a new DBusGConnection to the D-Bus session or system bus.
Internally, calls dbus_g_bus_get()
. See there for further informations.
item : |
A HDHomePluginItem |
type : |
The DBusBusType DBUS_BUS_SESSION or DBUS_BUS_SYSTEM
|
error : |
A GError to return error messages |
Returns : | A shared connection. |
const gchar* hd_home_plugin_item_get_dl_filename (HDHomePluginItem *item);
Returns the filename of the dynamic library file from which this item was loaded. Useful for debugging purposes.
item : |
a HDHomePluginItem |
Returns : | filename of the dynamic library file. The result must not be freed. |
guint hd_home_plugin_item_heartbeat_signal_add (HDHomePluginItem *item, guint mintime, guint maxtime, GSourceFunc source_func, gpointer data, GDestroyNotify destroy);
Sets a function to be called at regular intervals. The source_func
is called repeatedly until
it returns FALSE, at which point it is automatically destroyed and the function will not be
called again.
It is wise to have maxtime-mintime quite big so all users of this service get synced.
If iphb is not avaiable g_timeout_add_seconds_full()
is used with maxtime
as interval.
See iphb_wait()
for more information.
item : |
A HDHomePluginItem. |
mintime : |
Time in seconds that must be waited before source_func is called, or 0.
|
maxtime : |
Time in seconds when the wait must end. |
source_func : |
Function to call. |
data : |
Data to pass to function .
|
destroy : |
Function to call when the signal is removed, or NULL .
|
Returns : | The ID (greater than 0) of the event source. |
gchar* hd_home_plugin_item_get_applet_id (HDHomePluginItem *item);
Returns the applet id which is used to identify the applet in the Hildon Desktop.
item : |
A HDHomePluginItem |
Returns : | The applet id. Free it when not longer used. |
void hd_home_plugin_item_set_settings (HDHomePluginItem *item, gboolean settings);
Sets whether the applet should show a settings button in layout mode.
The applet should connect to the "show-settings" signal to get notified when it should show the settings dialog.
item : |
A HDHomePluginItem |
settings : |
Whether the applet supports settings |
"is-on-current-desktop"
property"is-on-current-desktop" gboolean : Read
If the applet is shown on current desktop.
Default value: FALSE
"show-settings"
signalvoid user_function (HDHomePluginItem *hdhomepluginitem, gpointer user_data) : Run Last
hdhomepluginitem : |
the object which received the signal. |
user_data : |
user data set when the signal handler was connected. |