Component: ListDialog ---------------------- Functions for a dialog to pick items from a list. | Version | macOS | Windows | Linux | Server | iOS SDK | |---|---|---|---|---|---| | [4.2](newinversion42.md "First functions introduced with version 4.2.") / [15.2](newinversion152.md "Newest functions in version 15.2.") | ✅ Yes | ✅ 97% | ❌ No | ❌ No | 🔶 59% | | Item | Details | |:--|:--| | [ListDialog.AddItemToList](ListDialogAddItemToList.md) Adds a line to the list. | Mac/Win/iOS 4.2 | | [ListDialog.AddItemsToList](ListDialogAddItemsToList.md) Adds entries to the list. | Mac/Win/iOS 4.2 | | [ListDialog.AddSQL](ListDialogAddSQL.md) Adds items via SQL statement. | Mac/Win/iOS 5.1 | | [ListDialog.ClearColumnHeaders](ListDialogClearColumnHeaders.md) Clears column headers. | Mac/Win 9.2 | | [ListDialog.ClearList](ListDialogClearList.md) Clears the list. | Mac/Win/iOS 4.2 | | [ListDialog.ColumnCount](ListDialogColumnCount.md) Queries column count. | Mac/Win 9.2 | | [ListDialog.GetAllowEmptySelection](ListDialogGetAllowEmptySelection.md) Queries whether empty selection is allowed. | Mac/Win/iOS 5.0 | | [ListDialog.GetAllowMultipleSelection](ListDialogGetAllowMultipleSelection.md) Queries whether multiple selection is allowed. | Mac/Win/iOS 4.2 | | [ListDialog.GetCancelButtonLabel](ListDialogGetCancelButtonLabel.md) Queries the caption of the cancel button. | Mac/Win/iOS 4.2 | | [ListDialog.GetCancelButtonValue](ListDialogGetCancelButtonValue.md) Queries cancel button value. | Mac/Win/iOS 15.2 | | [ListDialog.GetChecked](ListDialogGetChecked.md) Queries check state. | Mac/Win 13.5 | | [ListDialog.GetCheckedTags](ListDialogGetCheckedTags.md) Queries list of checked items. | Mac/Win 13.5 | | [ListDialog.GetCheckedTitles](ListDialogGetCheckedTitles.md) Queries list of checked items. | Mac/Win 13.5 | | [ListDialog.GetCloseDialogOnDoubleClick](ListDialogGetCloseDialogOnDoubleClick.md) Queries whether to close dialog on double click. | Mac/Win 14.1 | | [ListDialog.GetColumnAlignment](ListDialogGetColumnAlignment.md) Queries column alignment. | Mac/Win 11.2 | | [ListDialog.GetColumnHeader](ListDialogGetColumnHeader.md) Queries column header text. | Mac/Win 9.2 | | [ListDialog.GetColumnWidth](ListDialogGetColumnWidth.md) Queries column width. | Mac/Win 11.2 | | [ListDialog.GetFilter](ListDialogGetFilter.md) Queries the current filter text. | Mac/Win/iOS 11.0 | | [ListDialog.GetHeight](ListDialogGetHeight.md) Queries height of dialog. | Mac/Win 4.3 | | [ListDialog.GetOtherButtonEvaluate](ListDialogGetOtherButtonEvaluate.md) Queries expression to evaluate for other button. | Mac/Win/iOS 9.5 | | [ListDialog.GetOtherButtonLabel](ListDialogGetOtherButtonLabel.md) Queries the caption of the other button. | Mac/Win/iOS 9.5 | | [ListDialog.GetOtherButtonNeedsSelection](ListDialogGetOtherButtonNeedsSelection.md) Queries whether an other button needs a selection just like Select button. | Mac/Win/iOS 15.2 | | [ListDialog.GetOtherButtonValue](ListDialogGetOtherButtonValue.md) Queries other button value. | Mac/Win/iOS 15.2 | | [ListDialog.GetPositionX](ListDialogGetPositionX.md) Queries dialog position. | Mac/Win 6.5 | | [ListDialog.GetPositionY](ListDialogGetPositionY.md) Queries dialog position. | Mac/Win 6.5 | | [ListDialog.GetPrompt](ListDialogGetPrompt.md) Queries the current prompt text. | Mac/Win/iOS 4.2 | | [ListDialog.GetSelectButtonLabel](ListDialogGetSelectButtonLabel.md) Queries the caption of the select button. | Mac/Win/iOS 4.2 | | [ListDialog.GetSelectButtonValue](ListDialogGetSelectButtonValue.md) Queries select button value. | Mac/Win/iOS 15.2 | | [ListDialog.GetSelectedTag](ListDialogGetSelectedTag.md) Queries the selected tag. | Mac/Win/iOS 4.2 | | [ListDialog.GetSelectedTitle](ListDialogGetSelectedTitle.md) Queries title of the selected item. | Mac/Win/iOS 4.2 | | [ListDialog.GetShowCheckboxes](ListDialogGetShowCheckboxes.md) Queries whether to show checkboxes. | Mac/Win 13.5 | | [ListDialog.GetShowCloseBox](ListDialogGetShowCloseBox.md) Queries whether the close box is enabled. | Mac/Win 14.2 | | [ListDialog.GetShowsFilter](ListDialogGetShowsFilter.md) Queries whether to show a filter. | Mac/Win/iOS 11.0 | | [ListDialog.GetSwapButtons](ListDialogGetSwapButtons.md) Query whether to swap buttons. | Mac/Win 15.2 | | [ListDialog.GetUsesAlternatingRowBackgroundColors](ListDialogGetUsesAlternatingRowBackgroundColors.md) Whether alternating row background colors should be used. | Mac/iOS 10.4 | | [ListDialog.GetWidth](ListDialogGetWidth.md) Queries the width of the dialog. | Mac/Win 4.3 | | [ListDialog.GetWindowTitle](ListDialogGetWindowTitle.md) Queries the window title. | Mac/Win 4.2 | | [ListDialog.IsVisible](ListDialogIsVisible.md) Query whether dialog is visible. | Mac/Win/iOS 13.2 | | [ListDialog.ListCount](ListDialogListCount.md) Queries number of list entries. | Mac/Win/iOS 4.2 | | [ListDialog.ListItem](ListDialogListItem.md) Queries the text displayed for the given index. | Mac/Win/iOS 4.2 | | [ListDialog.ListTag](ListDialogListTag.md) Queries the tag for the given index. | Mac/Win/iOS 4.2 | | [ListDialog.Reset](ListDialogReset.md) Resets all list dialog options. | Mac/Win/iOS 10.0 | | [ListDialog.SetAllowEmptySelection](ListDialogSetAllowEmptySelection.md) Sets whether empty selection is allowed. | Mac/Win/iOS 5.0 | | [ListDialog.SetAllowMultipleSelection](ListDialogSetAllowMultipleSelection.md) Sets whether multiple selection is allowed. | Mac/Win/iOS 4.2 | | [ListDialog.SetCancelButtonLabel](ListDialogSetCancelButtonLabel.md) Sets the caption of the cancel button. | Mac/Win/iOS 4.2 | | [ListDialog.SetCancelButtonValue](ListDialogSetCancelButtonValue.md) Sets the value returned by ShowDialog function if the cancel button was clicked. | Mac/Win/iOS 15.2 | | [ListDialog.SetChecked](ListDialogSetChecked.md) Sets check state for a row. | Mac/Win 13.5 | | [ListDialog.SetCloseDialogOnDoubleClick](ListDialogSetCloseDialogOnDoubleClick.md) Sets whether to close dialog on double click. | Mac/Win/iOS 14.1 | | [ListDialog.SetColumnAlignment](ListDialogSetColumnAlignment.md) Sets the column alignment. | Mac/Win 11.2 | | [ListDialog.SetColumnCount](ListDialogSetColumnCount.md) Sets column count. | Mac/Win 9.2 | | [ListDialog.SetColumnHeader](ListDialogSetColumnHeader.md) Sets the column header text. | Mac/Win 9.2 | | [ListDialog.SetColumnWidth](ListDialogSetColumnWidth.md) Sets column width to use. | Mac/Win 11.2 | | [ListDialog.SetFilter](ListDialogSetFilter.md) Sets the current filter text. | Mac/Win/iOS 11.0 | | [ListDialog.SetHeight](ListDialogSetHeight.md) Sets the height of the dialog. | Mac/Win 4.3 | | [ListDialog.SetOtherButtonEvaluate](ListDialogSetOtherButtonEvaluate.md) Sets the other button evaluate. | Mac/Win/iOS 9.5 | | [ListDialog.SetOtherButtonLabel](ListDialogSetOtherButtonLabel.md) Sets the caption of the other button. | Mac/Win/iOS 9.5 | | [ListDialog.SetOtherButtonNeedsSelection](ListDialogSetOtherButtonNeedsSelection.md) Sets whether an other button needs a selection just like Select button. | Mac/Win/iOS 15.2 | | [ListDialog.SetOtherButtonValue](ListDialogSetOtherButtonValue.md) Sets the value returned by ShowDialog function if the other button was clicked. | Mac/Win/iOS 15.2 | | [ListDialog.SetPosition](ListDialogSetPosition.md) Sets position for dialog. | Mac/Win 6.5 | | [ListDialog.SetPositionX](ListDialogSetPositionX.md) Sets position for dialog. | Mac/Win 6.5 | | [ListDialog.SetPositionY](ListDialogSetPositionY.md) Sets position for dialog. | Mac/Win 6.5 | | [ListDialog.SetPrompt](ListDialogSetPrompt.md) Sets prompt text. | Mac/Win/iOS 4.2 | | [ListDialog.SetSelectButtonLabel](ListDialogSetSelectButtonLabel.md) Sets the caption of the select button. | Mac/Win/iOS 4.2 | | [ListDialog.SetSelectButtonValue](ListDialogSetSelectButtonValue.md) Sets the value returned by ShowDialog function if the select button was clicked. | Mac/Win/iOS 15.2 | | [ListDialog.SetSelectedTag](ListDialogSetSelectedTag.md) Sets which item is selected. | Mac/Win/iOS 4.2 | | [ListDialog.SetSelectedTitle](ListDialogSetSelectedTitle.md) Sets which item is selected. | Mac/Win/iOS 4.2 | | [ListDialog.SetShowCheckboxes](ListDialogSetShowCheckboxes.md) Sets whether to show checkboxes. | Mac/Win 13.5 | | [ListDialog.SetShowCloseBox](ListDialogSetShowCloseBox.md) Sets whether the close box widget is enabled. | Mac/Win 14.2 | | [ListDialog.SetShowsFilter](ListDialogSetShowsFilter.md) Whether to show a filter field. | Mac/Win/iOS 11.0 | | [ListDialog.SetSwapButtons](ListDialogSetSwapButtons.md) Whether to swap buttons. | Mac/Win 15.2 | | [ListDialog.SetUsesAlternatingRowBackgroundColors](ListDialogSetUsesAlternatingRowBackgroundColors.md) Set whether alternating row background colors should be used. | Mac/iOS 10.4 | | [ListDialog.SetWidth](ListDialogSetWidth.md) Sets the width of the dialog. | Mac/Win 4.3 | | [ListDialog.SetWindowTitle](ListDialogSetWindowTitle.md) Sets window title. | Mac/Win 4.2 | | [ListDialog.ShowDialog](ListDialogShowDialog.md) Shows the dialog. | Mac/Win/iOS 4.2 | | [ListDialog.Sort](ListDialogSort.md) Sorts entries. | Mac/Win/iOS 7.5 | 75 functions shown. ### Release notes - **Version 15.3** - Fixed [ListDialog](https://www.mbsplugins.eu/component_ListDialog.shtml) functions to return OK instead of Select on success. - **Version 15.2** - Added [ListDialog.GetCancelButtonValue](https://www.mbsplugins.eu/ListDialogGetCancelButtonValue.shtml), [ListDialog.GetOtherButtonValue](https://www.mbsplugins.eu/ListDialogGetOtherButtonValue.shtml) and [ListDialog.GetSelectButtonValue](https://www.mbsplugins.eu/ListDialogGetSelectButtonValue.shtml) functions. - Added [ListDialog.SetCancelButtonValue](https://www.mbsplugins.eu/ListDialogSetCancelButtonValue.shtml), [ListDialog.SetOtherButtonValue](https://www.mbsplugins.eu/ListDialogSetOtherButtonValue.shtml) and [ListDialog.SetSelectButtonValue](https://www.mbsplugins.eu/ListDialogSetSelectButtonValue.shtml) to set what value is returned by [ListDialog.ShowDialog](https://www.mbsplugins.eu/ListDialogShowDialog.shtml) function. - Added [ListDialog.SetOtherButtonNeedsSelection](https://www.mbsplugins.eu/ListDialogSetOtherButtonNeedsSelection.shtml) and [ListDialog.GetOtherButtonNeedsSelection](https://www.mbsplugins.eu/ListDialogGetOtherButtonNeedsSelection.shtml) functions. - Added [ListDialog.SetSwapButtons](https://www.mbsplugins.eu/ListDialogSetSwapButtons.shtml) and [ListDialog.GetSwapButtons](https://www.mbsplugins.eu/ListDialogGetSwapButtons.shtml) functions. - Fixed an issue with [ListDialog.AddSQL](https://www.mbsplugins.eu/ListDialogAddSQL.shtml) function where filename parameter was ignored if no other parameters followed. - Improved [ListDialog.SetOtherButtonEvaluate](https://www.mbsplugins.eu/ListDialogSetOtherButtonEvaluate.shtml) and [ListDialog.SetOtherButtonLabel](https://www.mbsplugins.eu/ListDialogSetOtherButtonLabel.shtml) to allow three other buttons. - **Version 14.3** - Changed [ListDialog.SetShowCheckboxes](https://www.mbsplugins.eu/ListDialogSetShowCheckboxes.shtml) to allow flag 4 to have checkboxes with only one checkbox checked at maximum. - **Version 14.2** - Added [ListDialog.GetShowCloseBox](https://www.mbsplugins.eu/ListDialogGetShowCloseBox.shtml) and [ListDialog.SetShowCloseBox](https://www.mbsplugins.eu/ListDialogSetShowCloseBox.shtml) functions. - Fixed the [ListDialog](https://www.mbsplugins.eu/component_ListDialog.shtml) functions to allow the red close widget to be used on the dialog to close it. - **Version 14.1** - Added [ListDialog.SetCloseDialogOnDoubleClick](https://www.mbsplugins.eu/ListDialogSetCloseDialogOnDoubleClick.shtml) and [ListDialog.GetCloseDialogOnDoubleClick](https://www.mbsplugins.eu/ListDialogGetCloseDialogOnDoubleClick.shtml) to decide whether the dialog closes on double click. - Fixed a crash in [ListDialog.Sort](https://www.mbsplugins.eu/ListDialogSort.shtml) when there is no list to sort. - Fixed headers in [ListDialog](https://www.mbsplugins.eu/component_ListDialog.shtml) functions to not show check boxes. - Improved [ListDialog](https://www.mbsplugins.eu/component_ListDialog.shtml) functions to match headers with all their items if you search for them. - Improved [ListDialog](https://www.mbsplugins.eu/component_ListDialog.shtml) functions to not show empty header lines if you filter entries. - **Version 14.0** - Fixed [ListDialog](https://www.mbsplugins.eu/component_ListDialog.shtml) functions to not use column widths if you have only one column. - **Version 13.5** - Added support for having checkboxes in a list dialog for [ListDialog](https://www.mbsplugins.eu/component_ListDialog.shtml) functions. - Changed [ListDialog.ShowDialog](https://www.mbsplugins.eu/ListDialogShowDialog.shtml) to allow two line prompt line. - Fixed problem with [ListDialog](https://www.mbsplugins.eu/component_ListDialog.shtml) functions on Windows. - **Version 13.3** - Changed [ListDialog](https://www.mbsplugins.eu/component_ListDialog.shtml) functions to allow cancel button to be hidden if it has empty label. - Changed [ListDialog](https://www.mbsplugins.eu/component_ListDialog.shtml) functions to have select button enabled on macOS if no selection is made, but empty selection is allowed (same as on Windows). - **Version 13.2** - Added [ListDialog.IsVisible](https://www.mbsplugins.eu/ListDialogIsVisible.shtml) function. - Changed [ListDialog.SetOtherButtonEvaluate](https://www.mbsplugins.eu/ListDialogSetOtherButtonEvaluate.shtml) to query selection, so you can query it using [ListDialog.GetSelectedTag](https://www.mbsplugins.eu/ListDialogGetSelectedTag.shtml) and [ListDialog.GetSelectedTitle](https://www.mbsplugins.eu/ListDialogGetSelectedTitle.shtml) in your expression. ### Blog Entries - [Dialogs with fields for Windows](https://www.mbsplugins.de/archive/2026-02-25/Dialogs_with_fields_for_Window/monkeybreadsoftware_blog_filemaker) - [MBS Plugin 15.4 for Claris FileMaker](https://www.mbsplugins.de/archive/2025-09-09/MBS_Plugin_154_for_Claris_File/monkeybreadsoftware_blog_filemaker) - [ListDialog for iOS](https://www.mbsplugins.de/archive/2025-08-18/ListDialog_for_iOS/monkeybreadsoftware_blog_filemaker) - [MBS Plugin 15.3 for Claris FileMaker](https://www.mbsplugins.de/archive/2025-07-15/MBS_Plugin_153_for_Claris_File/monkeybreadsoftware_blog_filemaker) - [News in MBS FileMaker Plugin 15.2](https://www.mbsplugins.de/archive/2025-05-13/News_in_MBS_FileMaker_Plugin_1/monkeybreadsoftware_blog_filemaker) - [MBS Plugin 15.2 for Claris FileMaker](https://www.mbsplugins.de/archive/2025-05-06/MBS_Plugin_152_for_Claris_File/monkeybreadsoftware_blog_filemaker) - [MBS Plugin Advent calendar: 22 - ListDialog](https://www.mbsplugins.de/archive/2023-12-22/MBS_Plugin_Advent_calendar_22_/monkeybreadsoftware_blog_filemaker) - [MBS Plugin 13.5 for Claris FileMaker](https://www.mbsplugins.de/archive/2023-11-07/MBS_Plugin_135_for_Claris_File/monkeybreadsoftware_blog_filemaker) - [List dialog with checkboxes](https://www.mbsplugins.de/archive/2023-10-20/List_dialog_with_checkboxes/monkeybreadsoftware_blog_filemaker) - [MBS FileMaker Plugin, June 2021 News](https://www.mbsplugins.de/archive/2021-06-01/MBS_FileMaker_Plugin_June_2021/monkeybreadsoftware_blog_filemaker) ### Example Databases - [List/ListDialog Grouping](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/List/ListDialog%20Grouping.shtml#1ScriptAnchor_) - [List/ListDialog](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/List/ListDialog.shtml#1ScriptAnchor_) - [Mac and iOS/PDFKit/PDFKit Print Documents](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/Mac%20and%20iOS/PDFKit/PDFKit%20Print%20Documents.shtml#3ScriptAnchor_) - [SmartCard/Belgian EID Reader](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/SmartCard/Belgian%20EID%20Reader.shtml#6ScriptAnchor_) - [Win Only/Snippets for Windows](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/Win%20Only/Snippets%20for%20Windows.shtml#11ScriptAnchor_) [HTML Version](component_ListDialog.shtml)