[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index] |
Creates and executes a combo-box dialog with the specified Caption, Prompt, and list of selectable values.
Source position: dialogs.pp line 769
function InputCombo( |
const ACaption: string; |
const APrompt: string; |
const AList: TStrings |
):Integer; |
const ACaption: string; |
const APrompt: string; |
const AList: array of string |
):Integer; |
ACaption |
|
Caption or title for the dialog. |
APrompt |
|
Label displayed for the combo-box control on the dialog. |
AList |
|
List of values which can be displayed and selected using the combo-box. |
Ordinal position for the value selected in AList, or -1 if an option was not selected.
ACaption |
|
Caption or title for the dialog. |
APrompt |
|
Label displayed for the combo-box control on the dialog. |
AList |
|
List of values which can be displayed and selected using the combo-box. |
InputCombo is an Integer function used to create and display an input dialog with the values specified in the arguments to the routine.
The dialog form is constructed at run-time, and includes the controls needed to display the prompt (TLabel) and list of selectable items (TComboBox). It also includes a button panel (TButtonPanel) with Ok and Cancel buttons. The Caption for the dialog form is set to the ACaption argument.
InputCombo calls the ShowModal method for the TForm instance to display the dialog and capture the modal result value. When the modal result is mrOk (the OK button was pressed), the return value contains the ordinal position for the item in AList that was selected in the combo-box control. The return value is -1 when the Cancel button or the Close border decoration is clicked.
Use InputComboEx to display a dialog form that allows custom text to be entered in its combo-box control. Use InputQuery to display a dialog form which allows entry of a text value using an edit mask.
|
Displays an extended input combo-box dialog that allows entry of custom text values in its Items. |
|
|
Use InputQuery to show a dialog box to get input from the user. |