ZxApp IT Users Guide

11.2. Calendar Views

Calendar views are used to display records that are date-dependent in nature, under a given node and obeying a a given criteria, in calendar format.  Figure 11.2.1 shows an almost-empty Calendar view.  A calendar view can display in year, month, week, or day mode.  Selecting the heading for a given month in year mode will zoom down into month mode.  Selecting the heading for a given day in month or week mode will zoom down into day mode.



Figure 11.2.1:  A Sample Calendar view.


Creating a Calendar View

To create a calendar view, begin by selecting File->Organizer Properties.  Next, select the "Views" tab in the Organizer Properties dialog.  You should see something similar to Figure 11.2.2.  Double click in the white space below the last view, else right click anywhere in the list box, and select "Add View".  



Figure 11.2.2:  The Organizer Properties dialog open to the "Views" tab.



The View Properties dialog shown in Figure 11.2.3 will appear.  The first thing you should do is give your view a name.  Notice that the View Type dropdown contains two possible choices; List and Calendar.  Select "Calendar" in this dropdown.  


Toolbar Image

The Toolbar Image is the image that is used if the view is available from the Toolbar (discussed in the section titled "Customizing The Toolbar").  To associate an image, click on the [NONE] text (or the image if one in already selected).  The Select Image From Library dialog will appear.  This dialog allows a user to select from a list of images that have been embedded into the organizer's central image library.  Also in this dialog, users can add and remove images from this library.


Root Node

The organizer has a root node, but this is different than the root node of the view.  The Root Node of the view tells ZxApp IT that only records within the selected Root Node, or a node contained under the selected Root Node, should be considered for possible display in the view.  By default, the root node of the organizer is selected.  With the root node selected, all records within the organizer, of the selected data types, could potentially be displayed. Which records get displayed also depends on the view Constraints.




Figure 11.2.3:  The View Properties dialog for a new (and empty) view.



Data Types to Display

The Data Types to Display list box contains a list of all Types to be displayed within the view.  The Key Property dropdown, Properties panel, and Constraints panel are all tied to the currently selected Data Type.  A Type can only be listed once in the Data Types to Display list.  The first Type in this list determines the number of columns to be displayed in the view.  All subsequently listed types are constrained by this, either by padding the extra columns with blanks, or ignoring additional property selections.  



Key Property

For a Calendar view, the Key Property must be a property of Date or Date and Time type.  The key property is used to determine which date to display the record on.



Properties Panel

The properties panel lists out the properties for the selected Data Type.  To include a property in the view, select the checkbox for that property.  The order of the columns in the List view is determined by the order in which the checkboxes are selected.  When a checkbox is checked, a number will appear to the left of  it.  This number indicates the index of the column that will contain the selected property.  This number does not account for the Key Property.  The Key Property is alway displayed in the first column.  Other selected properties will be pushed to the next column to the right.  Unselecting a property will cause the column index of other selected properties to adjust.  Re-selecting it will assign it to the last column of the view.


In Year display mode and Month display mode, only two properties will display.  This means that the key property and one other property can be displayed in year mode or month mode.  In addition, Date, Time, and Date and Time properties will be displayed using the Brief Pattern format.


In Week display mode and Day display mode, all selected properties will display.  Date, Time, and Date and Time properties will be displayed using the Pattern format.


Constraints Panel

Constraints are used, optionally, to filter the records to be displayed on the view.  To add a constraint, click the  button. A row will appear in the Constraints panel.  The first field contains a dropdown where one of the properties can be selected.  The next field contains the relationship of the constraint, for instance Equal To, or Starts With.  The last field contains the text expression to use in the comparison.


Copyright 2009 ZipXap Technology, LLC. All Rights Reserved.