comparison finch/libgnt/gntentry.h @ 20751:fe77cc691f78

Some doxygen stuff.

20750:0ee0cad488b4

};

G_BEGIN_DECLS

/**
 * 
 *
 * @return
 */
GType gnt_entry_get_gtype(void);

/**
 * 
 * @param text
 *
 * @return
 */
GntWidget * gnt_entry_new(const char *text);

/**
 * 
 * @param entry
 * @param max
 */
void gnt_entry_set_max(GntEntry *entry, int max);

/**
 * 
 * @param entry
 * @param text
 */
void gnt_entry_set_text(GntEntry *entry, const char *text);

/**
 * 
 * @param entry
 * @param flag
 */
void gnt_entry_set_flag(GntEntry *entry, GntEntryFlag flag);

const char *gnt_entry_get_text(GntEntry *entry);

/**
 * 
 * @param entry
 */
void gnt_entry_clear(GntEntry *entry);

/**
 * 
 * @param entry
 * @param set
 */
void gnt_entry_set_masked(GntEntry *entry, gboolean set);

/**
 * 
 * @param entry
 * @param text
 */
void gnt_entry_add_to_history(GntEntry *entry, const char *text);

/**
 * 
 * @param entry
 * @param num
 */
void gnt_entry_set_history_length(GntEntry *entry, int num);

/**
 * 
 * @param entry
 * @param word
 */
void gnt_entry_set_word_suggest(GntEntry *entry, gboolean word);

/**
 * 
 * @param entry
 * @param always
 */
void gnt_entry_set_always_suggest(GntEntry *entry, gboolean always);

/**
 * 
 * @param entry
 * @param text
 */
void gnt_entry_add_suggest(GntEntry *entry, const char *text);

/**
 * 
 * @param entry
 * @param text
 */
void gnt_entry_remove_suggest(GntEntry *entry, const char *text);

G_END_DECLS

20751:fe77cc691f78

};

G_BEGIN_DECLS

/**
 * @return GType for GntEntry.
 */
GType gnt_entry_get_gtype(void);

/**
 * Create a new GntEntry.
 *
 * @param text   The text in the new entry box.
 *
 * @return  The newly created entry box.
 */
GntWidget * gnt_entry_new(const char *text);

/**
 * Set the maximum length of the text in the entry box.
 *
 * @param entry  The entry box.
 * @param max    The maximum length for text. A value of 0 means infinite length.
 */
void gnt_entry_set_max(GntEntry *entry, int max);

/**
 * Set the text in an entry box.
 *
 * @param entry The entry box.
 * @param text  The text to set in the box.
 */
void gnt_entry_set_text(GntEntry *entry, const char *text);

/**
 * Set flags an entry box.
 *
 * @param entry  The entry box.
 * @param flag   The flags to set for the entry box.
 */
void gnt_entry_set_flag(GntEntry *entry, GntEntryFlag flag);

/**
 * Get the text in an entry box.
 *
 * @param entry  The entry box.
 *
 * @return   The current text in the entry box.
 */
const char *gnt_entry_get_text(GntEntry *entry);

/**
 * Clear the text in the entry box.
 *
 * @param entry  The entry box.
 */
void gnt_entry_clear(GntEntry *entry);

/**
 * Set whether the text in the entry box should be masked for display.
 *
 * @param entry  The entry box.
 * @param set    @c TRUE if the text should be masked, @c FALSE otherwise.
 */
void gnt_entry_set_masked(GntEntry *entry, gboolean set);

/**
 * Add a text to the history list for the text. The history length for the
 * entry box needs to be set first by gnt_entry_set_history_length.
 *
 * @param entry  The entry box.
 * @param text   A new entry for the history list.
 */
void gnt_entry_add_to_history(GntEntry *entry, const char *text);

/**
 * Set the length of history for the entry box.
 *
 * @param entry  The entry box.
 * @param num    The maximum length of the history.
 */
void gnt_entry_set_history_length(GntEntry *entry, int num);

/**
 * Set whether the suggestions are for the entire entry box, or for each
 * individual word in the entry box.
 *
 * @param entry   The entry box.
 * @param word    @c TRUE if the suggestions are for individual words, @c FALSE otherwise.
 */
void gnt_entry_set_word_suggest(GntEntry *entry, gboolean word);

/**
 * Set whether to always display the suggestions list, or only when the
 * tab-completion key is pressed (the TAB key, by default).
 *
 * @param entry    The entry box.
 * @param always   @c TRUE if the suggestion list should always be displayed.
 */
void gnt_entry_set_always_suggest(GntEntry *entry, gboolean always);

/**
 * Add an item to the suggestion list.
 *
 * @param entry  The entry box.
 * @param text   An item to add to the suggestion list.
 */
void gnt_entry_add_suggest(GntEntry *entry, const char *text);

/**
 * Remove an entry from the suggestion list.
 *
 * @param entry  The entry box.
 * @param text   The item to remove from the suggestion list.
 */
void gnt_entry_remove_suggest(GntEntry *entry, const char *text);

G_END_DECLS