Xojo Conferences
XDCMay2019MiamiUSA

Platforms to show: All Mac Windows Linux Cross-Platform

Next items

CustomNSScrollerMBS.acceptsFirstMouse(e as NSEventMBS) as boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Cocoa Controls MBS MacControls Plugin 12.5 Yes No No No No
Function: Overridden by subclasses to return true if the receiver should be sent a mouseDown event for an initial mouse-down event, false if not.
Notes:
The receiver can either return a value unconditionally or use the location of event e to determine whether or not it wants the event. The default implementation ignores the event and returns false.

Implement this event in a subclass to allow instances to respond to click-through. This allows the user to click on a view in an inactive window, activating the view with one click, instead of clicking first to make the window active and then clicking the view. Most view objects refuse a click-through attempt, so the event simply activates the window. Many control objects, however, such as instances of NSButton and NSSlider, do accept them, so the user can immediately manipulate the control without having to release the mouse button.

Feedback, Comments & Corrections

CustomNSScrollerMBS.acceptsFirstResponder as boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Cocoa Controls MBS MacControls Plugin 12.1 Yes No No No No
Function: Whether to accept first responder.
Notes: Return true if your control can have the focus and false if not.

Feedback, Comments & Corrections

CustomNSScrollerMBS.becomeFirstResponder as boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Cocoa Controls MBS MacControls Plugin 12.1 Yes No No No No
Function: Called when the object gets focus.
Notes: Return true to accept.

Feedback, Comments & Corrections

CustomNSScrollerMBS.beginGestureWithEvent(e as NSEventMBS) as boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Cocoa Controls MBS MacControls Plugin 12.1 Yes No No No No
Function: Informs the receiver that the user has begun a touch gesture.
Notes:
e: An event object representing the gesture beginning.
The event will be sent to the view under the touch in the key window.
Available in Mac OS X v10.6 and later.
Return true if you handled this event.

Feedback, Comments & Corrections

CustomNSScrollerMBS.canBecomeKeyView as boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Cocoa Controls MBS MacControls Plugin 12.5 Yes No No No No
Function: Returns whether the receiver can become key view.
Notes: Returns true if the receiver can become key view, false otherwise.

Feedback, Comments & Corrections

CustomNSScrollerMBS.Close
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Cocoa Controls MBS MacControls Plugin 12.1 Yes No No No No
Function: The event called when the custom view is destroyed.

Feedback, Comments & Corrections

CustomNSScrollerMBS.concludeDragOperation(sender as NSDraggingInfoMBS)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Cocoa Controls MBS MacControls Plugin 13.1 Yes No No No No
Function: Invoked when the dragging operation is complete, signaling the receiver to perform any necessary clean-up.
Notes:
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.

Feedback, Comments & Corrections

CustomNSScrollerMBS.draggingEnded(sender as NSDraggingInfoMBS)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Cocoa Controls MBS MacControls Plugin 13.1 Yes No No No No
Function: Implement this event to be notified when a drag operation ends in some other destination.
Notes:
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.

Feedback, Comments & Corrections

CustomNSScrollerMBS.draggingEntered(sender as NSDraggingInfoMBS) as Integer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Cocoa Controls MBS MacControls Plugin 13.1 Yes No No No No
Function: Invoked when the dragged image enters destination bounds or frame; delegate returns dragging operation to perform.
Notes:
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.

Feedback, Comments & Corrections

CustomNSScrollerMBS.draggingExited(sender as NSDraggingInfoMBS)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Cocoa Controls MBS MacControls Plugin 13.1 Yes No No No No
Function: 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).
Notes: sender: The object sending the message; use it to get details about the dragging operation.

Feedback, Comments & Corrections

CustomNSScrollerMBS.draggingSessionEndedAtPoint(session as NSDraggingSessionMBS, screenPoint as NSPointMBS, operation as Integer)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Cocoa Controls MBS MacControls Plugin 13.1 Yes No No No No
Function: Invoked when the dragging session has completed.
Notes:
session: The dragging session.
screenPoint: The point where the drag ended, in screen coordinates.
operation: The drag operation. See constants for drag operation types.

