Calendar control

Use this control in Forms Designer to add a calendar to a form. To place a calendar on a form, click Calendar and then click the form.

Note The calendar widget is displayed well only in the web client. When you view the form from the Windows client, this widget is displayed as a blank area.

Property Usage
Name

Specify a unique identifier for the object on the screen. (Optional)

This name is used by external applications, such as RAD, to dynamically change the properties of the object.

Example: calendar.

X

Specify the object’s horizontal position based on the left edge of the object.

Example: 0

Y

Specify the object’s vertical position based on the top edge of the object.

Example: 1

Width

Specify the width of the object in alignment grid units.

Example: 223

Height

Specify the height of the object in alignment grid units.

Example: 44

Visible

Select this option to make the object visible on the form. Clear the check box to hide the object from view on the form.

Example: Select this option.

Visible Condition

Specify an expression to override the Visible property when that expression evaluates to true.

Example: (empty)

Input

Specify the database field or variable to associate with this control. The primary use for this property is to set the focus on the graph.

Example: (empty)

Tab Stop

Specify the tab sort order for this field. By default, the TAB key navigates the focus on a form from top to bottom and left to right. Objects that have a non-zero Tab Stop are visited first, in ascending order. For a button, file, radio button, or check box, you will almost always use the default of 0.

Example: 0

Accessible Description

Specify a component description for use with accessibility software. (Optional)

Note This function is only supported by the web client. If no description is present, the web client defaults to looking for a nearby label to use for the name of the component. For buttons, check boxes, or radio buttons, the web client will use the component’s text. Accessibility software can query the web client to get this information. The client uses that information to present data to the user in a variety of ways. For example, speech simulation software will say the name and the type of component when the component gets focus, based on the settings in the Accessible Name and Accessible Description fields.

Example: (empty)

Date

Specify the start date for data display in the calendar.

Currently only the $start.date value is supported. This variable takes the value of the field specified in Field for Initial Date of each Embedded Calendar Configuration setting of an object (Change, Incident, and so on). See Configure search filters for the full calendar.

For example, if you specify the Planned Start field as the Field for Initial Date for the Change object, in a change record whose Planned Start is May 23, 2013, the calendar displays data only for dates no earlier than May 23, 2013.

Predefined Query

Specify a query for data display in the calendar.

Currently only the $predefined.query.string value is supported. This variable takes the query specified in each Embedded Calendar Configuration setting of an object. See Configure search filters for the full calendar.

Supported Views

Specify the views that you want the calendar to support. The value can be any combinations of day, week, and month, separated with a semicolon (;).

If you leave this property empty, all three views are supported.

Example: day;week

Default View

Specify the initial view when the calendar is opened.

Currently only the $default.view value is supported. This variable takes the Default View value specified in each Embedded Calendar Configuration setting of an object. See Configure search filters for the full calendar.

For example, if you specify Week as the Default View of the embedded calender configuration for the Change object, the calendar is displayed in the weekly view in the Calendar section of each Change record.