![]() |
![]() |
![]() |
Rhythmbox Development Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Signals |
struct RBSearchEntry; struct 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 +----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.
struct RBSearchEntryClass { GtkHBoxClass parent; void (*search) (RBSearchEntry *view, const char *text); void (*activate) (RBSearchEntry *entry); };
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. |