CUETEXT Property

PLBCMP GUI Only, 9.6

The CUETEXT property defines the cue banner text associated with an EDITTEXT or a COMBOBOX. The property uses the following format:

CUETEXT={value}

Note the following:

1. CUETEXT may be used in CREATE, SETPROP, or GETPROP statements of a EDITTEXT or COMBOBOX object.

2. The {value} may be a Character String Variable or Literal.

3. If {value} is a Null String, the text is removed from the object.

4. The cue banner is displayed when the EDITTEXT is empty.

5. The CUETEXT property is only displayed by Windows for a single line EDITTEXT control. Therefore, when an EDITTEXT is created and the CUETEXT property {value} is specified as a non-NULL string, the EDITTEXT is always created as a single line EDITTEXT. Also, the Windows OS EDITTEXT control must be created with a CUETEXT {value} specified to allow the CUETEXT property to be changed using SETPROP. Otherwise, the SETPROP of the EDITTEXT CUETEXT property does not work.

6. This property requres the use of ComCtrl32 version 6 or later.

7. A GETMODE and SETMODE keyword named *EDITTEXTMODES can force runtime versions 9.9 and later to allow the cue text to become invisible when an EDITTEXT gains focus. This keyword only takes affect for any EDITTEXT objects that are created after the keyword setting is set.

8. If an EDITTEXT is created as a multi-line edittext object, a SETPROP of the CUETEXT property has no affect on the Windows edittext control.

See Also: Object Properties, Object IO Instructions, Object Definitions