EDITDATETIME


9.0, PLBCMP GUI Only

square.png Properties

square.png Events

square.png Methods

square.png Instructions

 

The EDITDATETIME object provides an interface to exchange date and time information with a user. To define an EDITDATETIME, use one of the following statement formats:

 

(1)

[label]

EDITDATETIME

[%]

(2)

[label]

EDITDATETIME

(arraysize)

(3)

[label]

EDITDATETIME

^

(4)

[label]

EDITDATETIME

^,{target}

(5)

[label]

EDITDATETIME

^(arraysize)

(6)

[label]

EDITDATETIME

^(arraysize),({target}),...,({target})

 

Where:

label

Optional. A Data Label.

%

Optional. Denotes the item as being GLOBAL.

arraysize

Required. An integer decimal constant, CONST variable, or EQUATEd value indicating the number of array items.

^

Optional. Denotes the item as being a POINTER.

target

Required. The name of a previously defined data item of the same type.

Flags Affected: NONE

Note the following:

  1. Data is exchanged through the SETITEM and GETITEM instructions or with the TEXT property using the SETPROP and GETPROP instructions.

  2. Data is exchanged in the same format as the CLOCK TIMESTAMP value (YYYYMMDDHHMMSS).

  3. An EDITDATETIME object always displays data. The object cannot be cleared to display nothing.

  4. When an EDITDATETIME object is loaded by a FORMLOAD instruction, the object is always initialized with the current date and time.

  5. Multi-dimension arrays are supported up to a maximum of fourteen dimensions.

  6. The ^ denotes a Pointer Variable.

  7. Although an EDITDATETIME may be defined as Global, it is DESTROYed during a CHAIN instruction.

  8. When using the SETPROP with a TEXT property that is NULL, the current workstation date timestamp sets the object. In addition, if the EDITDATETIME object has the SHOWCHECKBOX property set to ON, the checked state for the EDITDATETIME check is set.

  9. When using the PWS EDITDATETIME, the HTML object is created using the jQuery DatePicker object. A 'day' must be selected in the 'Calendar' popup to cause the selected date to be rendered and presented in the HTML object presentation. If the 'day' is not selected, the HTML object maintains the current date setting and no date information appears in the HTML object presentation.

 

 

See Also: Example Code, Object Definitions, Object Output Instructions



PL/B Language Reference DIALOG EDITNUMBER