comparison finch/libgnt/gntcombobox.h @ 19116:992afeb1d40f

Added some docs
author Eric Polino <aluink@pidgin.im>
date Wed, 27 Jun 2007 02:51:00 +0000
parents 8410511f4dbb
children b25cb0775be3
comparison
equal deleted inserted replaced
19115:4c26b23e7859 19116:992afeb1d40f
63 }; 63 };
64 64
65 G_BEGIN_DECLS 65 G_BEGIN_DECLS
66 66
67 /** 67 /**
68 * 68 *
69 * Get the GType for GntComboBox
69 * 70 *
70 * @return 71 * @return
71 */ 72 */
72 GType gnt_combo_box_get_gtype(void); 73 GType gnt_combo_box_get_gtype(void);
73 74
74 /** 75 /**
75 * 76 *
77 * Create a new GntComboBox
76 * 78 *
77 * @return 79 * @return A new GntComboBox
78 */ 80 */
79 GntWidget * gnt_combo_box_new(void); 81 GntWidget * gnt_combo_box_new(void);
80 82
81 /** 83 /**
82 * 84 *
83 * @param box 85 * Add an entry
84 * @param key 86 *
85 * @param text 87 * @param box The GntComboBox
88 * @param key The data
89 * @param text The text to display
86 */ 90 */
87 void gnt_combo_box_add_data(GntComboBox *box, gpointer key, const char *text); 91 void gnt_combo_box_add_data(GntComboBox *box, gpointer key, const char *text);
88 92
89 /** 93 /**
94 *
95 * Remove an entry
90 * 96 *
91 * @param box 97 * @param box The GntComboBox
92 * @param key 98 * @param key The data to be removed
93 */ 99 */
94 void gnt_combo_box_remove(GntComboBox *box, gpointer key); 100 void gnt_combo_box_remove(GntComboBox *box, gpointer key);
95 101
96 /** 102 /**
97 * 103 *
98 * @param box 104 * Remove all entries
105 *
106 * @param box The GntComboBox
99 */ 107 */
100 void gnt_combo_box_remove_all(GntComboBox *box); 108 void gnt_combo_box_remove_all(GntComboBox *box);
101 109
102 /** 110 /**
103 * 111 *
104 * @param box 112 * Get the data that is currently selected
105 * 113 *
106 * @return 114 * @param box The GntComboBox
115 *
116 * @return The data of the currently selected entry
107 */ 117 */
108 gpointer gnt_combo_box_get_selected_data(GntComboBox *box); 118 gpointer gnt_combo_box_get_selected_data(GntComboBox *box);
109 119
110 /** 120 /**
111 * 121 *
112 * @param box 122 * Set the current selection to a specific entry
113 * @param key 123 *
124 * @param box The GntComboBox
125 * @param key The data to be set to
114 */ 126 */
115 void gnt_combo_box_set_selected(GntComboBox *box, gpointer key); 127 void gnt_combo_box_set_selected(GntComboBox *box, gpointer key);
116 128
117 G_END_DECLS 129 G_END_DECLS
118 130