| Rhythmbox Development Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Signals | ||||
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
RBSearchEntry implements AtkImplementorIface, GtkBuildable and GtkOrientable.
The search entry contains a label and a text entry box. The text entry box 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);
Creates a new search entry widget.
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);
Returns TRUE if there is search text in the entry widget.
|
a RBSearchEntry |
Returns : |
TRUE if searching
|
void rb_search_entry_grab_focus (RBSearchEntry *entry);
Grabs input focus for the text entry widget.
|
a RBSearchEntry |
"activate" signalvoid user_function (RBSearchEntry *entry, gchar *text, gpointer user_data) : Run Last
Emitted when the entry is activated.
|
the RBSearchEntry |
|
search text |
|
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. |