X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~mdw/git/disorder/blobdiff_plain/e9b70a84ae0e40ea4bcaa6e557f2f67eea57cfd3..043d60b14ea6b3a5aa20b541e0db31433564e662:/disobedience/misc.c

diff --git a/disobedience/misc.c b/disobedience/misc.c
index d0caf3b..c268654 100644
--- a/disobedience/misc.c
+++ b/disobedience/misc.c
@@ -17,6 +17,9 @@
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
  * USA
  */
+/** @file disobedience/misc.c
+ * @brief Miscellaneous GTK+ interfacing stuff
+ */
 
 #include "disobedience.h"
 
@@ -26,6 +29,11 @@ WT(cached_image);
 
 /* Functions */
 
+/** @brief Put scrollbars around a widget
+ * @param child Widget to surround
+ * @param widgetname Name for (both) widgets
+ * @return Scroll widget
+ */
 GtkWidget *scroll_widget(GtkWidget *child,
                          const char *widgetname) {
   GtkWidget *scroller = gtk_scrolled_window_new(0, 0);
@@ -57,6 +65,15 @@ GtkWidget *scroll_widget(GtkWidget *child,
   return scroller;
 }
 
+/** @brief Find an image
+ * @param name Relative path to image
+ * @return pixbuf containing image
+ *
+ * Images are cached so it's perfectly sensible to call this lots of times even
+ * for the same image.
+ *
+ * Images are searched for in @c pkgdatadir/static.
+ */
 GdkPixbuf *find_image(const char *name) {
   static const struct cache_type image_cache_type = { INT_MAX };
 
@@ -76,18 +93,70 @@ GdkPixbuf *find_image(const char *name) {
   return pb;
 }
 
-void popup_error(const char *msg) {
+/** @brief Pop up a message */
+void popup_msg(GtkMessageType mt, const char *msg) {
   GtkWidget *w;
 
   w = gtk_message_dialog_new(GTK_WINDOW(toplevel),
                              GTK_DIALOG_MODAL|GTK_DIALOG_DESTROY_WITH_PARENT,
-                             GTK_MESSAGE_ERROR,
+                             mt,
                              GTK_BUTTONS_CLOSE,
                              "%s", msg);
   gtk_dialog_run(GTK_DIALOG(w));
   gtk_widget_destroy(w);
 }
 
+/** @brief Pop up an error message */
+void fpopup_msg(GtkMessageType mt, const char *fmt, ...) {
+  va_list ap;
+  char *msg;
+
+  va_start(ap, fmt);
+  byte_xvasprintf(&msg, fmt, ap);
+  va_end(ap);
+  popup_msg(mt, msg);
+}
+
+/** @brief Create a button with an icon in it
+ * @param path (relative) path to image
+ * @param tooltip Tooltip or NULL to not set one
+ * @return Button
+ */
+GtkWidget *iconbutton(const char *path, const char *tip) {
+  GtkWidget *button, *content;;
+  GdkPixbuf *pb;
+
+  NW(button);
+  button = gtk_button_new();
+  if((pb = find_image(path))) {
+    NW(image);
+    content = gtk_image_new_from_pixbuf(pb);
+  } else {
+    NW(label);
+    content = gtk_label_new(path);
+  }
+  gtk_container_add(GTK_CONTAINER(button), content);
+  if(tip)
+    gtk_tooltips_set_tip(tips, button, tip, "");
+  return button;
+}
+
+/** @brief Create buttons and pack them into an hbox */
+GtkWidget *create_buttons(const struct button *buttons,
+                          size_t nbuttons) {
+  size_t n;
+  GtkWidget *const hbox = gtk_hbox_new(FALSE, 1);
+
+  for(n = 0; n < nbuttons; ++n) {
+    GtkWidget *const button = gtk_button_new_from_stock(buttons[n].stock);
+    g_signal_connect(G_OBJECT(button), "clicked",
+                     G_CALLBACK(buttons[n].clicked), 0);
+    gtk_box_pack_start(GTK_BOX(hbox), button, FALSE, FALSE, 1);
+    gtk_tooltips_set_tip(tips, button, buttons[n].tip, "");
+  }
+  return hbox;
+}
+
 /*
 Local Variables:
 c-basic-offset:2