Platforms to show: All Mac Windows Linux Cross-Platform

Back to DesktopIKImageBrowserViewControlMBS control.

DesktopIKImageBrowserViewControlMBS.backgroundWasRightClickedWithEvent(e as NSEventMBS)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No
Performs custom tasks when the user right-clicks the image browser view background.

event: The event that invoked the method.

This method signals that the user either right-clicked the background or left-clicked it with the Alt key pressed. You can implement this method if you want to perform custom tasks at that time.
Available in OS X v10.5 and later.

DesktopIKImageBrowserViewControlMBS.BoundsChanged

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No
The event called when the bounds, but not the frame, changed.

DesktopIKImageBrowserViewControlMBS.cellWasDoubleClickedAtIndex(index as Integer)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No
Performs custom tasks when the user double-clicks an item in the image browser view.

index: The index of the cell.

This method signals that the user double-clicked an item in the image browser view. You can implement this method if you want to perform custom tasks at that time.
Available in OS X v10.5 and later.

DesktopIKImageBrowserViewControlMBS.cellWasRightClickedAtIndex(index as Integer, e as NSEventMBS)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No
Performs custom tasks when the user right-clicks an item in the image browser view.

index: The index of the cell.
event: The event that invoked the method.

This method signals that the user either right-clicked an item in the browser or left-clicked the item with the Alt key pressed. You can implement this method if you want to perform custom tasks at that time.
Available in OS X v10.5 and later.

DesktopIKImageBrowserViewControlMBS.Closing

Type Topic Version
event ImageKit 21.5

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

DesktopIKImageBrowserViewControlMBS.concludeDragOperation(sender as NSDraggingInfoMBS)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No
Invoked when the dragging operation is complete, signaling the receiver to perform any necessary clean-up.

sender: The object sending the message; use it to get details about the dragging operation.

For this method to be invoked, the previous performDragOperation must have returned true.

The destination implements this method to perform any tidying up that it needs to do, such as updating its visual representation now that it has incorporated the dragged data. This message is the last message sent from sender to the destination during a dragging session.

If the sender object's animatesToDestination property was set to true in prepareForDragOperation, then the drag image is still visible. At this point you should draw the final visual representation in the view. When this method returns, the drag image is removed form the screen. If your final visual representation matches the visual representation in the drag, this is a seamless transition.

DesktopIKImageBrowserViewControlMBS.ConstructContextualMenu(base as DesktopMenuItem, x as Integer, y as Integer) As Boolean

Type Topic Version
event ImageKit 22.1
This event is called when it is appropriate to display a contextual menu for the control.

DesktopIKImageBrowserViewControlMBS.ContextualMenuItemSelected(selectedItem As DesktopMenuItem) As Boolean

Type Topic Version
event ImageKit 21.5
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.

DesktopIKImageBrowserViewControlMBS.didCloseContextualMenu(menu as NSMenuMBS, NSEvent as NSEventMBS)   New in 24.1

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 24.1 ✅ Yes ❌ No ❌ No ❌ No
Did close contextual menu.

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

DesktopIKImageBrowserViewControlMBS.draggingEnded(sender as NSDraggingInfoMBS)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No
Implement this event to be notified when a drag operation ends in some other destination.

sender: The object sending the message; use it to get details about the dragging operation.
This method might be used by a destination doing auto-expansion in order to collapse any auto-expands.

DesktopIKImageBrowserViewControlMBS.draggingEntered(sender as NSDraggingInfoMBS) as Integer

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No
Invoked when the dragged image enters destination bounds or frame; delegate returns dragging operation to perform.

sender: The object sending the message; use it to get details about the dragging operation.

Return one (and only one) of the dragging operation constants described in NSDragOperation in the NSDraggingInfo reference. The default return value (if this method is not implemented by the destination) is the value returned by the previous draggingEntered: message.

Invoked when a dragged image enters the destination but only if the destination has registered for the pasteboard data type involved in the drag operation. Specifically, this method is invoked when the mouse pointer enters the destination's bounds rectangle (if it is a view object) or its frame rectangle (if it is a window object).

This method must return a value that indicates which dragging operation the destination will perform when the image is released. In deciding which dragging operation to return, the method should evaluate the overlap between both the dragging operations allowed by the source (obtained from sender with the draggingSourceOperationMask method) and the dragging operations and pasteboard data types the destination itself supports.

