Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old


Adds entries to the list.

Component Version macOS Windows Linux Server iOS SDK
ListDialog 4.2 ✅ Yes ✅ Yes ❌ No ❌ No ❌ No
MBS( "ListDialog.AddItemsToList"; titles { ; tags } )   More


Parameter Description Example Flags
titles The titles to add. "Hello World"
tags The tags, e.g. the record ID. "1234" Optional


Returns number of items.


Adds entries to the list.
You can pass a list of items (separated with new line character)
If tag for an item is #, plugin will mark this entry as header item.
The titles text may contain in each line the text for multiple columns separated by tab character, e.g. char(9).


Add two items

MBS( "ListDialog.AddItemsToList"; "Hello¶World" )

Add header with two items

MBS( "ListDialog.AddItemsToList"; "Names¶Steve¶Joe¶Geoff"; "#¶1¶2¶3" )

Take two lists to fill two columns in a list dialog:

MBS("ListDialog.AddItemsToList"; MBS( "List.CrossProduct"; ListDialog::Text1; ListDialog::Text2; ""; Char(9); ""; 2))

Query field 1 and field 2 merged together with tab character for adding to a list:

MBS( "FM.ExecuteFileSQL"; ""; "SELECT (\"Field1\" + Chr(9) + \"Field2\") FROM MyTable")

Shows a list to pick an item from three items:

Set Variable [$r; Value:MBS("ListDialog.ClearList")]
Set Variable [$r; Value:MBS("ListDialog.SetPrompt"; "Please select an item:")]
Set Variable [$r; Value:MBS("ListDialog.AddItemsToList"; "ein¶zwei¶drei")]
Set Variable [$r; Value:MBS("ListDialog.ShowDialog")]
Set Field [ListDialog::Result; $r]
Set Field [ListDialog::Selected; MBS("ListDialog.GetSelectedTitle")]

See also

Example Databases

Blog Entries

This function checks for a license.

Created 18th August 2014, last changed 9th March 2023

ListDialog.AddItemToList - ListDialog.AddSQL