Show all
A cell in a layout can present the value of a property as a date, time,or both in display-only or editable format. Follow these instructions to present a property value in a Calendar control. GRP20961 & 23143 v6.2 pashm
For a harness rule, the property generally must be on the primary page
of the rule — the page corresponding to the Applies
To key part of the rule. However, a section within the harness
rule may have a different Applies To class, and that
section can include properties from its own class. SR-37
As of V6.2, the Calendar control uses the auto-generated control rule pxDateTime. Its look and behavior are governed by the Control rule form Control tab. The Parameters tab is not available and the HTML cannot be edited. To modify the control's look or behavior, use the control's Parameters dialog within the context of the section, not the rule itself.
It is recommended that you use pxDateTime in new development rather than the non-auto-generated date and time control rules (which are supported). See About the Calendar control
1. Drag and Drop the Calendar control
Click the down-arrow () at the right end of the Basic
control group () and select the Calendar
control ().
Drag the control to the cell or header that is to contain the property
value. When the pointer changes shape to indicate that a single cell
is selected, release the mouse button to drop the control.
If the cell is not empty, the dropped control replaces the current
contents of the cell.
2. Complete the
Cell Properties panel — Top fields
Click the magnifying glass icon () to open the Cell Properties panel.
Complete the top fields that appear.
If the panel is pinned (), the wireframe presentation on the rule form
changes immediately to reflect of your inputs. If the panel is not
pinned (), click Apply to apply your inputs.
Field
|
Description
|
|
Appears only when this field is in a section included
within the current open rule. Click to open the section that
immediately contains the field.
|
Property
|
Select or type a property reference that identifies a
single text value and has a Property Type of
DateTime , Date , or TimeOfDay .
Alternatively, you can drag a property name from the lists
of properties visible in the Application Explorer. Typically,
this works for Single Value properties belonging
to in the Applies to class of the current
rule (or a higher class). If the container in which this
field sits has a non-blank Using Page value,
you can drag a Single Value property from within
that embedded page property. B-16325 Rejected
Click the pencil icon () to review the property rule
(if the reference is to an existing property in the
Applies To class of this rule or a parent of
that class). If the property is not found, the New dialog box
for the property form appears.
You can reference properties on any page identified on the
Pages & Classes tab, using
the normal notation pagename.propertyname for pages
other than the page corresponding to the Applies
To class of the rule.
If this field is in a cell of a section that includes
parameter declarations on the Parameters tab, you can enter the notation
param.NAME here, to use a parameter value for the
field, where NAME identifies a string parameter. Make sure
that the NAME parameter is declared on the Parameters tab, and that your application
provides a non-blank value for the parameter value in all
possible situations where the section appears. See Section rules —
Completing the Parameter tab. Proj-1424
|
Control
|
Accept the default pxDateTime control rule. When placed in a SmartLayout field, the adjoining Label cell is populated by the standard .pyTemplateCalendar property with a label value of Date Time . When placed in a repeating grid, the value appears above the control in the header cell.
Click the pencil icon () to review the control
rule identified in this field.
Customizing the control
The control's default parameters are the ones you'll most likely use in your UI design. If you wish, you can customize the control within the context of the section that contains it. For example, you can:
- Display the control so that the user can pick dates and times from a calendar or from drop-down lists.
- Enable the user to manually enter date and time values
- Select the date and time format
Your edits apply only to the control within the section that contains it and do not update the underlying rule. You an add multiple controls of the same type within a section, each with its own custom settings. See Control Form — Completing the Control tab for descriptions of the available parameters and how to define behaviors.
Do the following to customize an auto-generated control rule in a section:
- Open the section or harness that contains the rule.
- Select the cell containing the rule and open its Cell Properties panel.
- In the panel, select the magnifying glass icon () next to the Control field. This displays the control Parameters dialog, which contains most of the settings in the underlying rule's Control tab. You cannot edit the Control Modes and UI Element settings.
- Modify as necessary. To immediately render your changes, click OK in the dialog. If satisfactory, save the section. The system generates the XML representing your edits and stores it in the section.
|
Behavior
|
Optional. Leave blank if no dynamic form actions to other
parts of the form are to occur based on user updates or
values for this field. C-1990
To establish a dynamic form action, click the magnifying
glass icon ()
to open the Client Event Editor in a new dialog window.
Complete the Client Event Editor to select an event
(OnBlur , OnChange , or
OnClick ) and the resulting form action.
C-2526
Click the help icon ( ) on the
Client Event Editor for assistance. For general information
on this capability, see Implementing dynamic form actions and
the Client Event Editor.
Client event support is not available for harness,
section, or flow action rules that use directives.
|
3. Complete the
Cell properties panel — General tab
4. Complete the
Cell properties panel — Advanced tab
Copying,
deleting, duplicating, or moving a Calendar field
Use these Windows operations to speed development:
- To move a cell containing a Calendar control, hold down the
SHIFT
key, select the cell, drag and drop it in
another cell, in the same one layout or another layout.
PROJ-198 RULE-298 - To cut, copy, or paste a control in a cell,
right-click in the cell to access a context-menu. PROJ-198
TASK-141
About Flow Action rules
About Harness rules
About Section rules