|
|
|
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 GtkBuildable, AtkImplementorIface 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 |