Mercurial > pidgin.yaz
comparison pidgin/minidialog.h @ 30909:25e200cb3532
propagate from branch 'im.pidgin.pidgin' (head dca20e09164518b0f7a773edd7e9649f41d8873d)
to branch 'im.pidgin.cpw.malu.xmpp.google_refactor' (head 7823c556f2d1bbca43f5ef9f0fea30cabc5d313f)
| author | Marcus Lundblad <ml@update.uu.se> |
|---|---|
| date | Tue, 31 Aug 2010 18:28:10 +0000 |
| parents | c62fac7ada0d |
| children | 691c7bc95b3f |
comparison
equal
deleted
inserted
replaced
| 30908:c44ec533a48c | 30909:25e200cb3532 |
|---|---|
| 71 * </dd> | 71 * </dd> |
| 72 * <dt><tt>"icon-name"</tt> (<tt>char *</tt>)</dt> | 72 * <dt><tt>"icon-name"</tt> (<tt>char *</tt>)</dt> |
| 73 * <dd>The Gtk stock id of an icon for the dialog, or @c NULL for no icon. | 73 * <dd>The Gtk stock id of an icon for the dialog, or @c NULL for no icon. |
| 74 * @see pidginstock.h | 74 * @see pidginstock.h |
| 75 * </dd> | 75 * </dd> |
| 76 * <dt><tt>"custom-icon"</tt> (<tt>GdkPixbuf *</tt>)</dt> | |
| 77 * <dd>The custom icon to use instead of a stock one (overrides the "icon-name" property).</dd> | |
| 76 * </dl> | 78 * </dl> |
| 77 */ | 79 */ |
| 78 typedef struct { | 80 typedef struct { |
| 79 GtkVBox parent; | 81 GtkVBox parent; |
| 80 | 82 |
| 106 GtkButton *button, gpointer user_data); | 108 GtkButton *button, gpointer user_data); |
| 107 | 109 |
| 108 /** Get the GType of #PidginMiniDialog. */ | 110 /** Get the GType of #PidginMiniDialog. */ |
| 109 GType pidgin_mini_dialog_get_type (void); | 111 GType pidgin_mini_dialog_get_type (void); |
| 110 | 112 |
| 111 /** Creates a new #PidginMiniDialog. This is a shortcut for creating the dialog | 113 /** Creates a new #PidginMiniDialog with a stock icon. This is a shortcut for creating the dialog |
| 112 * with @c g_object_new() then setting each property yourself. | 114 * with @c g_object_new() then setting each property yourself. |
| 113 * @return a new #PidginMiniDialog. | 115 * @return a new #PidginMiniDialog. |
| 114 */ | 116 */ |
| 115 PidginMiniDialog *pidgin_mini_dialog_new(const gchar *title, | 117 PidginMiniDialog *pidgin_mini_dialog_new(const gchar *title, |
| 116 const gchar *description, const gchar *icon_name); | 118 const gchar *description, const gchar *icon_name); |
| 119 | |
| 120 /** Creates a new #PidginMiniDialog with a custom icon. This is a shortcut for creating the dialog | |
| 121 * with @c g_object_new() then setting each property yourself. | |
| 122 * @return a new #PidginMiniDialog. | |
| 123 */ | |
| 124 PidginMiniDialog *pidgin_mini_dialog_new_with_custom_icon(const gchar *title, | |
| 125 const gchar *description, GdkPixbuf *custom_icon); | |
| 117 | 126 |
| 118 /** Shortcut for setting a mini-dialog's title via GObject properties. | 127 /** Shortcut for setting a mini-dialog's title via GObject properties. |
| 119 * @param mini_dialog a mini-dialog | 128 * @param mini_dialog a mini-dialog |
| 120 * @param title the new title for @a mini_dialog | 129 * @param title the new title for @a mini_dialog |
| 121 */ | 130 */ |
| 135 * @param icon_name the Gtk stock ID of an icon, or @c NULL for no icon. | 144 * @param icon_name the Gtk stock ID of an icon, or @c NULL for no icon. |
| 136 */ | 145 */ |
| 137 void pidgin_mini_dialog_set_icon_name(PidginMiniDialog *mini_dialog, | 146 void pidgin_mini_dialog_set_icon_name(PidginMiniDialog *mini_dialog, |
| 138 const char *icon_name); | 147 const char *icon_name); |
| 139 | 148 |
| 149 /** Shortcut for setting a mini-dialog's custom icon via GObject properties. | |
| 150 * @param mini_dialog a mini-dialog | |
| 151 * @param icon_name the pixbuf to use as a custom icon | |
| 152 */ | |
| 153 void pidgin_mini_dialog_set_custom_icon(PidginMiniDialog *mini_dialog, | |
| 154 GdkPixbuf *custom_icon); | |
| 155 | |
| 140 /** Adds a new button to a mini-dialog, and attaches the supplied callback to | 156 /** Adds a new button to a mini-dialog, and attaches the supplied callback to |
| 141 * its <tt>clicked</tt> signal. After a button is clicked, the dialog is | 157 * its <tt>clicked</tt> signal. After a button is clicked, the dialog is |
| 142 * destroyed. | 158 * destroyed. |
| 143 * @param mini_dialog a mini-dialog | 159 * @param mini_dialog a mini-dialog |
| 144 * @param text the text to display on the new button | 160 * @param text the text to display on the new button |