chiark / gitweb /
login details box for disobedience. a bit unfriendly but does work.
[disorder] / disobedience / misc.c
index 26222a9a9baeb59d49feb8270306b2971d6387c3..1cb6d5a0439a839ff4b2dd1f937ffd3b9d8197bb 100644 (file)
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
  * USA
  */
+/** @file disobedience/misc.c
+ * @brief Miscellaneous GTK+ interfacing stuff
+ */
 
 #include "disobedience.h"
 
 /* Miscellaneous GTK+ stuff ------------------------------------------------ */
 
+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);
@@ -55,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 };
 
@@ -68,11 +87,13 @@ GdkPixbuf *find_image(const char *name) {
       error(0, "%s", err->message);
       return 0;
     }
+    NW(cached_image);
     cache_put(&image_cache_type, name,  pb);
   }
   return pb;
 }
 
+/** @brief Pop up an error message */
 void popup_error(const char *msg) {
   GtkWidget *w;
 
@@ -85,6 +106,57 @@ void popup_error(const char *msg) {
   gtk_widget_destroy(w);
 }
 
+/** @brief Pop up an error message */
+void fpopup_error(const char *fmt, ...) {
+  va_list ap;
+  char *msg;
+
+  va_start(ap, fmt);
+  byte_xvasprintf(&msg, fmt, ap);
+  va_end(ap);
+  popup_error(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
@@ -93,5 +165,3 @@ fill-column:79
 indent-tabs-mode:nil
 End:
 */
-
-/* arch-tag:tV2wkVwV3p2A66vyViQJSw */