DesktopNSSearchFieldControlMBS.Action

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	Cocoa Controls	MBS MacCocoa Plugin	21.5	✅ Yes	❌ No	❌ No	❌ No

The action event run, when e.g. return key is pressed.

DesktopNSSearchFieldControlMBS.BoundsChanged

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	Cocoa Controls	MBS MacCocoa Plugin	21.5	✅ Yes	❌ No	❌ No	❌ No

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

DesktopNSSearchFieldControlMBS.Closing

Type	Topic	Version
event	Cocoa Controls	21.5

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

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

Type	Topic	Version
event	Cocoa Controls	22.1

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

DesktopNSSearchFieldControlMBS.ContextualMenuItemSelected(selectedItem As DesktopMenuItem) As Boolean

Type	Topic	Version
event	Cocoa Controls	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.

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

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	Cocoa Controls	MBS MacCocoa 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.

DesktopNSSearchFieldControlMBS.FocusLost

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	Cocoa Controls	MBS MacCocoa 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.

DesktopNSSearchFieldControlMBS.FocusReceived

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	Cocoa Controls	MBS MacCocoa 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.

DesktopNSSearchFieldControlMBS.FrameChanged

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	Cocoa Controls	MBS MacCocoa 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.

DesktopNSSearchFieldControlMBS.MenuBarSelected

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	Cocoa Controls	MBS MacCocoa Plugin	21.5	✅ Yes	❌ No	❌ No	❌ No

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

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

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	Cocoa Controls	MBS MacCocoa 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.

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

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	Cocoa Controls	MBS MacCocoa 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.

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

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	Cocoa Controls	MBS MacCocoa 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.

DesktopNSSearchFieldControlMBS.Opening

Type	Topic	Version
event	Cocoa Controls	21.5

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

DesktopNSSearchFieldControlMBS.ScaleFactorChanged(NewFactor as Double)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	Cocoa Controls	MBS MacCocoa Plugin	21.5	✅ Yes	❌ No	❌ No	❌ No

The backing store scale factor has changed.

Please invalidate any cached bitmaps or other relevant state.

DesktopNSSearchFieldControlMBS.TextDidBeginEditing(fieldEditor as NSTextMBS, notification as NSNotificationMBS)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	Cocoa Controls	MBS MacCocoa Plugin	21.5	✅ Yes	❌ No	❌ No	❌ No

Sent when a control with editable text begins an editing session.

Notification: The notification object. The name of the notification is always NSControlTextDidBeginEditingNotification.

This event is invoked when the user begins editing text in a control such as a text field or a form field. The control posts a NSControlTextDidBeginEditingNotification notification, and if the control's subclass implements this event, it is automatically registered to receive the notification. The field editor is also delivered for inspection.

DesktopNSSearchFieldControlMBS.TextDidChange(fieldEditor as NSTextMBS, notification as NSNotificationMBS)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	Cocoa Controls	MBS MacCocoa Plugin	21.5	✅ Yes	❌ No	❌ No	❌ No

Sent when the text in the receiving control changes.

Notification: The notification object. The name of the notification is always NSControlTextDidChangeNotification.

This event is invoked when text in a control such as a text field or form changes. The control posts a NSControlTextDidChangeNotification notification, and if the control's subclass implements this event, it is automatically registered to receive the notification. The field editor is provided as parameter for inspection.

DesktopNSSearchFieldControlMBS.TextDidEndEditing(fieldEditor as NSTextMBS, notification as NSNotificationMBS)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	Cocoa Controls	MBS MacCocoa Plugin	21.5	✅ Yes	❌ No	❌ No	❌ No

Sent when a control with editable text ends an editing session.

Notification: The notification object. The name of the notification is always NSControlTextDidEndEditingNotification.

This event is invoked when the user stops editing text in a control such as a text field or form. The control posts a NSControlTextDidEndEditingNotification notification, and if the control' subclass implements this event, it is automatically registered to receive the notification. The field editor is also provided for inspection.

DesktopNSSearchFieldControlMBS.textShouldBeginEditing(fieldEditor as NSTextMBS) as boolean

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	Cocoa Controls	MBS MacCocoa Plugin	21.5	✅ Yes	❌ No	❌ No	❌ No

The event called to decide whether text editing should be allowed.

Return true to allow text editing or false to deny.
Be aware that an event in Xojo without return will cause false to be returned.

DesktopNSSearchFieldControlMBS.textShouldEndEditing(fieldEditor as NSTextMBS) as boolean

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	Cocoa Controls	MBS MacCocoa Plugin	21.5	✅ Yes	❌ No	❌ No	❌ No

The event called to decide whether ending text editing should be allowed.

Return true to allow end of text editing or false to deny.
Be aware that an event in Xojo without return will cause false to be returned.

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

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
event	Cocoa Controls	MBS MacCocoa 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.