home-applet-handler.c File Reference

Implementation of Home Applet Handler. More...

#include "home-applet-handler.h"
#include "hildon-home-plugin-interface.h"
#include "hildon-home-interface.h"
#include "hildon-home-applet.h"
#include <string.h>
#include <dlfcn.h>
#include <gtk/gtk.h>
#include <osso-log.h>

Defines
#define	HOME_APPLET_HANDLER_LIBRARY_DIR   "/usr/lib/hildon-home/"
#define	HOME_APPLET_HANDLER_RESIZABLE_WIDTH   "X"
#define	HOME_APPLET_HANDLER_RESIZABLE_HEIGHT   "Y"
#define	HOME_APPLET_HANDLER_RESIZABLE_FULL   "XY"
#define	HOME_APPLET_HANDLER_GET_PRIVATE(obj)
Enumerations
enum	{   SYMBOL_INITIALIZE = 0, SYMBOL_SAVE_STATE, SYMBOL_BACKGROUND, SYMBOL_FOREGROUND,   SYMBOL_SETTINGS, SYMBOL_DEINITIALIZE, MAX_SYMBOLS }
Functions
GType	home_applet_handler_get_type (void)
HomeAppletHandler *	home_applet_handler_new (const char *desktoppath, void *state_data, int *state_size)
GtkWidget *	home_applet_handler_get_widget (HomeAppletHandler *handler)
int	home_applet_handler_save_state (HomeAppletHandler *handler, void **state_data, int *state_size)
void	home_applet_handler_background (HomeAppletHandler *handler)
void	home_applet_handler_foreground (HomeAppletHandler *handler)
GtkWidget *	home_applet_handler_settings (HomeAppletHandler *handler, GtkWindow *parent)
void	home_applet_handler_deinitialize (HomeAppletHandler *handler)
const gchar *	home_applet_handler_get_desktop_filepath (HomeAppletHandler *handler)
const gchar *	home_applet_handler_get_libraryfile (HomeAppletHandler *handler)
void	home_applet_handler_set_coordinates (HomeAppletHandler *handler, gint x, gint y)
void	home_applet_handler_get_coordinates (HomeAppletHandler *handler, gint *x, gint *y)
void	home_applet_handler_store_size (HomeAppletHandler *handler)
void	home_applet_handler_set_size (HomeAppletHandler *handler, gint width, gint height)
void	home_applet_handler_get_size (HomeAppletHandler *handler, gint *width, gint *height)
void	home_applet_handler_set_minimum_size (HomeAppletHandler *handler, gint minwidth, gint minheight)
void	home_applet_handler_get_minimum_size (HomeAppletHandler *handler, gint *minwidth, gint *minheight)
void	home_applet_handler_set_resizable (HomeAppletHandler *handler, gboolean resizable_width, gboolean resizable_height)
void	home_applet_handler_get_resizable (HomeAppletHandler *handler, gboolean *resizable_width, gboolean *resizable_height)
GtkEventBox *	home_applet_handler_get_eventbox (HomeAppletHandler *handler)

---

Detailed Description

Implementation of Home Applet Handler.

---

Define Documentation

#define HOME_APPLET_HANDLER_GET_PRIVATE (  obj   )

Value: (G_TYPE_INSTANCE_GET_PRIVATE ((obj),\ HOME_TYPE_APPLET_HANDLER, HomeAppletHandlerPrivate))

---

Function Documentation

void home_applet_handler_background (  HomeAppletHandler *  handler  )

home_applet_handler_background: Called when Home goes to backround. Applet should stop all timers when this is called. Parameters: handler  A handler as returned by home_applet_handler_new.

void home_applet_handler_deinitialize (  HomeAppletHandler *  handler  )

home_applet_handler_deinitialize: Called when Home unloads the applet from memory. Applet should deallocate all the resources needed. Parameters: handler  A handler as returned by home_applet_handler_new.

void home_applet_handler_foreground (  HomeAppletHandler *  handler  )

home_applet_handler_foreground: Called when Home goes to foreground. Applet should start periodic UI updates again if needed. Parameters: handler  A handler as returned by home_applet_handler_new.

void home_applet_handler_get_coordinates (  HomeAppletHandler *  handler, gint *  x, gint *  y )

home_applet_handler_get_coordinates: Called when the applet coordinates are wanted Parameters: handler  A handler as returned by home_applet_handler_new. x  Place for x coordinate of applet to be saved y  Place for y coordinate of applet to be saved

const gchar* home_applet_handler_get_desktop_filepath (  HomeAppletHandler *  handler  )

home_applet_handler_get_desktop_filepath: Called when desktopfilepath is wanted Parameters: handler  A handler as returned by home_applet_handler_new. Returns: desktop filepath

