| Components | All | New | MacOS | Windows | Linux | iOS | ||||
| Examples | Mac & Win | Server | Client | Guides | Statistic | FMM | Blog | Deprecated | Old | |
ListDialog.ShowDialog
Shows the dialog.
| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
| ListDialog | 4.2 | ✅ Yes | ✅ Yes | ❌ No | ❌ No | ✅ Yes |
MBS( "ListDialog.ShowDialog" { ; TopMost } ) More
Parameters
| Parameter | Description | Example | Flags |
|---|---|---|---|
| TopMost | Whether the dialog will get top most flag on Windows. Pass 1 to make it topmost, pass 0 or nothing for normal behavior. |
Optional Added in version 10.1. |
Result
Returns OK, Other, Cancel or error.
Description
Shows the dialog.Returns the OK, Other, or Cancel to indicate which button was used to close the dialog.
Due to a bug in 15.2, it returns "Select" unless changed with ListDialog.SetSelectButtonValue function.
Added iOS support in version 15.3.
Examples
Shows a dialog:
Set Variable [$r; Value:MBS("ListDialog.ClearList")]
Set Variable [$r; Value:MBS("ListDialog.SetPrompt"; "Please select an item:")]
Set Variable [$r; Value:MBS("ListDialog.AddItemToList"; "First Item"; "1234")]
Set Variable [$r; Value:MBS("ListDialog.SetAllowMultipleSelection"; 1)]
Set Variable [$r; Value:MBS("ListDialog.SetSelectedTitle"; "1234")]
Set Variable [$r; Value:MBS("ListDialog.ShowDialog")]
Set Field [ListDialog::Result; $r]
Set Field [ListDialog::Selected Tag; MBS("ListDialog.GetSelectedTag")]
Set Field [ListDialog::Selected; MBS("ListDialog.GetSelectedTitle")]
Set Variable [$r; Value:MBS("ListDialog.SetPrompt"; "Please select an item:")]
Set Variable [$r; Value:MBS("ListDialog.AddItemToList"; "First Item"; "1234")]
Set Variable [$r; Value:MBS("ListDialog.SetAllowMultipleSelection"; 1)]
Set Variable [$r; Value:MBS("ListDialog.SetSelectedTitle"; "1234")]
Set Variable [$r; Value:MBS("ListDialog.ShowDialog")]
Set Field [ListDialog::Result; $r]
Set Field [ListDialog::Selected Tag; MBS("ListDialog.GetSelectedTag")]
Set Field [ListDialog::Selected; MBS("ListDialog.GetSelectedTitle")]
See also
- List.HasValue
- ListDialog.AddItemsToList
- ListDialog.AddItemToList
- ListDialog.GetSelectedTag
- ListDialog.GetSelectedTitle
- ListDialog.SetAllowMultipleSelection
- ListDialog.SetFilter
- ListDialog.SetSelectButtonValue
- ListDialog.SetSelectedTitle
- SyntaxColoring.AddContextMenuCommand
Release notes
- Version 15.2
- Added ListDialog.SetCancelButtonValue, ListDialog.SetOtherButtonValue and ListDialog.SetSelectButtonValue to set what value is returned by ListDialog.ShowDialog function.
- Version 13.5
- Changed ListDialog.ShowDialog to allow two line prompt line.
Example Databases
- List/ListDialog Grouping
- List/ListDialog
- Mac and iOS/PDFKit/PDFKit Print Documents
- SmartCard/Belgian EID Reader
- Win Only/Snippets for Windows
Blog Entries
- ListDialog for iOS
- MBS FileMaker Plugin, version 15.2pr2
- MBS FileMaker Advent calendar - Door 10 - Reading The Wish List
- MBS Plugin Advent calendar: 22 - ListDialog
- MBS FileMaker Plugin, version 13.5pr4
- New functions of the MBS Plugin Version 9.5
This function is free to use.
Created 18th August 2014, last changed 20th May 2025
