ZxApp IT Users Guide

11.1. List Views

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.



Creating a 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.



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 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.


Root Node

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.


Show View on Navigation Tree

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.


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 List view, the Key Property serves only to determine which property is listed in the first column of the output table.  



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 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 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.