System notification

Enumerations
enum	osso_system_note_type_t { OSSO_GN_WARNING = 0, OSSO_GN_ERROR, OSSO_GN_NOTICE, OSSO_GN_WAIT }
Functions
osso_return_t	osso_system_note_dialog (osso_context_t *osso, const gchar *message, osso_system_note_type_t type, osso_rpc_t *retval)
osso_return_t	osso_system_note_infoprint (osso_context_t *osso, const gchar *text, osso_rpc_t *retval)

---

Enumeration Type Documentation

enum osso_system_note_type_t

This is the type of system note, in other words it specifies what kind of an icon to use on the note. Enumeration values: OSSO_GN_WARNING  The message is a warning. OSSO_GN_ERROR  The message is an error. OSSO_GN_NOTICE  The message is a notice. OSSO_GN_WAIT

---

Function Documentation

osso_return_t osso_system_note_dialog (  osso_context_t *  osso, const gchar *  message, osso_system_note_type_t  type, osso_rpc_t *  retval )

This function will request that a system note (a window that is modal to the whole system) is shown. The note has a single OK button. This function enables non-GUI programs to show some information to the user. Applications that do have a GUI should not use this function but the hildon_note widget directly. Parameters: osso  The library context as returned by osso_initialize. message  The contents for the system note. type  The type of system note: OSSO_GN_WARNING - warning dialog with an exclamation mark icon, OSSO_GN_ERROR - error dialog, OSSO_GN_NOTICE - informative dialog with an 'i' icon. retval  This parameter will be used to store possible return data of from the statusbar. If NULL, no data is expected, or it should be ignored. You should call osso_rpc_free_val for this structure when it is no longer needed. Returns: OSSO_OK if no errors occurred, OSSO_INVALID if some parameters are invalid, and OSSO_ERROR if some other error occurs.

osso_return_t osso_system_note_infoprint (  osso_context_t *  osso, const gchar *  text, osso_rpc_t *  retval )

This function requests that the statusbar shows an infoprint (aka information banner). This allows non-GUI applications to display some information to the user. Applications that do have a GUI should not use this function, but the gtk_infoprint widget directly. Parameters: osso  The library context as returned by osso_initialize. text  The text to display on the infoprint. retval  This parameter will be used to store a possible return data from the statusbar. If NULL, no data is expected, or it should be ignored. You should call osso_rpc_free_val for this structure when it is no longer needed. Returns: OSSO_OK if no errors occurred, OSSO_INVALID if some parameters are invalid, and OSSO_ERROR if some other error occurs.

---