ShowSelectionList

Top  Previous  Next

Prototype

 

StrElement:=ShowSelectionList(strTitle, strSubTitle, intX,intY, intWidth, intHeight, strFileOrElements, boolMultipleSelection)

 

Description

 

It shows a dialog window with a range of elements to be chosen.

 

Parameters

 

strTitle: string containing title for the dialog window.

 

strSubTitle: string containing the sub-title for the dialog window.

 

intX,intY: integer numerical values corresponding to the viewing coordinates (x column, y line). If it is  -1  the dialog window appears at the center of the screen.

 

intWidth: integer value corresponding to the dialog window width.

 

intHeight: integer value corresponding to the dialog window length.

 

strFileOrElements: string that can contain both the text file path with the elements to view (each for a line), and the text with the elements divided by (;).

 

BoolMultipleSelection: Boolean value that, if true, enables the multiple elements selection.

 

Returned value

 

StrElement: string containing the chosen element. It is empty if no element has been chosen.

 

Notes

 

None.

 

Example

 

//it shows a selection dialog in the centre of the screen with 5 elements that can be //selected

Element:=ShowSelectionList('Element selection ','Select an element from the list: ',-1,-1,320,240,'one;two;three;four;five');

 

//It shows the chosen element by a message

ShowMessage('Chosen element: '+Element);