Available in OS X v10.7 and later.

Feedback, Comments & Corrections

CustomNSScrollerMBS.draggingSessionMovedToPoint(session as NSDraggingSessionMBS, screenPoint as NSPointMBS)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Cocoa Controls MBS MacControls Plugin 13.1 Yes No No No No
Function: Invoked when the drag moves on the screen.
Notes:
session: The dragging session.
screenPoint: The point where the drag moved to, in screen coordinates.

Available in OS X v10.7 and later.

Feedback, Comments & Corrections

CustomNSScrollerMBS.draggingSessionSourceOperationMaskForDraggingContext(session as NSDraggingSessionMBS, context as Integer) as Integer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Cocoa Controls MBS MacControls Plugin 13.1 Yes No No No No
Function: Declares the types of operations the source allows to be performed. (required)
Notes:
session: The dragging session.
context: The dragging context. See NSDraggingContext constants for the supported values.

Return the appropriate dragging operation as defined in constants.

In the future Apple may provide more specific "within" values in the future. To account for this, for unrecognized localities, return the operation mask for the most specific context that you are concerned with.

Feedback, Comments & Corrections

CustomNSScrollerMBS.draggingSessionWillBeginAtPoint(session as NSDraggingSessionMBS, screenPoint as NSPointMBS)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Cocoa Controls MBS MacControls Plugin 13.1 Yes No No No No
Function: Invoked when the drag will begin.
Notes:
session: The dragging session.
screenPoint: The point where the drag will begin, in screen coordinates.

Available in OS X v10.7 and later.

Feedback, Comments & Corrections

CustomNSScrollerMBS.draggingSourceOperationMaskForLocal(flag as boolean) as Integer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Cocoa Controls MBS MacControls Plugin 13.5 Yes No No No No
Function: Returns an integer bit mask indicating the types of dragging operations the source object will allow to be performed on the dragged image's data.
Notes:
(Deprecated in OS X v10.7. This method is informally deprecated. It is only called if the source does not implement the NSDraggingSource protocol methods. This method will be formally deprecated in a future OS release.)

isLocal: True indicates that the candidate destination object (the window or view over which the dragged image is currently poised) is in the same application as the source, while a false value indicates that the destination object is in a different application.

A mask, created by combining the dragging operations listed in the NSDragOperation section of NSDraggingInfo protocol reference using the C bitwise OR operator.If the source does not permit any dragging operations, it should return NSDragOperationNone.

If not implemented, the default value is NSDragOperationCopy | NSDragOperationLink | NSDragOperationGeneric | NSDragOperationPrivate.

Available in OS X v10.0 and later. Deprecated in OS X v10.7.

Feedback, Comments & Corrections

CustomNSScrollerMBS.draggingUpdated(sender as NSDraggingInfoMBS) as Integer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Cocoa Controls MBS MacControls Plugin 13.1 Yes No No No No
Function: Invoked periodically as the image is held within the destination area, allowing modification of the dragging operation or mouse-pointer position.
Notes:
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.

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.

Feedback, Comments & Corrections

CustomNSScrollerMBS.drawArrow(g as NSGraphicsMBS, Arrow as Integer, highlight as boolean)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Cocoa Controls MBS MacControls Plugin 12.1 Yes No No No No
Function: Called when arrow need to be drawn.
Notes:
Draw the scroll button indicated by arrow, which is either NSScrollerIncrementArrow (the down or right scroll button) or NSScrollerDecrementArrow (up or left).
If flag is true, the button is drawn highlighted; otherwise it's drawn normally. You should never need to invoke this method directly, but may wish to override it to customize the appearance of scroll buttons.

Feedback, Comments & Corrections

CustomNSScrollerMBS.drawKnob(g as NSGraphicsMBS)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Cocoa Controls MBS MacControls Plugin 12.1 Yes No No No No
Function: Draw the knob.

Feedback, Comments & Corrections

