SearchControl Xojo Plugin

SearchControl Control

LibraryDescription
"A search control which offers some advantages over the built in one."

Note on heights: macOS before Tahoe wants 22 points in height, macOS Tahoe wants 26 points in height, Windows ants 22 points and we suggest 27 points on Linux. Your application will need to implement logic to account for this if you want to perfect the look when cross compiling.

By default it will set the height to 26 if your IDE is on Tahoe, and 27 points if your IDE is on Linux, else 22 points.

RectControl
   SearchControl

control SearchControl

Properties

AccessibilityLabelLabel used by the macOS accessibility manager for various of disability settings and devices.
AccessibilityTitleTitle used by the macOS accessibility manager for various of disability settings and devices.
AllowFocusRingIf True, the SearchField will display a focus ring when it has the focus.
DebugDataSizeUsed for internal quality control of the plugin.
Enabled (Inherited) Determines if the control should be enabled when the owning window is opened.
Handle (Inherited) Returns a handle to the control.
HasCancelButtonIf set to true then the control will have a cancel button on its right side.
HasMenuIf set to true then the left button will host a menu.
Height (Inherited) The height (in points) of the control.
Index (Inherited) If the control is used in a control set, this specifies the control's index in the set.
Left (Inherited) The left side of the control in local coordinates (relative to the window)
MacBorderStyleSets the BorderStyle on mac to Rounded (default) or Square
MenuItemCountReturns the count of menu items.
MouseX (Inherited) The X coordinate of the mouse (points). Measured from the top-left corner of the window.
MouseY (Inherited) The Y coordinate of the mouse (points). Measured from the top-left corner of the window.
PanelIndex (Inherited) If the control has been placed on a TabPanel or PagePanel control, this is the panel (page/tab) that the control is on. If the control is not on a panel, it returns -1.
PlaceHolderTextA property to set or get placeholder which is used to display placeholder text as grey text in the control when it has no search text entered and the control does not have focus.
SendSearchStringImmediatelyIf set to true then search event will be fired right away as text is typed.
SendWholeSearchStringIf set to true then search events are only sent when the user presses enter key or presses the search icon.
TextSets or gets the search text in the control.
Top (Inherited) The top of the control in local coordinates (relative to the window).
Visible (Inherited) Determines whether the control is visible when its owning window is opened. The default is True: the control is visible.
Width (Inherited) The width (in points) of the control.
Window (Inherited) The control's parent window.

Methods

AddMenuItemAdds a MenuItem to the menu in the left icon button.
CancelEventActionTo cancel a events internal action then call this method from within a event.
ClearMenuClears the menu.
Close (Inherited) Closes a control.
MenuItemReturns a MenuItem by a given index
SetFocusSets focus to the control.
SyncMenuSyncs the menu items if you have made changes to menu items after adding them. This is needed for the MacOS X native control.

Events

CancelButtonActionThis event is fired when the cancel button is clicked.
Close (Inherited) The control is about to close.
ConstructContextualMenu (Inherited) This event is called when it is appropriate to display a contextual menu for the control.
ContextualMenuItemSelected (Inherited) Fires when a contextual menuitem selectedItem was selected but the MenuItemSelected event and the MenuHandler for the MenuItem did not handle the menu selection.
DragEnter (Inherited) Fires when the passed DragItem enters the RectControl.
DragExit (Inherited) Fires when the passed DragItem exits the RectControl.
DragOver (Inherited) Fires when the DragItem is over the RectControl.
DropObject (Inherited) The item represented by Obj has been dropped on the control.
GotFocusThis event is fired when the control gets the focus.
HandleSpecialKeyThis event is fired when special key such as Tab or Return is pressed giving you opportunity to do something there instead of default built in functionality.
KeyDown (Inherited) The user has pressed the Key passed while the control has the focus.
KeyUp (Inherited) Fires when the passed Key is released in the control that has the focus.
LostFocusThis event is fired when the control looses the focus.
MenuClickThis event is fire when a MenuItem was clicked in the left button Menu.
MouseDrag (Inherited) The mouse button was pressed inside the control and moved (dragged) at the location local to the control passed in to x, y. The user has moved the mouse inside the control while the mouse button is held down. This event handler receives parameters that indicate where the mouse is in coordinates local to the control.
MouseEnter (Inherited) The mouse has entered the area of the control.
MouseExitThe mouse has left the area of the control.
MouseMoveThe mouse has moved within the control to the coordinates passed. The coordinates are local to the control, not to the window.
MouseWheel (Inherited) The mouse wheel has been moved.
RequestBuddyControlUsed on Windows to manually assign TextField to the control if you’re having embedding issues.
SearchThis event is fired when your application should do search.
TextChangeThis event is fired when the text changes.

Enumerations

SearchControlSpecialKeyEnum that represents special keys that are supported in the HandleSpecialKey event.

Constants

Version = 5.7

Supported Platforms:

  • macOS Intel 64 bit
  • macOS Apple Silicon
  • Windows 32 bit
  • Windows 64 bit
  • Windows ARM 64 bit
  • Linux 32 bit
  • Linux 64 bit
  • Linux ARM 32 bit
  • Linux ARM 64 bit