If none of the operations is appropriate, this method should return NSDragOperationNone (this is the default response if the method is not implemented by the destination). A destination will still receive draggingUpdated: and draggingExited: even if NSDragOperationNone is returned by this method.

DesktopIKImageBrowserViewControlMBS.draggingExited(sender as NSDraggingInfoMBS)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No
Invoked when the dragged image exits the destination's bounds rectangle (in the case of a view object) or its frame rectangle (in the case of a window object).

sender: The object sending the message; use it to get details about the dragging operation.

DesktopIKImageBrowserViewControlMBS.draggingUpdated(sender as NSDraggingInfoMBS) as Integer

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No
Invoked periodically as the image is held within the destination area, allowing modification of the dragging operation or mouse-pointer position.

sender: The object sending the message; use it to get details about the dragging operation.

Returns one (and only one) of the dragging operation constants described in NSDragOperation in the NSDraggingInfo reference. The default return value (if this method is not implemented by the destination) is the value returned by the previous draggingEntered: message.

For this to be invoked, the destination must have registered for the pasteboard data type involved in the drag operation. The messages continue until the image is either released or dragged out of the window or view.

This method provides the destination with an opportunity to modify the dragging operation depending on the position of the mouse pointer inside of the destination view or window object. For example, you may have several graphics or areas of text contained within the same view and wish to tailor the dragging operation, or to ignore the drag event completely, depending upon which object is underneath the mouse pointer at the time when the user releases the dragged image and the performDragOperation method is invoked.

You typically examine the contents of the pasteboard in the draggingEntered method, where this examination is performed only once, rather than in the draggingUpdated method, which is invoked multiple times.

Only one destination at a time receives a sequence of draggingUpdated messages. If the mouse pointer is within the bounds of two overlapping views that are both valid destinations, the uppermost view receives these messages until the image is either released or dragged out.

DesktopIKImageBrowserViewControlMBS.FocusLost

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No

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.

DesktopIKImageBrowserViewControlMBS.FocusReceived

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No

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.

DesktopIKImageBrowserViewControlMBS.FrameChanged

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 21.5 ✅ 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.

DesktopIKImageBrowserViewControlMBS.groupAtIndex(index as Integer) as Dictionary

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No
Returns the group at the specified index.

index: The index of the group you want to retrieve.

Returns a dictionary that defines the group. The keys in this dictionary can be any of the following constants: IKImageBrowserGroupStyle, IKImageBrowserGroupBackgroundColorKey, IKImageBrowserGroupTitleKey, and IKImageBrowserGroupRangeKey. For more information on these constants, see IKImageBrowserView Class Reference.

This method is optional.
Available in OS X v10.5 and later.

DesktopIKImageBrowserViewControlMBS.itemAtIndex(index as Integer) as IKImageBrowserItemMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No
Returns an object for the item in an image browser view that corresponds to the specified index.

index: The index of the item you want to retrieve.

Return an IKImageBrowserItem object.

Your data source must implement this method. The returned object must implement the required methods of the IKImageBrowserItem protocol.
Available in OS X v10.5 and later.

DesktopIKImageBrowserViewControlMBS.MenuBarSelected

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No

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

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

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 21.5 ✅ 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.

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

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 21.5 ✅ 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.

DesktopIKImageBrowserViewControlMBS.MouseUp(x as Integer, y as Integer)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 21.5 ✅ 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.

DesktopIKImageBrowserViewControlMBS.moveItemsAtIndexes(indexes as NSIndexSetMBS, destinationIndex as Integer) as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No
Signals that the specified items should be moved to the specified destination.

indexes: The indexes of the items that should be reordered.
destinationIndex: The starting index of the destination the items should be moved to.

Returns true if successful; false otherwise.

This method is optional. It is invoked by the image browser view after Image Kit determines that a reordering operation should be applied. The data source should update itself by reordering its elements.
Available in OS X v10.5 and later.

DesktopIKImageBrowserViewControlMBS.numberOfGroups as Integer

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No
Returns the number of groups in an image browser view.

Return the number of groups.

This method is optional.
Available in OS X v10.5 and later.

DesktopIKImageBrowserViewControlMBS.numberOfItems as Integer

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No
Returns the number of records managed by the data source object.

Return the number of records managed by the image browser view.

Your data source must implement this method. An IKImageView object uses this method to determine how many cells it should create and display.
Available in OS X v10.5 and later.

DesktopIKImageBrowserViewControlMBS.Opening

Type Topic Version
event ImageKit 21.5

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

