Aire-One
/
awesome
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Comments widgets functions

This commit is contained in:
Julien Danjou 2008-03-06 11:41:26 +01:00
parent dd9a1b99c4
commit 3d8b7565d4
1 changed files with 40 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

46
widget.c
View File

@ -1,7 +1,7 @@
/* /*
* widget.c - widget managing * widget.c - widget managing
* *
* Copyright © 2007 Julien Danjou <julien@danjou.info> * Copyright © 2007-2008 Julien Danjou <julien@danjou.info>
* Copyright © 2007 Aldo Cortesi <aldo@nullcube.com> * Copyright © 2007 Aldo Cortesi <aldo@nullcube.com>
* *
* This program is free software; you can redistribute it and/or modify * This program is free software; you can redistribute it and/or modify
@ -28,6 +28,11 @@ extern AwesomeConf globalconf;
#include "widgetgen.h" #include "widgetgen.h"
/** Compute widget alignment.
* This will process all widget starting at `widget' and will check their
* alignment and guess it if set to AlignAuto.
* \param widget a linked list of all widgets
*/
void void
widget_calculate_alignments(Widget *widget) widget_calculate_alignments(Widget *widget)
{ {
@ -64,6 +69,12 @@ widget_calculate_alignments(Widget *widget)
} }
} }
/** Compute offset for drawing the first pixel of a widget.
* \param barwidth the statusbar width
* \param widgetwidth the widget width
* \param alignment the widget alignment on statusbar
* \return the x coordinate to draw at
*/
int int
widget_calculate_offset(int barwidth, int widgetwidth, int offset, int alignment) widget_calculate_offset(int barwidth, int widgetwidth, int offset, int alignment)
{ {
@ -76,6 +87,11 @@ widget_calculate_offset(int barwidth, int widgetwidth, int offset, int alignment
return barwidth - offset - widgetwidth; return barwidth - offset - widgetwidth;
} }
/** Find a widget on a screen by its name
* \param name the widget name
* \param screen the screen to look into
* \return a widget
*/
static Widget * static Widget *
widget_find(char *name, int screen) widget_find(char *name, int screen)
{ {
@ -90,6 +106,11 @@ widget_find(char *name, int screen)
return NULL; return NULL;
} }
/** Common function for button press event on widget.
* It will look into configuration to find the callback function to call.
* \param widget the widget
* \param ev the XButtonPressedEvent the widget received
*/
static void static void
widget_common_button_press(Widget *widget, XButtonPressedEvent *ev) widget_common_button_press(Widget *widget, XButtonPressedEvent *ev)
{ {
@ -103,20 +124,27 @@ widget_common_button_press(Widget *widget, XButtonPressedEvent *ev)
} }
} }
/** Common tell function for widget, which only warn user that widget
* cannot be told anything
* \param widget the widget
* \param command unused argument
*/
static void static void
widget_common_tell(Widget *widget, char *command __attribute__ ((unused))) widget_common_tell(Widget *widget, char *command __attribute__ ((unused)))
{ {
warn("%s widget does not accept commands.\n", widget->name); warn("%s widget does not accept commands.\n", widget->name);
} }
/** Common function for creating a widget
* \param widget The allocated widget
* \param statusbar the statusbar the widget is on
* \param config the cfg_t structure we will parse to set common info
*/
void void
widget_common_new(Widget *widget, Statusbar *statusbar, cfg_t* config) widget_common_new(Widget *widget, Statusbar *statusbar, cfg_t *config)
{ {
const char *name;
widget->statusbar = statusbar; widget->statusbar = statusbar;
name = cfg_title(config); widget->name = a_strdup(cfg_title(config));
widget->name = a_strdup(name);
widget->tell = widget_common_tell; widget->tell = widget_common_tell;
widget->button_press = widget_common_button_press; widget->button_press = widget_common_button_press;
widget->area.x = cfg_getint(config, "x"); widget->area.x = cfg_getint(config, "x");
@ -125,6 +153,12 @@ widget_common_new(Widget *widget, Statusbar *statusbar, cfg_t* config)
widget->user_supplied_y = (widget->area.y != (int) 0xffffffff); widget->user_supplied_y = (widget->area.y != (int) 0xffffffff);
} }
/** Invalidate widgets which should be refresh upon
* external modifications. Widget who watch flags will
* be set to be refreshed.
* \param screen screen id
* \param flags cache flags
*/
void void
widget_invalidate_cache(int screen, int flags) widget_invalidate_cache(int screen, int flags)
{ {