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.

Enumerator:
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.


Generated on Thu Jul 6 13:33:57 2006 for LibOSSO by  doxygen 1.4.6