Xojo Developer Conference
25/27th April 2018 in Denver.
MBS Xojo Conference
6/7th September 2018 in Munich, Germany.

Platforms to show: All Mac Windows Linux Cross-Platform

Previous items Next items

NSWindowMBS.mergeAllWindows
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 16.5 Yes No No Yes, macOS only No
Function: Merges all windows into one window.
Example:
dim n as NSWindowMBS = window1.NSWindowMBS
n.mergeAllWindows
Notes: Raises an exception when used on OS X 10.11 and older.

Feedback, Comments & Corrections

NSWindowMBS.miniaturize
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 8.4 Yes No No Yes, macOS only No
Function: This action method removes the receiver from the screen list and displays the minimized window in the Dock.

Feedback, Comments & Corrections

NSWindowMBS.moveTabToNewWindow
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 16.5 Yes No No Yes, macOS only No
Function: Moves current tab to a new window.
Example:
dim n as NSWindowMBS = window1.NSWindowMBS
n.moveTabToNewWindow
Notes: Raises an exception when used on OS X 10.11 and older.

Feedback, Comments & Corrections

NSWindowMBS.orderBack
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 9.6 Yes No No Yes, macOS only No
Function: Moves the window to the back of its level in the screen list, without changing either the key window or the main window.

Feedback, Comments & Corrections

NSWindowMBS.orderFront
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 9.6 Yes No No Yes, macOS only No
Function: Moves the window to the front of its level in the screen list, without changing either the key window or the main window.

Feedback, Comments & Corrections

NSWindowMBS.orderFrontRegardless
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 9.6 Yes No No Yes, macOS only No
Function: Moves the window to the front of its level, even if its application isn't active, without changing either the key window or the main window.
Notes:
Normally an NSWindow object can't be moved in front of the key window unless it and the key window are in the same application. You should rarely need to invoke this method; it's designed to be used when applications are cooperating in such a way that an active application (with the key window) is using another application to display data.

Available in Mac OS X v10.0 and later.

Feedback, Comments & Corrections

NSWindowMBS.orderOut
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 11.3 Yes No No Yes, macOS only No
Function: Removes the window from the screen list, which hides the window.
Notes:
More or less the same as Real Studio's hide command on the window class.

If the window is the key or main window, the NSWindow object immediately behind it is made key or main in its place. Calling the orderOut method causes the window to be removed from the screen, but does not cause it to be released. See the close method for information on when a window is released.

The default animation based on the window type will be used when the window is ordered out unless it has been modified by the setAnimationBehavior method.

Feedback, Comments & Corrections

NSWindowMBS.PerformClose
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 8.2 Yes No No Yes, macOS only No
Function: This action method simulates the user clicking the close button by momentarily highlighting the button and then closing the window.
Notes:
Same as if the user clicks the close button.
So if the button is disabled or closing is not permitted by the window, it will do nothing.

Feedback, Comments & Corrections

NSWindowMBS.performMiniaturize
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 8.4 Yes No No Yes, macOS only No
Function: This action method simulates the user clicking the minimize button by momentarily highlighting the button, then minimizing the window.
Notes: If the receiver doesn't have a minimize button or can't be minimized for some reason, the system emits the alert sound.

Feedback, Comments & Corrections

NSWindowMBS.performZoom
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 8.4 Yes No No Yes, macOS only No
Function: This action method simulates the user clicking the zoom box by momentarily highlighting the button and then zooming the window.
Notes: If the receiver doesn't have a zoom box or can't be zoomed for some reason, the computer beeps.

Feedback, Comments & Corrections

NSWindowMBS.print
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 9.6 Yes No No Yes, macOS only No
Function: This action method runs the Print panel, and if the user chooses an option other than canceling, prints the window (its frame view and all subviews).

Feedback, Comments & Corrections

NSWindowMBS.registerForDraggedTypes(Types() as string)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 11.1 Yes No No Yes, macOS only No
Function: Registers a give set of pasteboard types as the pasteboard types the window will accept as the destination of an image-dragging session.
Notes:
Types: An array of the pasteboard types the window will accept as the destination of an image-dragging session.