GtkEventBox* home_applet_handler_get_eventbox (  HomeAppletHandler *  handler  )

home_applet_handler_get_eventbox: Called when eventbox of applet is wanted Parameters: handler  A handler as returned by home_applet_handler_new. Returns: eventbox of applet

const gchar* home_applet_handler_get_libraryfile (  HomeAppletHandler *  handler  )

home_applet_handler_get_libraryfile: Called when libraryfile is wanted Parameters: handler  A handler as returned by home_applet_handler_new. Returns: library filepath

void home_applet_handler_get_minimum_size (  HomeAppletHandler *  handler, gint *  minwidth, gint *  minheight )

home_applet_handler_get_minimum_size: Called when the applet minimum size is wanted. If value returned is zero, resizing is not allowed to dimension. Parameters: handler  A handler as returned by home_applet_handler_new. minwidth  storage place where width minimum is saved minheight  storage place where height minimum is saved

void home_applet_handler_get_resizable (  HomeAppletHandler *  handler, gboolean *  resizable_width, gboolean *  resizable_height )

home_applet_handler_get_resizable: Called when the applet resizable dimensions statuses are wanted. If value returned is FALSE, resizing is not allowed to dimension. Parameters: handler  A handler as returned by home_applet_handler_new. resizable_width  storage place where resizable status of width is saved resizable_height  storage place where resizable status of height is saved

void home_applet_handler_get_size (  HomeAppletHandler *  handler, gint *  width, gint *  height )

home_applet_handler_get_size: Called when the applet size is wanted. Parameters: handler  A handler as returned by home_applet_handler_new. width  storage place where width is saved height  storage place where height is saved

GType home_applet_handler_get_type (  void   )

home_applet_handler_get_type: A GType of applet handler

HomeAppletHandler* home_applet_handler_new (  const char *  desktoppath, void *  state_data, int *  state_size )

home_applet_handler_new: This is called when Home loads the applet from handler. Applet may load it self in initial state or in state given. It loads a GtkWidget that Home will use to display the applet. Parameters: desktoppath  The path of the applet .desktop definition file. This is also unique identifier for applet in Home context state_data  Statesaved data as returned by applet_save_state. NULL if applet is to be loaded in initial state. state_size  Size of the state data. A .

int home_applet_handler_save_state (  HomeAppletHandler *  handler, void **  state_data, int *  state_size )

home_applet_handler_save_state: Method called to save the UI state of the applet Parameters: handler  A handler as returned by home_applet_handler_new. state_data  Applet allocates memory for state data and stores pointer here. Must be freed by the calling application Parameters: state_size  Applet stores the size of the state data allocated here. Returns: '1' if successfull.

void home_applet_handler_set_coordinates (  HomeAppletHandler *  handler, gint  x, gint  y )

home_applet_handler_set_coordinates: Called when the applet coordinates are set Parameters: handler  A handler as returned by home_applet_handler_new. x  New x coordinate for applet y  New y coordinate for applet

void home_applet_handler_set_minimum_size (  HomeAppletHandler *  handler, gint  minwidth, gint  minheight )

home_applet_handler_set_minimum_size: Called when the applet minimum size is wanted to set. If value is zero, resizing is not allowed to dimension. Parameters: handler  A handler as returned by home_applet_handler_new. minwidth  New minimum width to set minheight  New minimum height to set

void home_applet_handler_set_resizable (  HomeAppletHandler *  handler, gboolean  resizable_width, gboolean  resizable_height )

home_applet_handler_set_resizable: Called when the applet resizable dimensions statuses are wanted to set. If value is FALSE, resizing is not allowed to dimension. Parameters: handler  A handler as returned by home_applet_handler_new. resizable_width  storage place where resizable status of width is saved resizable_height  storage place where resizable status of height is saved

void home_applet_handler_set_size (  HomeAppletHandler *  handler, gint  width, gint  height )

home_applet_handler_set_size: Called when the applet size is wanted to set Parameters: handler  A handler as returned by home_applet_handler_new. width  New width to set height  New height to set

GtkWidget* home_applet_handler_settings (  HomeAppletHandler *  handler, GtkWindow *  parent )

home_applet_handler_settings: Called when the applet needs to open a properties dialog Parameters: handler  A handler as returned by home_applet_handler_new. parent  a parent window. Returns: usually gtkmenuitem

void home_applet_handler_store_size (  HomeAppletHandler *  handler  )

home_applet_handler_set_size: Called when the applet size is wanted to store to handler from eventbox. Parameters: handler  A handler as returned by home_applet_handler_new.

---