In BBj 25.03 and higher, this method sets assorted options on this BBjPrompt, corsresponding to the MODE= option of the PROMPT() function.
Syntax
Return Value |
Method |
BBjPrompt |
modes(String modes)
|
Parameters
Variable |
Description |
modes |
One or more comma-separated options that modify the behavior of this BBjPrompt.
X=int,Y=int |
Displays the dialog at a specific screen location. Either or both may be specified. By default, the dialog is centered. |
W=int,H=int |
Specifies the maximum width and height of the dialog window. Either or both may be specified. The dialog size is also limited by the size of the screen or browser.
|
SPLIT=int |
The optional SPLIT value specifies the maximum number of characters to show on a line before inserting a line break. This value overrides the STBL("!PROMPT_SPLIT") setting. The default is 100 characters. |
attr=value |
The mode string can specify selected DWC component attributes (e.g. theme=primary,blurred=true). DWC button attributes can be applied to the OK and Cancel buttons using the format "button-0-theme=success, button-1-theme=danger".
|
button-#-label=value |
The [OK] and [Cancel] button labels can be customized in all three clients (GUI, BUI, DWC). For example, "button-0-label=Login,button-1-label=Exit" sets the [OK] button label to "Login" and the [Cancel] button label to "Exit". |
input-type=type
|
The input-type attribute can specify an alternative input type. If a specified type is unsupported in the current client, the default "text" is used.
|
|
Input-Type |
Description |
GUI |
BUI |
DWC |
color
|
Color Choser
|
✓ |
✓ |
✓ |
date
|
Date Input |
✗ |
✓ |
✓ |
datetime-local
|
Date/Time Input |
✗ |
✓ |
✓ |
email
|
Email Address Input |
✗ |
✓ |
✓ |
file
|
Client File Chooser |
✓ |
✓ |
✓ |
month
|
Month Input |
✗ |
✓ |
✓ |
number
|
Number Input |
✓ |
✓ |
✓ |
password
|
Password Input |
✓ |
✓ |
✓ |
range
|
Range Input |
✗ |
✓ |
✓ |
search
|
Text Input for Search |
✗ |
✓ |
✓ |
tel
|
Telephone Number Input |
✗ |
✓ |
✓ |
text
|
Text Input (Default) |
✓ |
✓ |
✓ |
time
|
Time Input |
✗ |
✓ |
✓ |
url
|
URL Input |
✗ |
✓ |
✓ |
week
|
Week Input |
✗ |
✓ |
✓ |
|
property=value
|
The mode string can specify arbitrary DWC properties (e.g. "theme=info"). Themes can also be applied to individual buttons (e.g. "button-0-theme=success, button-1-theme=danger"). |
ICON=imagefile
ICON=url |
The optional ICON value specifies a custom icon image, either an image file or a URL that will be reachable from the client (e.g. a DATA URL). |
ICONWIDTH=int |
The optional ICONWIDTH value specifies an integer width to scale the specified ICON. |
ICONHEIGHT=int |
The optional ICONHEIGHT value specifies an integer height to scale the specified ICON. |
SCALE=num |
The optional SCALE value specifies the scaling factor to be applied to the dialog button and text fonts. |
|
Return Value
Returns this BBjPrompt object, enabling methods to be chained.
password$ = bbjapi().prompt("Enter your password").modes("input-type=password").show()
|
See Also
BBjAPI
PROMPT() Function - Prompt For String Value
See the BBj Object Diagram for an illustration of the relationship between BBj Objects.