A List view is used to display all records, under a given node and
obeying a given criteria, in tabular format. An example List view is
shown in Figure 11.1.1 below. The records can be sorted by a specific
property by clicking on the header for that property.
Figure 11.1.1: A Sample List view.
To create a list 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.1.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.1.2: The Organizer Properties dialog open to the "Views"
tab.
The View Properties dialog shown in Figure 11.1.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.
Leave "List" selected in this dropdown.
Figure 11.1.3: The View Properties dialog for a new (and empty) view.
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 with a view, 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.
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. This is not to
be confused with the Root Node of the
Organizer itself, which is simply the top-level node in the Organizer.
By default, the Root Node of the Organizer is used as the Root Node of
the view. 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.
When this checkbox is selected, the view will appear in the navigation
tree under the selected Root Node as shown in Figure 11.1.4.
Figure 11.1.4: The navigation tree with the Personal
Contacts view selected.
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.
For a List view, the Key Property serves only to determine which
property is listed in the first column of the output table.
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
always 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.
The Pattern field is used for Date, Time, and Date and Time properties
to determine how it should be displayed in the List. The Brief Pattern
field is only used in Calendar views (discussed in the next section)
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.