Creating Calendar View definition files

Calendar View definition files define the layout, format, and behavior of data in a Calendar. The Calendar View definition file is also referenced by the Show DataTable command used in a procedure file.

Calendar View definitions are stored as ASCII files and can be created and edited in any text editor. The recommended file extension for Calendar View definitions is .lvcvw.

Note: The data displayed in a Calendar is determined by the DataTable object specified in the Show DataTable command. For more information, see Defining DataTable objects and Show DataTable.

Action (for Calendar Views)

Use this function to add a toolbar icon or a context menu with an associated action in a Calendar. For example, you can use actions to run a procedure, open a Table or Data Grid, or run a model.

You can reference any of the above context variables in Longview Application Framework documents.

Action "Text", "Image", "Command", "Helptext"[, Location]        

where:

• Text is the text to display in the toolbar. To display an image-only icon, omit this parameter and use two double quotation marks ( "" ). You must specify either Text or Image.
• Image is the path to the image to display as the toolbar or context menu icon. The default path is the path specified in the <rootpath> tag of the .lvapp file. If no root path is specified, the system assumes the root path is the applications folder in the working directory. To display a text-only icon, omit this parameter and use two double quotation marks ( "" ). You must specify either Text or Image.

  Note: Longview recommends using 16 x 16 pixel images to optimize the appearance of your Calendar toolbar.

• Command is the Application Framework command to execute when a user clicks the toolbar icon or context menu item. To display a disabled icon, omit this parameter and use two double quotation marks ( "" ). For example, you can create a button that executes the Launch App command.
• Helptext is the tooltip text that appears when a user hovers over the toolbar icon. To omit tooltip text, use two double quotation marks ( "" ).
• Location is optional and defines the location of the action in the user interface. To add multiple locations, separate the parameters with a pipe ( | ). If you do not specify a location, the action item is added to the toolbar. Location can be one of the following:

  Parameter	Description
  TOOLBAR	Adds the action to the Calendar toolbar

  Note: If you require double quotation marks (") in the parameters for the Action, precede them with a backslash.

Action "Clear", "Common/images/toolbar/Eraser.png", "Run Procedure ClearTable.lvpro", "Clear Table", TOOLBAR
Action "Expenses", "Resources/app images/new.png", "Launch App Expenses" "Expenses", TOOLBAR

DateColumn

Use this function to specify the column that contains the values to use as dates in the Calendar.

DateColumn ColumnName                

where:

• ColumnName is the name of the App table column that contains the values to use as dates.

DateColumn DueDates                

DescriptionColumn

Use this function to specify the column that contains the values to use as descriptions in the Calendar.

DescriptionColumn ColumnName            

where:

• ColumnName is the name of the App table column that contains the values to use for descriptions.

DescriptionColumn Events                

SystemAction (for Calendar Views)

Use this Calendar View function to add a button with a predefined system action to the toolbar. For example, you can use system actions to include toolbar buttons that allow users to refresh and close the Calendar.

SystemAction Action, "Text", "Image", "Helptext"            

where:

• Action is the system action to add to the toolbar and can be one of the following values:
  • Close, which adds a button that users can click to close the current Calendar.
• Text is the text to display on the button. If you want to omit this parameter and display the image only, use two double quotation marks ( "" ). The following table lists the default text.

  Keyword	Default text
  Close	Close

• Image is the image to display on the button. This option does not apply to the Close action. To omit this parameter, use two double quotation marks ( "" ).
• Helptext is the tooltip text that appears when a user hovers over the button. There is no default for this parameter.

SystemAction Close, "", "", ""