FAQ Index - Search - Recent Changes - Everything - Add entry

<< Previous Entry | FAQ Entry 13.56 | Next Entry >>

13.56. How do I create my own CellRendererDate?

There is no CellRenderer for entering a date via gtk.Calendar, we have to create own custom widget based on gtk.CellRendererText. Usually the CellRenderer creates onw gtk.Editable and returns it at the end of do_start_editing() method. This editable is then drawn inside the cell being edited and has to fit within it - which is not possible for a calendar (because of its size).

We have to bypass all this "editable machinery", create own popup window (based on decoration-less, non-modal gtk.Dialog), properly position it (very tricky) below the cell being edited and handle the date entering. Being non-modal allows us to handle the focus-out event as cancel editing (user just clicks away from the calendar).

  class CellRendererDate(gtk.CellRendererText):

    __gtype_name__ = 'CellRendererDate'

    def __init__(self):
      self.date_format = '%d/%m/%Y'
      self.calendar_window = None
      self.calendar = None

    def _create_calendar(self, treeview):
      self.calendar_window = gtk.Dialog(parent=treeview.get_toplevel())
      self.calendar_window.set_property('skip-taskbar-hint', True)

      self.calendar = gtk.Calendar()
      self.calendar.display_options(gtk.CALENDAR_SHOW_DAY_NAMES | gtk.CALENDAR_SHOW_HEADING)
      self.calendar.connect('day-selected-double-click', self._day_selected, None)
      self.calendar.connect('key-press-event', self._day_selected)
      self.calendar.connect('focus-out-event', self._selection_cancelled)
      self.calendar_window.set_transient_for(None) # cancel the modality of dialog

      # necessary for getting the (width, height) of calendar_window

    def do_start_editing(self, event, treeview, path, background_area, cell_area, flags):
      if not self.get_property('editable'):

      if not self.calendar_window:

      # select cell's previously stored date if any exists - or today
      if self.get_property('text'):
        date = datetime.datetime.strptime(self.get_property('text'), self.date_format)
        date = datetime.datetime.today()
        self.calendar.freeze() # prevent flicker
        (year, month, day) = (date.year, date.month - 1, date.day) # datetime's month starts from one
        self.calendar.select_month(int(month), int(year))

        # position the popup below the edited cell (and try hard to keep the popup within the toplevel window)
        (tree_x, tree_y) = treeview.get_bin_window().get_origin()
        (tree_w, tree_h) = treeview.window.get_geometry()[2:4]
        (calendar_w, calendar_h) = self.calendar_window.window.get_geometry()[2:4]
        x = tree_x + min(cell_area.x, tree_w - calendar_w + treeview.get_visible_rect().x)
        y = tree_y + min(cell_area.y, tree_h - calendar_h + treeview.get_visible_rect().y)
        self.calendar_window.move(x, y)

        response = self.calendar_window.run()
        if response == gtk.RESPONSE_OK:
          (year, month, day) = self.calendar.get_date()
          date = datetime.date(year, month + 1, day).strftime (self.date_format) # gtk.Calendar's month starts from zero
          self.emit('edited', path, date)
        return None # don't return any editable, our gtk.Dialog did the work already

    def _day_selected(self, calendar, event):
      # event == None for day selected via doubleclick
      if not event or event.type == gtk.gdk.KEY_PRESS and gtk.gdk.keyval_name(event.keyval) == 'Return':
          return True

    def _selection_cancelled(self, calendar, event):
      return True
The date format could be further tweaked, especially for proper i11n.

PyGTK FAQ Wizard | PyGTK Homepage | Feedback to faq at pygtk.org