Osso Addressbook Reference Manual | ||||
---|---|---|---|---|
OssoABookLiveSearch; GtkWidget* osso_abook_live_search_new (void); void osso_abook_live_search_append_text (OssoABookLiveSearch *livesearch, const char *utf8); const char* osso_abook_live_search_get_text (OssoABookLiveSearch *livesearch); void osso_abook_live_search_set_filter (OssoABookLiveSearch *livesearch, OssoABookFilterModel *filter); void osso_abook_live_search_widget_hook (OssoABookLiveSearch *livesearch, GtkWidget *widget, GtkTreeView *kb_focus); void osso_abook_live_search_widget_unhook (OssoABookLiveSearch *livesearch); void osso_abook_live_search_save_state (OssoABookLiveSearch *livesearch, GKeyFile *key_file); void osso_abook_live_search_restore_state (OssoABookLiveSearch *livesearch, GKeyFile *key_file);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkToolbar +----OssoABookLiveSearch
OssoABookLiveSearch implements AtkImplementorIface, GtkBuildable and GtkToolShell.
typedef struct _OssoABookLiveSearch OssoABookLiveSearch;
All the fields of this structure are private to the object's implementation and should never be accessed directly.
GtkWidget* osso_abook_live_search_new (void);
Creates and returns a new OssoABookLiveSearch widget.
Returns : | The newly created live search widget. |
void osso_abook_live_search_append_text (OssoABookLiveSearch *livesearch, const char *utf8);
Appends a string to the entry text in the live search widget.
livesearch : |
An OssoABookLiveSearch widget |
utf8 : |
The text to append. This text is copied internally, and utf8 can be freed later by the caller.
|
const char* osso_abook_live_search_get_text (OssoABookLiveSearch *livesearch);
Retrieves the text contents of the OssoABookLiveSearch widget.
livesearch : |
An OssoABookLiveSearch widget |
Returns : | a pointer to the text contents of the widget as a string. This string points to an internal widget buffer and must not be freed, modified or stored. |
void osso_abook_live_search_set_filter (OssoABookLiveSearch *livesearch, OssoABookFilterModel *filter);
Sets the filter for livesearch
.
livesearch : |
An OssoABookLiveSearch widget |
filter : |
a OssoABookFilterModel, or NULL
|
void osso_abook_live_search_widget_hook (OssoABookLiveSearch *livesearch, GtkWidget *widget, GtkTreeView *kb_focus);
This function must be called after an OssoABookLiveSearch widget is
constructed to set the hook widget and the focus widget for
livesearch
. After that, the OssoABookLiveSearch widget can be
packed into a container and used.
livesearch : |
An OssoABookLiveSearch widget |
hook_widget : |
A widget on which we listen for key events |
kb_focus : |
The widget which we grab focus on |
void osso_abook_live_search_widget_unhook (OssoABookLiveSearch *livesearch);
This function unsets the hook and focus widgets which were set
earlier using osso_abook_live_search_widget_hook()
.
livesearch : |
An OssoABookLiveSearch widget |
void osso_abook_live_search_save_state (OssoABookLiveSearch *livesearch, GKeyFile *key_file);
Saves the live search text to a GKeyFile.
livesearch : |
An OssoABookLiveSearch widget |
key_file : |
The key file to save to |
void osso_abook_live_search_restore_state (OssoABookLiveSearch *livesearch, GKeyFile *key_file);
Restores a live search widget's text from a GKeyFile.
livesearch : |
An OssoABookLiveSearch widget |
key_file : |
The key file to read from |