| Navigation: Language Reference > 8 - Controls > Control Declarations >====== PROMPT (declare a prompt control) ====== |    |
PROMPT(text) ,AT( ) [,CURSOR( )] [,USE( )] [,LAYOUT( )][,DISABLE] [,FONT( )] [,FULL] [,SCROLL] [,TRN]
| [,HIDE] [,DROPID( )] | [, | LEFT | ] | [,COLOR( )] | |
| RIGHT | | ||||
| CENTER | |
| 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. |
Example:
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)
ENTRY(@S8),AT(100,100,20,20),USE(E1)
PROMPT('Enter More Data:'),AT(10,200,20,20),USE(?P2),CURSOR(CURSOR:Wait)
ENTRY(@S8),AT(100,200,20,20),USE(E2)
ENTRY(@D1),AT(100,200,20,20),USE(E3)
END
CODE
OPEN(MDIChild)
IF SomeCondition
HIDE(?E2) !Prompt will refer to E3
ELSE
HIDE(?E3) !Prompt will refer to E2
END
See Also: