Miscellaneous functions which handle calendar components.
[Calendaring background]


Functions

void display_icaltimetype_as_webform (struct icaltimetype *t, char *prefix)
 display and edit date/time The display_icaltimetype_as_webform() and icaltime_from_webform() functions handle the display and editing of date/time properties in web pages. The first one converts an icaltimetype into valid HTML markup -- a series of form fields for editing the date and time. When the user submits the form, the results can be fed back into the second function, which turns it back into an icaltimetype. The "prefix" string required by both functions is prepended to all field names. This allows a form to contain more than one date/time property (for example, a start and end time) by ensuring the field names are unique within the form.
void icaltime_from_webform (struct icaltimetype *t, char *prefix)
 Get time from form get the time back from the user and convert it into internal structs.
void icaltime_from_webform_dateonly (struct icaltimetype *t, char *prefix)
 Get time from form get the time back from the user and convert it into internal structs.
void partstat_as_string (char *buf, icalproperty *attendee)
 Render PAPSTAT Render a PARTSTAT parameter as a string (and put it in parentheses).
icalcomponent * ical_encapsulate_subcomponent (icalcomponent *subcomp)
 embedd Utility function to encapsulate a subcomponent into a full VCALENDAR

Variables

char * hourname []

Function Documentation

void display_icaltimetype_as_webform ( struct icaltimetype *  t,
char *  prefix 
)

display and edit date/time The display_icaltimetype_as_webform() and icaltime_from_webform() functions handle the display and editing of date/time properties in web pages. The first one converts an icaltimetype into valid HTML markup -- a series of form fields for editing the date and time. When the user submits the form, the results can be fed back into the second function, which turns it back into an icaltimetype. The "prefix" string required by both functions is prepended to all field names. This allows a form to contain more than one date/time property (for example, a start and end time) by ensuring the field names are unique within the form.

Todo:
NOTE: These functions assume that the icaltimetype being edited is in UTC, and will convert to/from local time for editing. "local" in this case is assumed to be the time zone in which the WebCit server is running. A future improvement might be to allow the user to specify his/her timezone.
Parameters:
t the time we want to parse
prefix ????
Todo:

Definition at line 43 of file calendar_tools.c.

References get_preference(), wc_strftime(), and wprintf().

Referenced by display_edit_individual_event(), and display_edit_individual_task().

void icaltime_from_webform ( struct icaltimetype *  t,
char *  prefix 
)

Get time from form get the time back from the user and convert it into internal structs.

Parameters:
t our time element
prefix whats that
Todo:
????

Definition at line 154 of file calendar_tools.c.

References bstr().

Referenced by save_individual_event(), and save_individual_task().

void icaltime_from_webform_dateonly ( struct icaltimetype *  t,
char *  prefix 
)

Get time from form get the time back from the user and convert it into internal structs.

Parameters:
t our time element
prefix whats that
Todo:
????

Definition at line 179 of file calendar_tools.c.

References bstr().

Referenced by save_individual_event().

void partstat_as_string ( char *  buf,
icalproperty *  attendee 
)

Render PAPSTAT Render a PARTSTAT parameter as a string (and put it in parentheses).

Parameters:
buf the string to put it to
attendee the attendee to textify

Definition at line 198 of file calendar_tools.c.

Referenced by cal_process_object(), and display_edit_individual_event().

icalcomponent* ical_encapsulate_subcomponent ( icalcomponent *  subcomp  ) 

embedd Utility function to encapsulate a subcomponent into a full VCALENDAR

Parameters:
subcomp the component to encapsulate
Returns:
the meta object ???

If we're already looking at a full VCALENDAR component, don't bother ... just return itself.

Encapsulate the VEVENT component into a complete VCALENDAR

Set the Product ID

Set the Version Number

Encapsulate the subcomponent inside

Convert all timestamps to UTC so we don't have to deal with stupid VTIMEZONE crap.

Return the object we just created.

Definition at line 251 of file calendar_tools.c.

References ical_dezonify(), and lprintf().

Referenced by save_individual_event(), and save_individual_task().


Variable Documentation

char* hourname[]

Initial value:

 {
        "12am", "1am", "2am", "3am", "4am", "5am", "6am",
        "7am", "8am", "9am", "10am", "11am", "12pm",
        "1pm", "2pm", "3pm", "4pm", "5pm", "6pm",
        "7pm", "8pm", "9pm", "10pm", "11pm"
}
Hour strings

Definition at line 13 of file calendar_tools.c.

Referenced by display_preferences().


Generated on Wed Jun 20 23:13:12 2007 for webcit by  doxygen 1.5.2