PHPickerControlMBS.BoundsChanged

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	New	MBS iOS Plugin	25.1	✅ Yes	❌ No	❌ No	❌ No

The event called when the bounds, but not the frame, changed.

PHPickerControlMBS.Close

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	New	MBS iOS Plugin	25.1	✅ Yes	❌ No	❌ No	❌ No

The control is about to close.
In Xojo version 2021r3 and newer this event is named Closing.

PHPickerControlMBS.Closing

Type	Topic	Version
event	New	25.1

The control is about to close.
In older Xojo versions, this event is named Close.

PHPickerControlMBS.Configure as PHPickerConfigurationMBS

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	New	MBS iOS Plugin	25.1	✅ Yes	❌ No	❌ No	❌ No

Queries the configuration to use.

Please return the PHPickerConfigurationMBS object to use for the control.
This is called before the open event.

PHPickerControlMBS.ConstructContextualMenu(base as MenuItem, x as Integer, y as Integer) as Boolean

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	New	MBS iOS Plugin	25.1	✅ Yes	❌ No	❌ No	❌ No

This event is called when it is appropriate to display a contextual menu for the control.

PHPickerControlMBS.ContextualMenuAction(hitItem as MenuItem) as Boolean

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	New	MBS iOS Plugin	25.1	✅ Yes	❌ No	❌ No	❌ No

Called when a menuitem is choosen.

This allows the control to react on its relevant menu items. Please return true if you handled it or false to give others a chance.

PHPickerControlMBS.didCloseContextualMenu(menu as NSMenuMBS, NSEvent as NSEventMBS)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	New	MBS iOS Plugin	25.1	✅ Yes	❌ No	❌ No	❌ No

Did close contextual menu.

Allows you to restart any animation you may have stopped in the willShowContextualMenu event.

PHPickerControlMBS.didFinishPicking(Result() as PHPickerResultMBS)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	New	MBS iOS Plugin	25.1	✅ Yes	❌ No	❌ No	❌ No

Notifies the delegate that the user completed a selection or dismissed the picker using the cancel button.

picker: The currently presented picker view controller.
results: The results of the user’s selections.

The system doesn’t automatically dismiss the picker after calling this method, but the plugin does.

It may happen that the user manages to dismiss the dialog without this event running. Seems to be a bug in iOS. So you can catch the viewDidDisappear event and do any cleanup there, if the didFinishPicking event did not fire before.

PHPickerControlMBS.EnableMenuItems

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	New	MBS iOS Plugin	25.1	✅ Yes	❌ No	❌ No	❌ No

The event where you can enable menu items.
In Xojo version 2021r3 and newer this event is named MenuBarSelected.

PHPickerControlMBS.FocusLost

Type	Topic	Version
event	New	25.1

The control lost focus.
In older Xojo versions, this event is named LostFocus.

This only fires if the control itself lost focus and not a sub control.

PHPickerControlMBS.FocusReceived

Type	Topic	Version
event	New	25.1

The control itself got focus.
In older Xojo versions, this event is named GotFocus.

This only fires if the control itself got focus and not a sub control.

PHPickerControlMBS.FrameChanged

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	New	MBS iOS Plugin	25.1	✅ Yes	❌ No	❌ No	❌ No

The event called when the frame changed.

This event notifies you, that the control changed it's bounding frame, which is position and/or size.

PHPickerControlMBS.GotFocus

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	New	MBS iOS Plugin	25.1	✅ Yes	❌ No	❌ No	❌ No

The control itself got focus.
In Xojo version 2021r3 and newer this event is named FocusReceived.

This only fires if the control itself got focus and not a sub control.

PHPickerControlMBS.LostFocus

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	New	MBS iOS Plugin	25.1	✅ Yes	❌ No	❌ No	❌ No

The control lost focus.
In Xojo version 2021r3 and newer this event is named FocusLost.

This only fires if the control itself lost focus and not a sub control.

PHPickerControlMBS.MenuBarSelected

Type	Topic	Version
event	New	25.1

The event where you can enable menu items.
In older Xojo versions, this event is named EnableMenuItems.

PHPickerControlMBS.MouseDown(x as Integer, y as Integer, Modifiers as Integer) As Boolean

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	New	MBS iOS Plugin	25.1	✅ Yes	❌ No	❌ No	❌ No

The mouse button was pressed inside the control’s region at the location passed in to x, y.

The coordinates x and y are local to the control, i.e. they represent the position of the mouse click relative to the upper-left corner or the Control.
Return True if you are going to handle the MouseDown. In such a case:

• The Action event, if any, will not execute and the state of the object will not change.
• You will receive the MouseDrag and MouseUp events.

If you return False, the system handles the MouseDown so the above event handlers do not get called.

PHPickerControlMBS.MouseDrag(x as Integer, y as Integer)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	New	MBS iOS Plugin	25.1	✅ Yes	❌ No	❌ No	❌ No

This event fires continuously after the mouse button was pressed inside the Control.

Mouse location is local to the control passed in to x, y.
As this event is fired continuously (hundreds of time per second), it is your responsibility to determine if the mouse has really moved.

PHPickerControlMBS.MouseUp(x As Integer, y As Integer)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	New	MBS iOS Plugin	25.1	✅ Yes	❌ No	❌ No	❌ No

The mouse button was released.

Use the x and y parameters to determine if the mouse button was released within the control's boundaries.

PHPickerControlMBS.Open

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	New	MBS iOS Plugin	25.1	✅ Yes	❌ No	❌ No	❌ No

The control is about to was created and you can initialize it.
In Xojo version 2021r3 and newer this event is named Opening.

PHPickerControlMBS.Opening

Type	Topic	Version
event	New	25.1

The control is about to was created and you can initialize it.
In older Xojo versions, this event is named Open.

PHPickerControlMBS.ScaleFactorChanged(NewFactor as double)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	New	MBS iOS Plugin	25.1	✅ Yes	❌ No	❌ No	❌ No

The backing store scale factor has changed.

Please invalidate any cached bitmaps or other relevant state.

PHPickerControlMBS.viewDidAppear

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	New	MBS iOS Plugin	25.1	✅ Yes	❌ No	❌ No	❌ No

The view appeared.

PHPickerControlMBS.willShowContextualMenu(menu as NSMenuMBS, NSEvent as NSEventMBS)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	New	MBS iOS Plugin	25.1	✅ Yes	❌ No	❌ No	❌ No

Will show contextual menu.

Your chance to modify the menu before it is shown, e.g. to add menu entries.