Class

MobileDocumentPicker

Description

This class allows Mobile users to select & save folder items beyond the own app Sandbox; that includes, files on the Device, shared folders/files, available remote synced volumes (iCloud, Dropbox, etc.).

Properties

Name	Type	Read-Only	Shared
Name	String	✓

Methods

Name	Parameters	Returns
Handle		Ptr
Open	filter As String, allowsMultipleSelection As Boolean
Save	file As FolderItem

Events

Name	Parameters	Returns
Canceled
Closing
Opening
Selected	files() As FolderItem

Property descriptions

MobileDocumentPicker.Name

Name As String

The name of the control.

This property is read-only.

Method descriptions

MobileDocumentPicker.Handle

Handle As Ptr

The handle to the underlying native OS control.

Important

This is supported for iOS only.

MobileDocumentPicker.Open

Open(filter As String, allowsMultipleSelection As Boolean)

When allowsMultipleSelection is True, the user can choose as many files he wants.

MobileDocumentPicker.Save

Save(file As FolderItem)

Opens the MobileDocumentPicker controller UI so the user can save the passed FolderItem in the selected path outside of the own app sandbox.

For example, on iOS under the iCloud folder, on the Device itself (global), under the Shared folder (global) or any other folder the user may want to create during the process.

Event descriptions

MobileDocumentPicker.Canceled

Canceled

Raised in combination with the Open method, when the user dismiss the dialog.

MobileDocumentPicker.Closing

Closing

Called when the control's layout is closing.

MobileDocumentPicker.Opening

Opening

Called when the control's layout is opening.

This is where you typically put initialization code.

This example in the Opening event of a label sets its text to "Hello":
Me.Text = "Hello"

MobileDocumentPicker.Selected

Selected(files() As FolderItem)

Receives an array of selected FolderItems.

Compatibility

Project Types	Mobile
Operating Systems	All