Configuring presentation options for a date range calendar control
Configure the control to be editable or read-only for the application users, apply conditions and specify how the cell appears on the form.
Click the control, and then click the View properties icon.
In the Properties panel, click the Presentation tab.
From the Edit options list, select a setting for the Date time control.
These selections take precedence over section and harness settings.
- To make the property use the edit mode of the section or harness in which it appears, select Auto.
- To make property values read-only for end users, select Read-only (always).
- To make property values read-only for end users in specified cases, select Read-only (expression). In the adjacent field press the Down Arrow key to select the expression used to evaluate the conditions on which property values are read-only.
- To make property values read-only for end users in specified cases, select Read-only (when rule). In the adjacent field press the Down Arrow key to select the when rule that determines the conditions on which property values are read-only.
- To make property values always editable for end users, select Editable.
For Auto (default) or Editable options, in the Specify Size section/field, define the control width in a form:
- To automatically adjust the control area width to the layout, click Auto.
- To manually specify a fixed width for the control, click Custom. In the Width fields enter the size in pixels or as a percentage.
To specify the range of dates that the users can select, in the Min date and Max date fields, enter the thresholds.
To allow users to enter numerical values when the field is in focus, select the Display value using read-only formatting check box.
The required format is applied automatically.
In the Label format field, press the Down Arrow key, and then select a format of the label that you want to apply at run time.
To apply custom styling to the cell, expand the Advanced Presentation Options section.
Instead of creating a new custom format in the skin, you can adjust elements in a cell by applying Cascading Style Sheet (CSS) helper classes. For example, you can use a CSS helper class to center an element in a cell or to double the standard right margin for the element.
- Cell read-write classes – Click the Open helper class picker icon to specify one or more CSS helper classes to apply to this cell when the form is displayed in read-write mode. You can enter several helper classes, separated by a space. Alternatively, you can enter the name of a custom style to apply to this cell.
- Cell read-only classes – Click the Open helper class picker icon to specify one or more CSS helper classes to apply to this cell when the form is displayed in read-only mode. You can enter several helper classes, separated by a space. Alternatively, you can enter the name of a custom style to apply to this cell.
- Inline style (not for production use) – You can use this field to define an inline style by entering CSS code. However, entering an inline style results in a guardrail warning. For maintainability and reuse, the recommended approach is to use read-write or read-only classes.
- Date time (calendar) control
To present a date, time, or both on a form, use the Date time control. You can modify the control features to improve user experience by making date and time selection simple and intuitive. For example, you can choose to display the calendar widget with spinners to make it easier to switch between months and years.
- Configuring the basic settings for a Date time control - a date or time
Select a property for a Date time control to determine the dates and times that the application users can select. Set related options to specify the label, default value, helper text, and field visibility for the control.
- Specifying presentation options for a Date time control
You can specify how read-only dates or date and time combinations are displayed in your application. For example, you might specify that the year comes first, or that months are spelled out rather than represented numerically.
- Selecting the date and time format and display mode
You can specify which date and time element selectors are displayed on the form at run time. For example, you can display a calendar widget with a corresponding text input field or display drop-down fields for selecting the month, day, and year.
- Selecting spinners or drop-down fields for navigation
You can specify whether your application users select dates and times with spinner controls or drop-down fields.
- Restricting the years displayed
To make it easier for users to select valid dates, you can restrict the number of years that are displayed relative to, and including, the current date. At run time, only values that fall within the range of dates that you specify are visible on the calendar widget or available by using spinners or drop-down fields.
- Displaying week numbers in calendar widgets
If users are accustomed to seeing week numbers in calendars, you can specify that the week numbers are displayed along the left side of the calendar widget in your application. The week numbers are shown according to the ISO 8601 standard date notation. Week numbers may vary, depending on locale.
- Disabling the selection of weekend days
To make it easier for users to select valid dates, you can disable weekend dates so that users cannot select them in your application. Weekend (non-working) dates can be based on the user's calendar or on another business calendar.
- Setting intervals of minutes
By default, the time picker displays minutes from 0 through 59. To restrict the time selections available to users, you can configure your application to display intervals of minutes on time controls, instead.
- Specify actions for a control
You can specify action sets—event-action pairings—to determine the behavior of a control. For example, you might specify that clicking a button triggers the refresh of a section. You can define multiple events and actions in an action set, and you can create multiple action sets for a single control.
- Copying, moving, or deleting a control
You can use basic Windows operations to speed the development of your controls.