NSSearchFieldMBS.Constructor

dim t as new NSSearchFieldMBS

On success the handle property is not zero.

See also:

• Constructor(Handle as Integer)
• Constructor(left as Double, top as Double, width as Double, height as Double)

NSSearchFieldMBS.Constructor(Handle as Integer)

dim t as new NSSearchFieldMBS(0, 0, 100, 100)
dim v as new NSSearchFieldMBS(t.handle)

MsgBox str(v.Bounds.Width)+" x "+str(v.Bounds.Height)

The handle is casted to a NSSearchField and the plugin retains this handle.

See also:

• Constructor
• Constructor(left as Double, top as Double, width as Double, height as Double)

NSSearchFieldMBS.Constructor(left as Double, top as Double, width as Double, height as Double)

dim x as new NSSearchFieldMBS(0, 0, 100, 100)

On success the handle property is not zero.

See also:

• Constructor
• Constructor(Handle as Integer)

NSSearchFieldMBS.maximumRecents as Integer

The maximum number of search strings that can appear in the menu. This value can be between 0 and 254. Specifying a value less than 0 sets the value to the default, which is 10. Specifying a value greater than 254 sets the maximum to 254.

When the limit is exceeded, the oldest search string on the menu is dropped.
(Read and Write computed property)

NSSearchFieldMBS.recentsAutosaveName as string

The autosave name, which is used as a key in the standard user defaults to save the recent searches. The default value is "", which causes searches not to be autosaved.
(Read and Write computed property)

NSSearchFieldMBS.recentSearches as string()

An array of strings, each of which contains a search string either displayed in the search menu or from a recent autosave archive. If there have been no recent searches and no prior searches saved under an autosave name, this array may be empty.

NSSearchFieldMBS.searchMenuTemplate as NSMenuMBS

The receiver looks for the tag constants described in Menu tags to determine how to populate the menu with items related to recent searches. (See constants)

To modify the actual menu shown, please use NSMenuItemMBS.validateMenuItem event. There you can for example set the state of the menu item shown. The SearchField makes a copy of the NSMenuItem, so the menuitem where the event is called, is not the one shown. It's the one passes as parameter.
(Read and Write computed property)

NSSearchFieldMBS.sendsSearchStringImmediately as boolean

True to send the cell's action immediately upon notification of any changes to the search field; otherwise, false if you want the cell to pause briefly before sending its action message. Pausing gives the user the opportunity to type more text into the search field before initiating the search.
(Read and Write computed property)

NSSearchFieldMBS.sendsWholeSearchString as boolean

True to send the action message all at once when the user clicks the search button or presses return; otherwise, False to send the search string after each keystroke.
(Read and Write computed property)

NSSearchFieldMBS.setRecentSearches(values() as string)

You might use this method to set the recent list of searches from an archived copy.