Platforms to show: All Mac Windows Linux Cross-Platform
Back to WinFileDialogMBS class.
WinFileDialogMBS.AddCheckButton(ControlID as Integer, label as String, Checked as boolean = false)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Navigation | MBS WinFrameworks Plugin | 20.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop only |
ControlID: The ID of the check button to add.
Label: the button text.
Checked: A boolean indicating the current state of the check button. True if checked; false otherwise.
The default state for this control is enabled and visible.
Some examples using this method:
WinFileDialogMBS.AddComboBox(ControlID as Integer)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Navigation | MBS WinFrameworks Plugin | 20.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop only |
ControlID: The ID of the combo box to add.
The default state for this control is enabled and visible.
Some examples using this method:
WinFileDialogMBS.AddControlItem(ControlID as Integer, ItemID as Integer, Label as String)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Navigation | MBS WinFrameworks Plugin | 20.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop only |
ControlID: The ID of the container control to which the item is to be added.
ItemID: The ID of the item.
Label: The item's text, which can be either a label or, in the case of a drop-down list, the item itself.
The default state for this item is enabled and visible. Items in control groups cannot be changed after they have been created, with the exception of their enabled and visible states.
Container controls include option button groups, combo boxes, drop-down lists on the Open or Save button, and menus.
Some examples using this method:
WinFileDialogMBS.AddEditBox(ControlID as Integer, Text as String = "")
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Navigation | MBS WinFrameworks Plugin | 20.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop only |
ControlID: The ID of the edit box to add.
Text: The default text displayed in the edit box.
The default state for this control is enabled and visible.
To add a label next to the edit box, place it in a visual group with StartVisualGroup.
Some examples using this method:
WinFileDialogMBS.AddMenu(ControlID as Integer, Label as String)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Navigation | MBS WinFrameworks Plugin | 20.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop only |
ControlID: The ID of the menu to add.
Label: The menu name.
The default state for this control is enabled and visible.
To add items to this control, use AddControlItem.
WinFileDialogMBS.AddPlace(Item as WinShellItemMBS, top as boolean = false)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Navigation | MBS WinFrameworks Plugin | 20.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop only |
Item: the folder to be made available to the user. This can only be a folder.
Top: Specifies where the folder is placed within the list. Pass true for top or false for bottom.
WinFileDialogMBS.AddPushButton(ControlID as Integer, Label as String)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Navigation | MBS WinFrameworks Plugin | 20.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop only |
ControlID: The ID of the button to add.
Label: the button text
The default state for this control is enabled and visible..
WinFileDialogMBS.AddRadioButtonList(ControlID as Integer)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Navigation | MBS WinFrameworks Plugin | 20.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop only |
ControlID: The ID of the option button group to add.
The default state for this control is enabled and visible.
WinFileDialogMBS.AddSeparator(ControlID as Integer)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Navigation | MBS WinFrameworks Plugin | 20.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop only |
ControlID: The control ID of the separator.
The default state for this control is enabled and visible.
WinFileDialogMBS.AddText(ControlID as Integer, Text as String = "")
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Navigation | MBS WinFrameworks Plugin | 20.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop only |
ControlID: The ID of the text to add.
Text: The text to show.
The default state for this control is enabled and visible.
WinFileDialogMBS.CheckButtonState(ControlID as Integer) as Boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Navigation | MBS WinFrameworks Plugin | 20.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop only |
ControlID: The ID of the check box.
True means checked; false, unchecked.
(Read and Write computed property)
Some examples using this property:
WinFileDialogMBS.ClearClientData
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Navigation | MBS WinFrameworks Plugin | 20.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop only |
Persisted information can be associated with an application or a GUID. If a GUID was set by using SetClientGuid, that GUID is used to clear persisted information.
WinFileDialogMBS.Close(cancel as boolean = false)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Navigation | MBS WinFrameworks Plugin | 20.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop only |
Pass or false/true for cancel parameter to have that being returned by Show method.
An application can call this method from an event while the dialog is open. The dialog will close and the Show method will return with the result given by cancel parameter.
If this method is called, there is no result available for the Result or Results methods, and they will fail if called.
WinFileDialogMBS.Constructor Private
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Navigation | MBS WinFrameworks Plugin | 20.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop only |
WinFileDialogMBS.ControlItemState(ControlID as Integer, ItemID as Integer) as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Navigation | MBS WinFrameworks Plugin | 20.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop only |
ControlID: The ID of the container control.
ItemID: The ID of the item.
See kControlState* flags.
(Read and Write computed property)
WinFileDialogMBS.ControlItemText(ControlID as Integer, ItemID as Integer) as String
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Navigation | MBS WinFrameworks Plugin | 20.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop only |
For example, the text that accompanies a radio button or an item in a menu.
ControlID: The ID of the container control.
ItemID: The ID of the item.
The default state of a control item is enabled and visible. Items in control groups cannot be changed after they have been created, with the exception of their enabled and visible states.
Container controls include option button groups, combo boxes, drop-down lists on the Open or Save button, and menus.
(Read and Write computed property)
Some examples using this property:
WinFileDialogMBS.ControlLabel(ControlID as Integer) as String
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Navigation | MBS WinFrameworks Plugin | 20.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop only |
ControlID: The ID of the control whose text is to be changed.
Control labels can be changed at any time, including when the dialog is visible.
(Read and Write computed property)
WinFileDialogMBS.ControlState(ControlID as Integer) as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Navigation | MBS WinFrameworks Plugin | 20.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop only |
ControlID: The ID of the control in question.
See kControlState* flags.
(Read and Write computed property)
Some examples using this property:
WinFileDialogMBS.EditBoxText(ControlID as Integer) as String
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Navigation | MBS WinFrameworks Plugin | 20.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop only |
ControlID: The ID of the edit box.
(Read and Write computed property)
Some examples using this property:
WinFileDialogMBS.EnableOpenDropDown(ControlID as Integer)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Navigation | MBS WinFrameworks Plugin | 20.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop only |
ControlID: The ID of the drop-down list.
The Open or Save button label takes on the text of the first item in the drop-down. This overrides any label set by OkButtonLabel.
Use AddControlItem to add items to the drop-down.
WinFileDialogMBS.EndVisualGroup
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Navigation | MBS WinFrameworks Plugin | 20.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop only |
Some examples using this method:
WinFileDialogMBS.RemoveAllControlItems(ControlID as Integer)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Navigation | MBS WinFrameworks Plugin | 20.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop only |
ControlID: The ID of the container control from which to remove the items.
Container controls include option button groups, combo boxes, drop-down lists on the Open or Save button, and menus.
WinFileDialogMBS.RemoveControlItem(ControlID as Integer, ItemID as Integer)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Navigation | MBS WinFrameworks Plugin | 20.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop only |
ControlID: The ID of the container control from which the item is to be removed.
ItemId: The ID of the item.
Container controls include option button groups, combo boxes, drop-down lists on the Open or Save button, and menus.
WinFileDialogMBS.SelectedControlItem(ControlID as Integer) as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Navigation | MBS WinFrameworks Plugin | 20.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop only |
ControlID: The ID of the container control.
Value is the ID of the item that the user selected in the control.
To determine the user's final choice, this method can be called on option button groups, combo boxes, and drop-down lists on the Open or Save button after the dialog has closed. This method cannot be called on menus.
For option button groups and combo boxes, this method can also be called while the dialog is showing, to determine the current choice.
When you query, the plugin does not raise error for failure, but returns 0.
(Read and Write computed property)
Some examples using this property:
WinFileDialogMBS.SetFileTypes(FileTypes() as WinFileTypeMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Navigation | MBS WinFrameworks Plugin | 20.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop only |
When using the Open dialog, the file types declared there are used to filter the view. When using the Save dialog, these values determine which file name extension is appended to the file name.
This method must be called before the dialog is shown and can only be called once for each dialog instance. File types cannot be modified once the Common Item dialog box is displayed.
Some examples using this method:
WinFileDialogMBS.Show as Boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Navigation | MBS WinFrameworks Plugin | 20.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop only |
Returns true on success or false on failure.
See also:
WinFileDialogMBS.Show(parent as DesktopWindow) as Boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Navigation | MBS WinFrameworks Plugin | 22.0 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop only |
parent: The handle of the owner window. This value can be nil.
Returns true on success or false on failure.
See also:
WinFileDialogMBS.Show(parent as window) as Boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Navigation | MBS WinFrameworks Plugin | 20.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop only |
parent: The handle of the owner window. This value can be nil.
Returns true on success or false on failure.
See also:
WinFileDialogMBS.StartVisualGroup(ControlID as Integer, label as String)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Navigation | MBS WinFrameworks Plugin | 20.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop only |
ControlID: The ID of the visual group.
Label: text that appears next to the visual group.
Controls will continue to be added to this visual group until you call EndVisualGroup.
A visual group can be hidden and disabled like any other control, except that doing so affects all of the controls within it. Individual members of the visual group can also be hidden and disabled singly.
Some examples using this method:
The items on this page are in the following plugins: MBS WinFrameworks Plugin.