CustomNSScrollerMBS.drawKnobSlotInRect(g as NSGraphicsMBS, slotRect as NSRectMBS, highlight as boolean)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Cocoa Controls MBS MacControls Plugin 12.1 Yes No No No No
Function: Draw the knob slow in the rectangle.

Feedback, Comments & Corrections

CustomNSScrollerMBS.drawParts(g as NSGraphicsMBS)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Cocoa Controls MBS MacControls Plugin 12.1 Yes No No No No
Function: Called when parts need to be drawn.

Feedback, Comments & Corrections

CustomNSScrollerMBS.endGestureWithEvent(e as NSEventMBS) as boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Cocoa Controls MBS MacControls Plugin 12.1 Yes No No No No
Function: Informs the receiver that the user has ended a touch gesture.
Notes:
e: An event object representing the gesture end.
Available in Mac OS X v10.6 and later.
Return true if you handled this event.

Feedback, Comments & Corrections

CustomNSScrollerMBS.ignoreModifierKeysForDraggingSession(session as NSDraggingSessionMBS) as boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Cocoa Controls MBS MacControls Plugin 13.1 Yes No No No No
Function: Returns whether the modifier keys will be ignored for this dragging session.
Notes:
session: The dragging session.

Return true if the modifier keys will be ignored, false otherwise.
Available in OS X v10.7 and later.

Feedback, Comments & Corrections

CustomNSScrollerMBS.isOpaque as boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Cocoa Controls MBS MacControls Plugin 12.1 Yes No No No No
Function: Whether this view is opaque.

Feedback, Comments & Corrections

CustomNSScrollerMBS.keyDown(e as NSEventMBS) as boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Cocoa Controls MBS MacControls Plugin 12.1 Yes No No No No
Function: One of the key events.
Notes: Return true if you handled this event.

Feedback, Comments & Corrections

CustomNSScrollerMBS.keyUp(e as NSEventMBS) as boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Cocoa Controls MBS MacControls Plugin 12.1 Yes No No No No
Function: One of the key events.
Notes: Return true if you handled this event.

Feedback, Comments & Corrections

CustomNSScrollerMBS.magnifyWithEvent(e as NSEventMBS) as boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Cocoa Controls MBS MacControls Plugin 12.1 Yes No No No No
Function: Informs the receiver that the user has begun a pinch gesture.
Notes:
e: An event object representing the magnify gesture.
The event will be sent to the view under the touch in the key window.
Available in Mac OS X v10.6 and later.
Return true if you handled this event.

Feedback, Comments & Corrections

CustomNSScrollerMBS.menuForEvent(e as NSEventMBS, defaultMenu as NSMenuMBS) as NSMenuMBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Cocoa Controls MBS MacControls Plugin 12.3 Yes No No No No
Function: Overridden by subclasses to return a context-sensitive pop-up menu for a given mouse-down event.
Notes:
theEvent: An object representing a mouse-down event.
defaultMenu: The menu as constructed by super class.

The receiver can use information in the mouse event, such as its location over a particular element of the receiver, to determine what kind of menu to return. For example, a text object might display a text-editing menu when the cursor lies over text and a menu for changing graphics attributes when the cursor lies over an embedded image.

The default implementation returns the default menu.

Feedback, Comments & Corrections

CustomNSScrollerMBS.mouseDown(e as NSEventMBS, x as Double, y as Double) as boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Cocoa Controls MBS MacControls Plugin 12.1 Yes No No No No
Function: One of the mouse events.
Notes: Return true if you handled this event.

Feedback, Comments & Corrections

CustomNSScrollerMBS.mouseDownCanMoveWindow as boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Cocoa Controls MBS MacControls Plugin 12.5 Yes No No No No
Function: This event is called so you can decide what happens with mouse down.
Notes:
Return true if you do not need to handle a mouse down and it can pass through to superviews; False if you need to handle the mouse down.

This allows iApp-type applications to determine the region by which a window can be moved. By default, this method returns false if the view is opaque; otherwise, it returns true. Subclasses can override this method to return a different value.

Feedback, Comments & Corrections

Next items

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




Links
MBS FileMaker tutorial videos