Registering an NSWindow object for dragged types automatically makes it a candidate destination object for a dragging session. NSWindow has a default implementation for many of the methods in the NSDraggingDestination informal protocol. The default implementation forwards each message to the delegate if the delegate responds to the selector of the message. The messages forwarded this way are draggingEntered:, draggingUpdated:, draggingExited:, prepareForDragOperation:, performDragOperation:, and concludeDragOperation:.

Real Studio with Cocoa target implements the methods listed above. So this method is useful to change the allowed types for the case the framework has a bug.

Feedback, Comments & Corrections

NSWindowMBS.removeChildWindow(win as NSWindowMBS)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 11.2 Yes No No Yes, macOS only No
Function: Detaches a given child window from the window.
Notes: win: The child window to detach.

See also:

Feedback, Comments & Corrections

NSWindowMBS.removeChildWindow(win as window)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 11.2 Yes No No No No
Function: Detaches a given child window from the window.
Notes: win: The child window to detach.

See also:

Feedback, Comments & Corrections

NSWindowMBS.resetCursorRects
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 9.6 Yes No No Yes, macOS only No
Function: Clears the window's cursor rectangles and the cursor rectangles of the NSView objects in its view hierarchy.
Notes:
Invokes discardCursorRects to clear the window's cursor rectangles, then sends resetCursorRects to every NSView object in the window's view hierarchy.

This method is typically invoked by the NSApplication object when it detects that the key window's cursor rectangles are invalid. In program code, it's more efficient to invoke invalidateCursorRectsForView.

Feedback, Comments & Corrections

NSWindowMBS.resignKeyWindow
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 9.6 Yes No No Yes, macOS only No
Function: Invoked automatically when the window resigns key window status; never invoke this method directly.
Notes: This method sends resignKeyWindow to the window's first responder, sends windowDidResignKey to the window's delegate, and posts an NSWindowDidResignKeyNotification to the default notification center.

Feedback, Comments & Corrections

NSWindowMBS.resignMainWindow
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 9.6 Yes No No Yes, macOS only No
Function: Invoked automatically when the window resigns main window status; never invoke this method directly.
Notes: This method sends windowDidResignMain to the window's delegate and posts an NSWindowDidResignMainNotification to the default notification center.

Feedback, Comments & Corrections

NSWindowMBS.resizeFlags as Integer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 9.6 Yes No No Yes, macOS only No
Function: Returns the flags field of the event record for the mouse-down event that initiated the resizing session.
Notes:
A mask indicating which of the modifier keys was held down when the mouse-down event occurred. The flags are listed in NSEvent object's modifierFlags method description.

This method is valid only while the window is being resized

You can use this method to constrain the direction or amount of resizing. Because of its limited validity, this method should only be invoked from within an implementation of the delegate method windowWillResize.

Feedback, Comments & Corrections

NSWindowMBS.restoreCachedImage
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 9.6 Yes No No Yes, macOS only No
Function: Splices the window's cached image rectangles, if any, back into its raster image (and buffer if it has one), undoing the effect of any drawing performed within those areas since they were established using cacheImageInRect.
Notes: You must invoke flushWindow after this method to guarantee proper redisplay. An NSWindow object automatically discards its cached image rectangles when it displays.

Feedback, Comments & Corrections

NSWindowMBS.runToolbarCustomizationPalette
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 11.3 Yes No No Yes, macOS only No
Function: The action method for the "Customize Toolbar..." menu item.

Feedback, Comments & Corrections

NSWindowMBS.saveFrameUsingName(s as String)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 15.2 Yes No No Yes, macOS only No
Function: Saves the window's frame rectangle in the user defaults system under a given name.
Notes: With the companion method setFrameUsingName, you can save and reset an NSWindow object's frame over various launches of an application. The default is owned by the application and stored under the name "NSWindow Frame frameName". See NSUserDefaults for more information.

Feedback, Comments & Corrections

