flows.md

Flows

Starting the application

• Create GcalManager instance
• Creating a gcal_window
  1. Connect the handlers to GcalManager signals
  2. Get the date the app will show either from settings or from the actual view
  3. Instantiate every view
  4. Show the last active view (got from the settings)

Showing a view in a window

• Clean previous states (new event creation/search)
• API: gcal_window_view_changed
• Update GcalMainWindow.view_type
• Call update_view

Update the app date

• API: update_view: update only the active view 4. update NavBar headers

Update the app date. v2

• API: update_view: 3. update NavBar headers

Create an event

• First approach
  1. call gcal_window_new_event (from N or [New Event] menu item)
  2. set #GcalWindow:new-event-mode to TRUE
  3. disable toolbar
  4. call gcal_view_mark_current_unit
  5. call gcal_view_get_current_position
• Second approach:
  1. Receive #GcalView:create-event signal
  2. set #GcalWindow:new-event-mode to TRUE
  3. disable toolbar
• call gcal_window_show_new_event_widget
• handle outcome of the widget
• call gcal_view_clear_marks
• unset #GcalWindow:new-event-mode
• enable toolbar

Search events

• Init search
  1. set #GcalWindow:search-mode
  2. create #GcalSearchView
  3. update priv->header_bar
  4. add it to GtkStack, show it
• End search
  1. unset #GcalWindow:search-mode
  2. free GcalSearchView
  3. update header_bar
  4. reinstate last active view

Edit/show events

• API: event_activated

`#GcalManager:events-created