widget.c

   1 /*
   2  * widget.c - widget managing
   3  *
   4  * Copyright © 2007-2008 Julien Danjou <julien@danjou.info>
   5  * Copyright © 2007 Aldo Cortesi <aldo@nullcube.com>
   6  *
   7  * This program is free software; you can redistribute it and/or modify
   8  * it under the terms of the GNU General Public License as published by
   9  * the Free Software Foundation; either version 2 of the License, or
  10  * (at your option) any later version.
  11  *
  12  * This program is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  * GNU General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU General Public License along
  18  * with this program; if not, write to the Free Software Foundation, Inc.,
  19  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  */
  22
  23 #include "widget.h"
  24 #include "statusbar.h"
  25 #include "event.h"
  26
  27 extern AwesomeConf globalconf;
  28
  29 #include "widgetgen.h"
  30
  31 /** Compute widget alignment.
  32  * This will process all widget starting at `widget' and will check their
  33  * alignment and guess it if set to AlignAuto.
  34  * \param widget a linked list of all widgets
  35  */
  36 void
  37 widget_calculate_alignments(Widget *widget)
  38 {
  39     for(; widget && widget->alignment != AlignFlex; widget = widget->next)
  40     {
  41         switch(widget->alignment)
  42         {
  43           case AlignCenter:
  44             warn("widgets cannot be center aligned\n");
  45           case AlignAuto:
  46             widget->alignment = AlignLeft;
  47             break;
  48           default:
  49             break;
  50         }
  51     }
  52
  53     if(widget)
  54         for(widget = widget->next; widget; widget = widget->next)
  55             switch(widget->alignment)
  56             {
  57               case AlignFlex:
  58                 warn("multiple flex widgets (%s) in panel -"
  59                      " ignoring flex for all but the first.\n", widget->name);
  60                 widget->alignment = AlignRight;
  61                 break;
  62               case AlignCenter:
  63                 warn("widget %s cannot be center aligned\n", widget->name);
  64               case AlignAuto:
  65                 widget->alignment = AlignRight;
  66                 break;
  67               default:
  68                 break;
  69             }
  70 }
  71
  72 /** Compute offset for drawing the first pixel of a widget.
  73  * \param barwidth the statusbar width
  74  * \param widgetwidth the widget width
  75  * \param alignment the widget alignment on statusbar
  76  * \return the x coordinate to draw at
  77  */
  78 int
  79 widget_calculate_offset(int barwidth, int widgetwidth, int offset, int alignment)
  80 {
  81     switch(alignment)
  82     {
  83       case AlignLeft:
  84       case AlignFlex:
  85         return offset;
  86     }
  87     return barwidth - offset - widgetwidth;
  88 }
  89
  90 /** Find a widget on a screen by its name
  91  * \param name the widget name
  92  * \param screen the screen to look into
  93  * \return a widget
  94  */
  95 static Widget *
  96 widget_find(char *name, int screen)
  97 {
  98     Widget *widget;
  99     Statusbar *sb;
 100
 101     for(sb = globalconf.screens[screen].statusbar; sb; sb = sb->next)
 102         for(widget = sb->widgets; widget; widget = widget->next)
 103             if(a_strcmp(name, widget->name) == 0)
 104                 return widget;
 105
 106     return NULL;
 107 }
 108
 109 /** Common function for button press event on widget.
 110  * It will look into configuration to find the callback function to call.
 111  * \param widget the widget
 112  * \param ev the XButtonPressedEvent the widget received
 113  */
 114 static void
 115 widget_common_button_press(Widget *widget, XButtonPressedEvent *ev)
 116 {
 117     Button *b;
 118
 119     for(b = widget->buttons; b; b = b->next)
 120         if(ev->button == b->button && CLEANMASK(ev->state) == b->mod && b->func)
 121         {
 122             b->func(widget->statusbar->screen, b->arg);
 123             break;
 124         }
 125 }
 126
 127 /** Common tell function for widget, which only warn user that widget
 128  * cannot be told anything
 129  * \param widget the widget
 130  * \param command unused argument
 131  */
 132 static void
 133 widget_common_tell(Widget *widget, char *command __attribute__ ((unused)))
 134 {
 135     warn("%s widget does not accept commands.\n", widget->name);
 136 }
 137
 138 /** Common function for creating a widget
 139  * \param widget The allocated widget
 140  * \param statusbar the statusbar the widget is on
 141  * \param config the cfg_t structure we will parse to set common info
 142  */
 143 void
 144 widget_common_new(Widget *widget, Statusbar *statusbar, cfg_t *config)
 145 {
 146     widget->statusbar = statusbar;
 147     widget->name = a_strdup(cfg_title(config));
 148     widget->tell = widget_common_tell;
 149     widget->button_press = widget_common_button_press;
 150     widget->area.x = cfg_getint(config, "x");
 151     widget->area.y = cfg_getint(config, "y");
 152     widget->user_supplied_x = (widget->area.x != (int) 0xffffffff);
 153     widget->user_supplied_y = (widget->area.y != (int) 0xffffffff);
 154 }
 155
 156 /** Invalidate widgets which should be refresh upon
 157  * external modifications. Widget who watch flags will
 158  * be set to be refreshed.
 159  * \param screen screen id
 160  * \param flags cache flags
 161  */
 162 void
 163 widget_invalidate_cache(int screen, int flags)
 164 {
 165     Statusbar *statusbar;
 166     Widget *widget;
 167
 168     for(statusbar = globalconf.screens[screen].statusbar;
 169         statusbar;
 170         statusbar = statusbar->next)
 171         for(widget = statusbar->widgets; widget; widget = widget->next)
 172             if(widget->cache.flags & flags)
 173                 widget->cache.needs_update = True;
 174 }
 175
 176 /** Send command to widget
 177  * \param screen Screen ID
 178  * \param arg Widget command. Syntax depends on specific widget.
 179  * \ingroup ui_callback
 180  */
 181 void
 182 uicb_widget_tell(int screen, char *arg)
 183 {
 184     Widget *widget;
 185     char *p, *command;
 186     ssize_t len;
 187
 188     if (!arg)
 189     {
 190         warn("Must specify a widget.\n");
 191         return;
 192     }
 193
 194     len = a_strlen(arg);
 195     p = strtok(arg, " ");
 196     if(!p)
 197     {
 198         warn("Ignoring malformed widget command.\n");
 199         return;
 200     }
 201
 202     widget = widget_find(p, screen);
 203     if(!widget)
 204     {
 205         warn("No such widget: %s\n", p);
 206         return;
 207     }
 208
 209     if(p + a_strlen(p) < arg + len)
 210     {
 211         p = p + a_strlen(p) + 1;
 212         len = a_strlen(p);
 213         command = p_new(char, len + 1);
 214         a_strncpy(command, len + 1, p, len);
 215         widget->tell(widget, command);
 216         p_delete(&command);
 217     }
 218     else
 219         widget->tell(widget, NULL);
 220
 221     widget->cache.needs_update = True;
 222
 223     return;
 224 }
 225
 226 // vim: filetype=c:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:encoding=utf-8:textwidth=80