Fnd_Dlg
23 shared methods.
- Fnd_Dlg_Alert
- Fnd_Dlg_Confirm
- Fnd_Dlg_CustomIcon
- Fnd_Dlg_Display
- Fnd_Dlg_FixButtonTexts
- Fnd_Dlg_FormAlert
- Fnd_Dlg_GetRequest
- Fnd_Dlg_Info
- Fnd_Dlg_Localize
- Fnd_Dlg_Message
- Fnd_Dlg_MessageCanceled
- Fnd_Dlg_MessageClose
- Fnd_Dlg_MessageOpen
- Fnd_Dlg_MessageOpen2
- Fnd_Dlg_MessageUpdate
- Fnd_Dlg_PasswordEntry
- Fnd_Dlg_Request
- Fnd_Dlg_SetButtons
- Fnd_Dlg_SetCancelable
- Fnd_Dlg_SetIcon
- Fnd_Dlg_SetProgress
- Fnd_Dlg_SetRequest
- Fnd_Dlg_SetText
Fnd_Dlg_Alert
Fnd_Dlg_Alert (message{; OK button title}) --> Longint
Replaces 4D's ALERT command.
| Parameter | Type | Direction | Description |
|---|---|---|---|
message | Text | in | The message to display |
inOkButtonTitle | Text | in | The OK button text (optional) |
Result | Longint | out | 1 (always) |
Fnd_Dlg_Confirm
Fnd_Dlg_Confirm (message{; OK bttn{; Cancel bttn}}) --> Longint
A replacement for 4D's CONFIRM command.
| Parameter | Type | Direction | Description |
|---|---|---|---|
inMessage | Text | in | The message to display |
inOkBttn | Text | in | The OK button text (optional) |
inCancelBttn | Text | in | The Cancel button text (optional) |
Result | Longint | out | 1 if OK is clicked, 0 if Cancel is clicked |
Fnd_Dlg_CustomIcon
Fnd_Dlg_CustomIcon (picture library name) --> Text
Allows the developer to set and get the custom icon name.
See also Fnd_Dlg_SetIcon.
| Parameter | Type | Direction | Description |
|---|---|---|---|
inPictureLibraryName | Text | in | The picture library name |
Result | Text | out | The current picture name |
Fnd_Dlg_Display
Fnd_Dlg_Display --> Longint
Displays the built dialog.
Sets the OK variable.
| Parameter | Type | Direction | Description |
|---|---|---|---|
Result | Longint | out | 1 if OK is clicked, 0 if Cancel is clicked, 2 if the optional button is clicked |
Fnd_Dlg_FixButtonTexts
Fnd_Dlg_FixButtonTexts
Convert "*" in the button texts to local strings.
Do this just before displaying the dialog, since they get cleared after that.
No parameters.
Fnd_Dlg_FormAlert
Fnd_Dlg_FormAlert
Displays an alert using a 4D form. Called from Fnd_Dlg_Display
No parameters.
Fnd_Dlg_GetRequest
Fnd_Dlg_GetRequest --> Text
Returns the value entered by the user after displaying a Request dialog.
| Parameter | Type | Direction | Description |
|---|---|---|---|
Result | Text | out | The value entered by the user |
Fnd_Dlg_Info
Fnd_Dlg_Info (label) --> Text
Returns requested information. See the Fnd_Gen_ComponentInfo method for more information.
| Parameter | Type | Direction | Description |
|---|---|---|---|
request | Text | in | Info desired ("version" or "name") |
Result | Text | out | Response |
Fnd_Dlg_Localize
Fnd_Dlg_Localize
Passed the localization strings to the General and (if available) Localization components.
No parameters.
Fnd_Dlg_Message
Fnd_Dlg_Message (message text)
Displays a message window. Stays open until it's called again with a blank string.
Designed to be a replacement for 4D's MESSAGE command.
See also: 4D's own Progress component (Progress New, Progress SET PROGRESS, Progress QUIT), which is the better choice for new code; Fnd_Dlg_Message stays for hosts that already call it.
| Parameter | Type | Direction | Description |
|---|---|---|---|
message | Text | in | The message to display |
Fnd_Dlg_MessageCanceled
Fnd_Dlg_MessageCanceled
Returns True if the user clicked the Cancel button.
| Parameter | Type | Direction | Description |
|---|---|---|---|
Result | Boolean | out | True if the user clicked Cancel |
Fnd_Dlg_MessageClose
Fnd_Dlg_MessageClose
Closes the progress indicator window.
No parameters.
Fnd_Dlg_MessageOpen
Fnd_Dlg_MessageOpen
Opens the message window.
No parameters.
Fnd_Dlg_MessageOpen2
Fnd_Dlg_MessageOpen2 (window title)
Called as a new process from Fnd_Dlg_MessageOpen to display the progress indicator window.
| Parameter | Type | Direction | Description |
|---|---|---|---|
windowTitle | Text | in | The window title |
Fnd_Dlg_MessageUpdate
Fnd_Dlg_MessageUpdate (number)
Updates the message dialog's progress indicator.
| Parameter | Type | Direction | Description |
|---|---|---|---|
current | Longint | in | The next number in the sequence. |
Fnd_Dlg_PasswordEntry
Fnd_Dlg_PasswordEntry (->srcArea; ->curValue) --> Boolean
Replaces typed characters with bullet characters for password entry.
Returns True if the value has changed.
Based on the Keystroke function example in the 4D documentation.
| Parameter | Type | Direction | Description |
|---|---|---|---|
formObject | Pointer | in | A pointer to the form object |
currentValue | Pointer | in | A pointer to a text variable that holds the contents |
Result | Boolean | out | True if the current value has changed |
Fnd_Dlg_Request
Fnd_Dlg_Request (msg{; default{; OK button{; Cancel button}}}) --> Text
Displays a Request dialog. Returns the user's response and sets the OK variable.
Use Fnd_Dlg_GetRequest to find out what the user typed.
| Parameter | Type | Direction | Description |
|---|---|---|---|
msg | Text | in | The message to display |
inDefault | Text | in | The default response text (optional) |
inOkButton | Text | in | The OK button text (optional) |
inCancelButton | Text | in | The Cancel button text (optional) |
Result | Text | out | Text user entered in Request dialog |
Fnd_Dlg_SetButtons
Fnd_Dlg_SetButtons ({button 1{; button 2{; button 3}}})
Sets the button texts for the upcoming alerts.
| Parameter | Type | Direction | Description |
|---|---|---|---|
inButton1 | Text | in | The OK button text or "" or "*" for localized "OK" (optional) |
inButton2 | Text | in | The Cancel button text or "*" for localized "Cancel" (optional) |
inButton3 | Text | in | The third button text (optional) |
Fnd_Dlg_SetCancelable
Fnd_Dlg_SetCancelable (cancelable?)
Specify whether or not the upcoming dialog can be canceled.
| Parameter | Type | Direction | Description |
|---|---|---|---|
cancelable | Boolean | in | True if the message button should be enabled. |
Fnd_Dlg_SetIcon
Fnd_Dlg_SetIcon ({icon number})
Sets the icon for the upcoming alert. 0 = Default icon (Note) 1 = Note Icon 2 = Warn Icon 3 = Stop Icon
These Foundation constants are available: Fnd_Dlg_NoteIcon = Note Icon Fnd_Dlg_WarnIcon = Warn Icon Fnd_Dlg_StopIcon = Stop Icon
See also Fnd_Dlg_CustomIcon.
| Parameter | Type | Direction | Description |
|---|---|---|---|
inIconNumber | Longint | in | Icon number (optional) |
Fnd_Dlg_SetProgress
Fnd_Dlg_SetProgress (to or from{; to})
The developer calls this to set the From and To numbers.
If only one number is passed, the From is assumed to be 1.
| Parameter | Type | Direction | Description |
|---|---|---|---|
inFrom | Longint | in | The ending number if no second parameter or the starting number |
inEndingNumber | Longint | in | The ending number (optional) |
Fnd_Dlg_SetRequest
Fnd_Dlg_SetRequest ({default})
Sets up the next dialog to allow the user to enter a value. Optionally sets the default value of the value. Pass "*" as the default value to cause the entry area to display bullets rather than text.
| Parameter | Type | Direction | Description |
|---|---|---|---|
inDefault | Text | in | The default value (optional) |
Fnd_Dlg_SetText
Fnd_Dlg_SetText (text 1{; text 2})
Sets the message texts for the upcoming alert.
| Parameter | Type | Direction | Description |
|---|---|---|---|
text1 | Text | in | The primary alert text |
inText2 | Text | in | The smaller alert text (optional) |