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 *property __attribute__ ((unused)),
 134                    char *command __attribute__ ((unused)))
 135 {
 136     warn("%s widget does not accept commands.\n", widget->name);
 137 }
 138
 139 /** Common function for creating a widget
 140  * \param widget The allocated widget
 141  * \param statusbar the statusbar the widget is on
 142  * \param config the cfg_t structure we will parse to set common info
 143  */
 144 void
 145 widget_common_new(Widget *widget, Statusbar *statusbar, cfg_t *config)
 146 {
 147     widget->statusbar = statusbar;
 148     widget->name = a_strdup(cfg_title(config));
 149     widget->tell = widget_common_tell;
 150     widget->button_press = widget_common_button_press;
 151     widget->area.x = cfg_getint(config, "x");
 152     widget->area.y = cfg_getint(config, "y");
 153     widget->user_supplied_x = (widget->area.x != (int) 0xffffffff);
 154     widget->user_supplied_y = (widget->area.y != (int) 0xffffffff);
 155 }
 156
 157 /** Invalidate widgets which should be refresh upon
 158  * external modifications. Widget who watch flags will
 159  * be set to be refreshed.
 160  * \param screen screen id
 161  * \param flags cache flags
 162  */
 163 void
 164 widget_invalidate_cache(int screen, int flags)
 165 {
 166     Statusbar *statusbar;
 167     Widget *widget;
 168
 169     for(statusbar = globalconf.screens[screen].statusbar;
 170         statusbar;
 171         statusbar = statusbar->next)
 172         for(widget = statusbar->widgets; widget; widget = widget->next)
 173             if(widget->cache.flags & flags)
 174                 widget->cache.needs_update = True;
 175 }
 176
 177 /** Send command to widget
 178  * \param screen Screen ID
 179  * \param arg Widget command. Syntax depends on specific widget.
 180  * \ingroup ui_callback
 181  */
 182 void
 183 uicb_widget_tell(int screen, char *arg)
 184 {
 185     Widget *widget;
 186     char *p, *property = NULL, *command;
 187     ssize_t len;
 188
 189     if (!arg)
 190     {
 191         warn("Must specify a widget.\n");
 192         return;
 193     }
 194
 195     len = a_strlen(arg);
 196     p = strtok(arg, " ");
 197     if(!p)
 198     {
 199         warn("Ignoring malformed widget command.\n");
 200         return;
 201     }
 202
 203     widget = widget_find(p, screen);
 204     if(!widget)
 205     {
 206         warn("No such widget: %s\n", p);
 207         return;
 208     }
 209
 210     p = strtok(NULL, " ");
 211     if(!p)
 212     {
 213         warn("Ignoring malformed widget command.\n");
 214         return;
 215     }
 216
 217     property = p;
 218
 219     if(p + a_strlen(p) < arg + len)
 220     {
 221         p = p + a_strlen(p) + 1;
 222         len = a_strlen(p);
 223         command = p_new(char, len + 1);
 224         a_strncpy(command, len + 1, p, len);
 225         widget->tell(widget, property, command);
 226         p_delete(&command);
 227     }
 228     else
 229         widget->tell(widget, property, NULL);
 230
 231     widget->cache.needs_update = True;
 232
 233     return;
 234 }
 235
 236 // vim: filetype=c:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:encoding=utf-8:textwidth=80