DesktopNSSplitViewControlMBS.BoundsChanged

DesktopNSSplitViewControlMBS.canCollapseSubview(subview as NSViewMBS) as Boolean

subview: The subview to collapse.

Returns true if subview collapses when the user drags a divider beyond the halfway mark between its minimum size and its edge; otherwise, false.

The subview expands when the user drags the divider beyond the halfway mark between its minimum size and its edge.

To specify the minimum size, define the constrainMaxCoordinate and constrainMinCoordinate events. A subview can collapse only if you also define constrainMinCoordinate.
A collapsed subview isn’t visible, but the split view object retains it with the same size as before the collapse.
If the events are implemented, the subviews can’t collapse.

DesktopNSSplitViewControlMBS.Closing

DesktopNSSplitViewControlMBS.constrainMaxCoordinate(proposedMaximumPosition as double, dividerIndex as Integer) as Double

proposedMax: The proposed maximum coordinate limit of the subview in the split view’s flipped coordinate system.
dividerIndex: Specifies the divider the user is moving, with the first divider being 0 and increasing from top to bottom (or left to right).

Returns the maximum coordinate limit of the divider.

The delegate receives this message before the split view begins tracking the mouse to position a divider. You can further constrain the limits, but you can’t extend the divider limits.
If the split bars are horizontal (views are one on top of the other), proposedMax is the bottom limit. If the split bars are vertical (views are side by side), proposedMax is the right limit. The initial value of proposedMax is the bottom (or right side) of the subview after the divider.

DesktopNSSplitViewControlMBS.constrainMinCoordinate(proposedMinimumPosition as double, dividerIndex as Integer) as Double

proposedMin: The proposed minimum coordinate limit of the subview in the split view’s flipped coordinate system.
dividerIndex: Specifies the divider the user is moving, with the first divider being 0 and increasing from top to bottom (or left to right).

Returns the minimum coordinate limit of the divider.

The delegate receives this message before the split view begins tracking the cursor to position a divider. You can further constrain the limits, but you can’t extend the divider limits.
If the split bars are horizontal (views are one on top of the other), proposedMin is the top limit. If the split bars are vertical (views are side by side), proposedMin is the left limit. The initial value of proposedMin is the top (or left side) of the subview before the divider.

DesktopNSSplitViewControlMBS.constrainSplitPosition(proposedPosition as double, dividerIndex as Integer) as Double

proposedPosition: The cursor’s current position, and the proposed position of the divider.
dividerIndex: The index of the divider the user is moving, with the first divider being 0 and increasing from top to bottom (or left to right).

Returns the position for constraining the divider.

If the delegate implements this method, the split view calls it repeatedly as the user moves the divider.
If a subview’s height must be a multiple of a certain number, use this method to return the multiple nearest to proposedPosition.

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

DesktopNSSplitViewControlMBS.ContextualMenuItemSelected(selectedItem As DesktopMenuItem) As Boolean

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.

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

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

DesktopNSSplitViewControlMBS.drawDivider(graphics as NSGraphicsMBS, Rect as NSRectMBS) as Boolean

Function drawDivider(graphics as NSGraphicsMBS, Rect as NSRectMBS) Handles drawDivider as Boolean
  
  // draw a red box with blue border
  graphics.setFillColor NSColorMBS.redColor
  graphics.setStrokeColor NSColorMBS.blueColor
  
  Var r As New NSRectMBS(rect.X, rect.y + rect.Height/2 - 5, 10, 10)
  graphics.fillRect r
  graphics.strokeRect r
  
  Return True
End Function

Rect: The entire divider rectangle in the split view’s flipped coordinate system.

If you override this method to use a custom style for the divider, you may need to change the size of the divider.

DesktopNSSplitViewControlMBS.FocusLost

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

DesktopNSSplitViewControlMBS.FocusReceived

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

DesktopNSSplitViewControlMBS.FrameChanged

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

DesktopNSSplitViewControlMBS.MenuBarSelected

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

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.

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

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.

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

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

DesktopNSSplitViewControlMBS.Opening

DesktopNSSplitViewControlMBS.resizeSubviewsWithOldSize(oldSize as NSSizeMBS)

oldSize: The size of the split view before the user resizes it.

If the delegate implements this method, it receives this message after the split view resizes.

Resize the subviews so that the sum of the sizes of the subviews plus the sum of the thickness of the dividers equals the size of the new frame of the NSSplitView. You can get the thickness of a divider through the dividerThickness method.

If you implement this delegate method to resize subviews on your own, the NSSplitViewMBS doesn’t perform any error checking for you. However, you can invoke adjustSubviews() to perform the default sizing behavior.

DesktopNSSplitViewControlMBS.ScaleFactorChanged(NewFactor as double)

Please invalidate any cached bitmaps or other relevant state.

DesktopNSSplitViewControlMBS.shouldAdjustSizeOfSubview(view as NSViewMBS) as Boolean

subview: The subview to resize.

If adjustSubviews() can change the size of the subview, return true; otherwise, false. By returning false, you lock the size of the split view subview while the split view resizes.

Regardless of the value that this method returns, adjustSubviews() may change the origin of the subview. Nonresizable subviews may resize to prevent an invalid subview layout.
If a split view has no delegate, or if its delegate doesn’t respond to this message, the split view behaves as if this method returns true.

DesktopNSSplitViewControlMBS.shouldHideDivider(dividerIndex as Integer) as Boolean

dividerIndex: The zero-based index of the divider.

Return true if the user can drag the divider off the edge of the split view, resulting in it not being visible.

If a split view has no delegate, or if its delegate doesn’t respond to this message, the split view behaves as if it has a delegate that returns false when it receives this message.

DesktopNSSplitViewControlMBS.splitViewDidResizeSubviews

The control invokes this event after the split view resizes two of its subviews in response to the repositioning of a divider.

DesktopNSSplitViewControlMBS.splitViewWillResizeSubviews

The control invokes this method before the split view resizes two of its subviews in response to the repositioning of a divider.

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

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