NSWindowMBS.selectKeyViewFollowingView(view as NSViewMBS)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 11.2 Yes No No Yes, macOS only No
Function: Makes key the view that follows the given view.
Notes: Sends the nextValidKeyView message to referenceView and, if that message returns an NSView object, invokes makeFirstResponder with the returned object.

Feedback, Comments & Corrections

NSWindowMBS.selectKeyViewPrecedingView(view as NSViewMBS)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 9.6 Yes No No Yes, macOS only No
Function: Makes key the view that follows the given view.
Notes: Sends the nextValidKeyView message to referenceView and, if that message returns an NSView object, invokes makeFirstResponder with the returned object.

Feedback, Comments & Corrections

NSWindowMBS.selectNextKeyView
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 9.6 Yes No No Yes, macOS only No
Function: This action method searches for a candidate next key view and, if it finds one, invokes makeFirstResponder to establish it as the first responder.
Notes:
The candidate is one of the following (searched for in this order):

  • The current first responder's next valid key view, as returned by the nextValidKeyView method of NSView
  • The object designated as the window's initial first responder (using setInitialFirstResponder) if it returns true to an acceptsFirstResponder message
  • Otherwise, the initial first responder's next valid key view, which may end up being nil

Feedback, Comments & Corrections

NSWindowMBS.selectNextTab
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 16.5 Yes No No Yes, macOS only No
Function: Selects next tab.
Example:
dim n as NSWindowMBS = window1.NSWindowMBS
n.selectNextTab
Notes: Raises an exception when used on OS X 10.11 and older.

Feedback, Comments & Corrections

NSWindowMBS.selectPreviousKeyView
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 9.6 Yes No No Yes, macOS only No
Function: This action method searches for a candidate previous key view and, if it finds one, invokes makeFirstResponder to establish it as the first responder.
Notes:
The candidate is one of the following (searched for in this order):

  • The current first responder's previous valid key view, as returned by the previousValidKeyView method of NSView
  • The object designated as the window's initial first responder (using setInitialFirstResponder) if it returns true to an acceptsFirstResponder message
  • Otherwise, the initial first responder's previous valid key view, which may end up being nil

Feedback, Comments & Corrections

NSWindowMBS.selectPreviousTab
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 16.5 Yes No No Yes, macOS only No
Function: Selects previous tab.
Example:
dim n as NSWindowMBS = window1.NSWindowMBS
n.selectPreviousTab
Notes: Raises an exception when used on OS X 10.11 and older.

Feedback, Comments & Corrections

NSWindowMBS.sendEvent(e as NSEventMBS)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 9.6 Yes No No Yes, macOS only No
Function: This action method dispatches mouse and keyboard events sent to the window by the NSApplication object.
Notes: Never invoke this method directly. A right mouse-down event in a window of an inactive application is not delivered to the corresponding NSWindow object. It is instead delivered to the NSApplication object through a sendEvent: message with a window number of 0.

Feedback, Comments & Corrections

NSWindowMBS.setAutorecalculatesContentBorderThickness(flag as boolean, edge as Integer)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 11.1 Yes No No Yes, macOS only No
Function: Specifies whether the window calculates the thickness of a given border automatically.
Notes:
flag: If true, the window calculates the thickness of the edge automatically; if false, it does not.

edge: The border whose thickness auto-recalculation status to set:

NSMaxYEdge: Top border.
NSMinYEdge: Bottom border.

Special Considerations
Turning off a border's auto-recalculation status sets its border thickness to 0.0.

In a non-textured window calling setAutorecalculatesContentBorderThickness passing NSMaxYEdge will raise an exception. It is only valid to set the content border thickness of the top edge in a textured window.

Requires Mac OS X 10.5.

Feedback, Comments & Corrections

NSWindowMBS.setBottomCornerRounded(flag as boolean)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Cocoa MBS MacBase Plugin 11.2 Yes No No Yes, macOS only No
Function: Sets the bottom corner to be round.
Notes: This is an undocumented function in the NSWindow class.

Feedback, Comments & Corrections

Previous items Next items

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




Links
MBS FileMaker Plugins