====== Calendar ======
Calendar forms are used to display events in standard graphical calendar formats. 

Any [[Record|record]] that has a [[Field Type - Date|Date]] or [[Field Type - Date Time|Date Time]] [[Field|Field]] on it can be displayed on a Calendar Form in WorkXpress.  In a Real Estate application there may be meetings scheduled for a User to view a Property, for instance.  In that example a calendar for that User can be displayed, showing all of their appointments and a calendar for the Property can also be displayed, showing all of the appointments for that Property.

Any field on that record can be used to make up what the "Appointment" looks like on the Calendar.

Here are some examples of the available views and configurations for a Calendar form.  If multiple views are made available there are controls for toggling between those views.  Click on them to enlarge.

|< 80% 300px >|
^                                               ^                      ^                   ^ ^
| {{ ::calendar_screenshot_-_one_month_by_day.png?direct&250 |One Month by Day}}<imgcaption image1|One Month by Day>One Month by Day</imgcaption>|{{ ::calendar_screenshot_-_one_week_by_day.png?direct&250 |One Week by Day}}<imgcaption image2|One Week by Day>One Week by Day</imgcaption>|{{ ::calendar_screenshot_-_one_day_by_hour.png?direct&250 |One Day by Hour}}<imgcaption image3|One Day by Hour>One Day by Hour</imgcaption>|{{ ::calendar_screenshot_-_one_week_by_hour.png?direct&250 |One Week by Hour}}<imgcaption image4|One Week by Hour>One Week by Hour</imgcaption>| 
|{{ ::calendar_screenshot_-_multiple_schedules_-_one_day_by_hour.png?direct&250 |Multiple Schedules - One Day by Hour}}<imgcaption image5|Multiple Schedules - One Day by Hour>Multiple Schedules - One Day by Hour</imgcaption>|{{ ::calendar_screenshot_-_multiple_schedules_-_two_days_by_hour.png?direct&250 |Multiple Schedules - Two Days by Hour}}<imgcaption image6|Multiple Schedules - Two Days by Hour>Multiple Schedules - Two Days by Hour</imgcaption>|{{ ::calendar_screenshot_-_multiple_schedules_-_one_week_by_hour.png?direct&250 |Multiple Schedules - One Week by Hour}}<imgcaption image7|Multiple Schedules - One Week by Hour>Multiple Schedules - One Week by Hour</imgcaption>| | 
|{{ ::calendar_screenshot_-_multiple_months_by_month.png?direct&250 |Multiple Months by Month}}<imgcaption image8|Multiple Months by Month>Multiple Months by Month</imgcaption>|{{ ::calendar_screenshot_-_multiple_weeks_by_week.png?direct&250 |Multiple Weeks by Week}}<imgcaption image9|Multiple Weeks by Week>Multiple Weeks by Week</imgcaption>| | | 
===== How to Create =====
Calendars are created in one of two ways: either clicking the “Forms” button in the left hand palette and then dragging the Classic Forms button over the page's background, or, when the [[Presentation Layer|presentation layer]] is displayed, clicking on one of the blue plus icons ({{:interface-layer:form-plus.png?nolink|}}).
===== Features =====
Calendar features can be edited by clicking on the blue tab icon  when the [[Presentation Layer|presentation layer]] is displayed.
==== Header Bar ====
  * [[Form Setting - Title|Title]]
  * [[Form Setting - Display Alternate Header Text|Display Alternate Header Text]]
  * [[Form Setting - Form Icon|Form Icon]]
  * [[Form Setting - Hide Title Bar|Hide Title Bar]]
  * [[Form Setting - Hide Title Bar Background|Hide Title Bar Background]]
  * [[Form Setting - Hide Form Background|Hide Form Background]]

==== Calendar Style ====
  * [[Form Setting - Set Starting Calendar View|Set Starting Calendar View]]
  * [[Form Setting - Available Calendar Views|Available Calendar Views]]
  * [[Form Setting - Starting Day of the Week|Starting Day of the Week]]
  * [[Form Setting - Ending Day of the Week|Ending Day of the Week]]
  * [[Form Setting - Time Slot Granularity|Time Slot Granularity]]
  * [[Form Setting - Default Starting Date|Default Starting Date]]
  * [[Form Setting - When in Edit Mode Events can be|When the Form is in Edit Mode, Events can be]]
  * [[Form Setting - Reload content when an event is moved|Reload content when an event is moved]]
  * [[Form Setting - Black Out Dates|Black Out Dates]]
  * [[Form Setting - When a User interacts with a Timeslot|When a User interacts with a Timeslot]]
    * [[Form Setting - Event Add Page|Event Add Page]] *only available when "Add Event" is selected for the "When a User interacts with a Timeslot" setting*
    * [[Form Setting - Page UI Treatment|Page UI Treatment]] *only available when "Add Event" is selected for the "When a User interacts with a Timeslot" setting*
    * [[Form Setting - Window Name|Window Name]] *only available when "Add Event" is selected for the "When a User interacts with a Timeslot" setting*
    * [[Form Setting - Choose size|Choose size]] *only available when "Add Event" is selected for the "When a User interacts with a Timeslot" setting*
      * [[Form Setting - Width|Width]] *only available when "Other (Enter your own)" is selected for the "Choose size" setting*
      * [[Form Setting - Height|Height]] *only available when "Other (Enter your own)" is selected for the "Choose size" setting*
==== Date Selection Format ====
  * [[Application Setting - Date Format for all Calendar Forms|Date Format for all Calendar Forms]]
  * [[Form Setting - Specify a Date Format|Specify a Date Format]]
  * [[Form Setting - Date Length|Length]]

==== Expand/Contract ====
  * [[Form Setting - Allow the Form to Be Collapsed|Allow the Form to Be Collapsed]]
  * [[Form Setting - Start Collapsed|Start Collapsed]]
  * [[Form Setting - Remember Collapsed Setting by User|Remember Collapsed Setting by User]]

==== Sizing Settings ====
  * [[Form Setting - Max Height|Max Height]]
  * [[Form Setting - Form Width|Form Width]]
==== Tooltip ====
  * [[Form Setting - Tooltip|Tooltip]]
==== Autorefresh ====
  * [[Form Setting - Refresh Form Every X Seconds|Refresh Form Every X Seconds]]
==== Block Association ====
  * [[Form Setting - Temporary Block Association|Temporary Block Association]]
  * [[Form Setting - Traversal Type|Traversal Type]]
==== Setup Calendar Listings ====
  * [[Form Setting - Setup Calendar Listings|Setup Calendar Listings]]