![]() |
![]() |
![]() |
Rhythmbox Development Reference Manual | ![]() |
---|---|---|---|---|
RBSearchEntry; RBSearchEntryClass; RBSearchEntry* rb_search_entry_new (void); void rb_search_entry_clear (RBSearchEntry *entry); void rb_search_entry_set_text (RBSearchEntry *entry, const char *text); gboolean rb_search_entry_searching (RBSearchEntry *entry); void rb_search_entry_grab_focus (RBSearchEntry *entry);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBox +----GtkHBox +----RBSearchEntry
The search entry contains a label and a text entry box. The text entry box (a SexyIconEntry) contains an icon that acts as a 'clear' button.
Signals are emitted when the search text changes, arbitrarily rate-limited to one every 300ms.
When the text entry widget is non-empty, its colours are changed to display the text in black on yellow.
typedef struct { GtkHBoxClass parent; void (*search) (RBSearchEntry *view, const char *text); void (*activate) (RBSearchEntry *entry); } RBSearchEntryClass;
RBSearchEntry* rb_search_entry_new (void);
Returns : |
new search entry widget. |
void rb_search_entry_clear (RBSearchEntry *entry);
Clears the search entry text. The 'search' signal will be emitted.
|
a RBSearchEntry |
void rb_search_entry_set_text (RBSearchEntry *entry, const char *text);
Sets the text in the search entry box. The 'search' signal will be emitted.
|
a RBSearchEntry |
|
new search text |
gboolean rb_search_entry_searching (RBSearchEntry *entry);
|
a RBSearchEntry |
Returns : |
TRUE if there is search text |
void rb_search_entry_grab_focus (RBSearchEntry *entry);
Grabs input focus for the text entry widget.
|
a RBSearchEntry |
"activate"
signalvoid user_function (RBSearchEntry *entry, gpointer user_data) : Run Last
Emitted when the entry is activated.
|
the RBSearchEntry |
|
user data set when the signal handler was connected. |
"search"
signalvoid user_function (RBSearchEntry *entry, gchar *text, gpointer user_data) : Run Last
Emitted when the search text changes. A signal handler must initiate a search on the current source.
|
the RBSearchEntry |
|
search text |
|
user data set when the signal handler was connected. |