User Tools

Site Tools

Navigation:  Language Reference > 8 - Controls > Control Declarations >====== PROMPT (declare a prompt control) ====== Previous pageReturn to chapter overviewNext page


PROMPT(text) ,AT( ) [,CURSOR( )] [,USE( )] [,LAYOUT( )][,DISABLE] [,FONT( )] [,FULL] [,SCROLL] [,TRN]

[,HIDE] [,DROPID( )] [, LEFT | ] [,COLOR( )]


PROMPT Places a prompt for the next active control following it, in the WINDOW or TOOLBAR.
text A string constant containing the text to display (PROP:Text). This may contain an ampersand (&) to indicate the “hot” letter for the prompt.
AT Specifies the initial size and location of the control (PROP:AT). If omitted, default values are selected by the runtime library.
CURSOR Specifies a mouse cursor to display when the mouse is positioned over the control (PROP:CURSOR). If omitted, the WINDOW's CURSOR attribute is used, else the Windows default cursor is used.
USE A field equate label to reference the control in executable code (PROP:USE).
LAYOUT Specifies the control's left-to-right or right-to-left display orientation (PROP:LAYOUT)
DISABLE Specifies the control appears dimmed when the WINDOW or APPLICATION is first opened (PROP:DISABLE).
FONT Specifies the font used to display the text (PROP:FONT).
FULL Specifies the control expands to occupy the entire size of the WINDOW for any missing AT attribute width or height parameter (PROP:FULL).
SCROLL Specifies the control scrolls with the window (PROP:SCROLL).
TRN Specifies the control transparently displays over the background (PROP:TRN).
HIDE Specifies the control does not appear when the WINDOW or APPLICATION is first opened (PROP:HIDE). UNHIDE must be used to display it.
DROPID Specifies the control may serve as a drop target for drag-and-drop actions (PROP:DROPID).
LEFT Specifies that the prompt is left justified (PROP:LEFT).
RIGHT Specifies that the prompt is right justified (PROP:RIGHT).
CENTER Specifies that the prompt is centered (PROP:CENTER).
COLOR Specifies a background color for the control (PROP:COLOR).

The PROMPT control places a prompt for the next active control following the PROMPT in the WINDOW or TOOLBAR structure (not valid in a REPORT). The prompt text is placed at the position and size specified by its AT attribute.

The text may contain an ampersand (&) to indicate the letter immediately following the ampersand is the “hot” letter for the prompt. By default, the “hot” letter displays with an underscore below it to indicate its special purpose. This “hot” letter, when pressed in conjunction with the ALT key, changes input focus to the next control following the PROMPT in the WINDOW or TOOLBAR structure, which is capable of receiving focus.

Disabling or hiding the control directly following the PROMPT in the window structure does not autmatically disable or hide the PROMPT; it must also be explicitly disabled or hidden, otherwise the PROMPT will then refer to the next currently active control following the disabled control. This allows you to place one PROMPT control on the window that will apply to any of multiple controls (if only one will be active at a time). If the next active control is a BUTTON, it is pressed when the user presses the PROMPT's “hot key.”

To include an ampersand as part of the prompt text, place two ampersands together (&&) in the text string and only one will display.

This control cannot receive input focus.

Events Generated:

EVENT:Drop A successful drag-and-drop to the control.


MDIChild WINDOW('Child One'),AT(0,0,320,200),MDI,MAX,HVSCROLL

        PROMPT('Enter Data:'),AT(10,100,20,20),USE(?P1),CURSOR(CURSOR:Wait)


        PROMPT('Enter More Data:'),AT(10,200,20,20),USE(?P2),CURSOR(CURSOR:Wait)






 IF SomeCondition

  HIDE(?E2)     !Prompt will refer to E3


  HIDE(?E3)     !Prompt will refer to E2


See Also:



prompt_declare_a_prompt_control_.htm.txt · Last modified: 2021/04/15 15:57 (external edit)