DesktopIKImageBrowserViewControlMBS.performDragOperation(sender as NSDraggingInfoMBS) as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No
Invoked after the released image has been removed from the screen, signaling the receiver to import the pasteboard data.

sender: The object sending the message; use it to get details about the dragging operation.

Returns if the destination accepts the data, it returns true; otherwise it returns false. The default is to return false.

For this method to be invoked, the previous prepareForDragOperation message must have returned true. The destination should implement this method to do the real work of importing the pasteboard data represented by the image.

If the sender object's animatesToDestination was set to true in prepareForDragOperation, then setup any animation to arrange space for the drag items to animate to. Also at this time, enumerate through the dragging items to set their destination frames and destination images.

DesktopIKImageBrowserViewControlMBS.prepareForDragOperation(sender as NSDraggingInfoMBS) as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No
Invoked when the image is released, allowing the receiver to agree to or refuse drag operation.

sender: The object sending the message; use it to get details about the dragging operation.

Return true if the receiver agrees to perform the drag operation and false if not.

This method is invoked only if the most recent draggingEntered or draggingUpdated event returned an acceptable drag-operation value.

If you want the drag items to animate from their current location on screen to their final location in your view, set the sender object's animatesToDestination property to true in your implementation of this event.

DesktopIKImageBrowserViewControlMBS.removeItemsAtIndexes(indexes as NSIndexSetMBS)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No
Signals that a remove operation should be applied to the specified items.

indexes: The indexes of the items that should be removed.

This method is optional. It is invoked by the image browser after Image Kit determines that a remove operation should be applied. In response, the data source should update itself by removing the specified items.
Available in OS X v10.5 and later.

DesktopIKImageBrowserViewControlMBS.ScaleFactorChanged(NewFactor as Double)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No
The backing store scale factor has changed.

Please invalidate any cached bitmaps or other relevant state.

DesktopIKImageBrowserViewControlMBS.selectionDidChange

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No
Performs custom tasks when the selection changes.

This method signals that the user changes the selection in the image browser view. You can implement this method if you want to perform custom tasks at that time.
Available in OS X v10.5 and later.

DesktopIKImageBrowserViewControlMBS.updateDraggingItemsForDrag(sender as NSDraggingInfoMBS)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No
Invoked when the dragging images should be changed.

sender: The object sending the message; use this object to get details about the dragging operation.

While a destination may change the dragging images at any time, it is recommended to wait until this method is called before updating the dragging images.

This allows the system to delay changing the dragging images until it is likely that the user will drop on this destination. Otherwise, the dragging images will change too often during the drag which would be distracting to the user.

During enumerateDraggingItemsWithOptions you may set non-acceptable drag items images to nil to hide them or use the enumeration option of NSDraggingItemEnumerationClearNonenumeratedImages If there are items that you hide, then after enumeration, you need to set the numberOfValidItemsForDrop to the number of non-hidden drag items. However, if the valid item count is 0, then it is better to return NSDragOperationNone from your implementation of draggingEntered and, or draggingUpdated instead of hiding all drag items during enumeration.
Available in OS X v10.7 and later.

DesktopIKImageBrowserViewControlMBS.wantsPeriodicDraggingUpdates as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No
Asks the destination object whether it wants to receive periodic draggingUpdated events.

Returns true if the destination wants to receive periodic draggingUpdated messages, false otherwise.

If the destination returns false, these messages are sent only when the mouse moves or a modifier flag changes. Otherwise the destination gets the default behavior, where it receives periodic dragging-updated events even if nothing changes.

DesktopIKImageBrowserViewControlMBS.willShowContextualMenu(menu as NSMenuMBS, NSEvent as NSEventMBS)   New in 24.1

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 24.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.

DesktopIKImageBrowserViewControlMBS.writeItemsAtIndexes(indexes as NSIndexSetMBS, pasteboard as NSPasteboardMBS) as Integer

Type Topic Plugin Version macOS Windows Linux iOS Targets
event ImageKit MBS AVFoundation Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No
Signals that a drag should begin.

itemIndexes: The indexes of the items that should be dragged.
pasteboard: The pasteboard to copy the items to.

Returns the number of items written to the pasteboard.

This method is optional. It is invoked after Image Kit determines that a drag should begin, but before the drag has been started.
Available in OS X v10.5 and later.

The items on this page are in the following plugins: MBS AVFoundation Plugin.


The biggest plugin in space...