Previous Topic

Next Topic

Book Contents

Defining date/time control properties

To define the properties of a date/time control, select the date/time control icon in the Form definition window and edit the date/time control’s properties in the Properties window:

Property

Description

RefName

RefName of the component.

REQUIRED.

For rules about the use of RefNames, see RefNames

UUID

String that uniquely identifies the component across all databases, trials, and machines.

Note that the InForm Architect application automatically capitalizes UUID strings that contain lower-case characters.

REQUIRED. for certain types of date/time controls, otherwise not necessary. For information about required UUIDs, see UUIDs.

Caption

Specifies the text of the caption that appears on the screen with the component.

OPTIONAL.

Caption Alignment

Specifies the position of the caption relative to the controls that make up the component. You can specify Left (the default), Right, Top, or Bottom.

OPTIONAL.

Start Year,
End Year

First and last year to include in the pulldown list for year.

REQUIRED..

Display Month,
Display Day,
Display Year,
Display Hour,
Display Minute,
Display Second

These properties determine which date and time pulldown lists are rendered when the control is created online. The default value for the date properties Display Month, Display Day, and Display Year is True. The default value for the time properties Display Hour, Display Minute, and Display Second is False.

OPTIONAL.

Require Month,
Require Day,
Require Year,
Require Hour,
Require Minute,
Require Second

These properties determine which pulldown lists require entry for the item to be complete. The default value for all Require properties is False.

OPTIONAL.

Allow Unknown Month, Allow Unknown Day,
Allow Unknown Year, Allow Unknown Hour, Allow Unknown Minute, Allow Unknown Second

These properties determine whether each pulldown list includes a value of “UNK”, allowing a user to specify that a date or time value is unknown. The default value for all Unknown properties is False.

OPTIONAL.

Consistency Check

Specifies whether the InForm application checks for internal consistency among the entered components of the date and time. True is the default. When the value of Consistency Check is True:

  • If any date or time component value is entered, all higher-order components displayed in the control must also have an entered, numeric value. For example, if a user enters a day value in a month/day/year date time control, the user must also enter the month and year. If the datetime control includes both date and time components and a user enters a time value, the user must also enter the date portion.
  • The InForm application treats a blank control and a control with the value of UNK identically. For example, if a user enters a numeric month and enters UNK for the year, the entry generates an error.
  • The consistency check applies to optional as well as required date time components; For example, if the time portion of a control is optional, the InForm application generates an error if a user enters the minutes without the hour.
  • If the Year component of the datetime control is not displayed, the consistency check is disabled.

    OPTIONAL.

Design Note

Free-form text, with a maximum of 255 characters, containing any information you want to capture about the design of the component. This information is for documentation only.

OPTIONAL.

Selection Value

Visible only when the control is added as a child control in a radio group or checkbox group. Specifies the value of the child control stored when a user selects the control.

OPTIONAL.

If you do not specify a selection value, when a user selects the control in the radio group or checkbox group, the value stored in the database is a string consisting of the characters !pf! and the DBUID path of the selected control.

Enter Time as Text

Specifies whether the time portion of the control is represented as a set of text boxes instead of the default set of pulldown lists.

OPTIONAL. The default is False (display as pulldown lists).

Send Feedback