@...COMBOSEARCHBOX \/ DEFINE COMBOSEARCHBOX

Define a Combined Search Box Control

Syntax:

 @ <nRow> ,<nCol> COMBOSEARCHBOX <ControlName>
    [ OF | PARENT <ParentWindowName> ]
    [ HEIGHT <nHeight> ]
    [ WIDTH <nWidth> ]
    [ VALUE <nValue> ]
    [ FONT <cFontName> SIZE <nFontSize> ]
    [ BOLD ] [ ITALIC ] [ UNDERLINE ] [ STRIKEOUT ]
    [ TOOLTIP <cToolTipText> ]
    [ BACKCOLOR <aBackColor> ]
    [ FONTCOLOR <aFontColor> ]
    [ MAXLENGTH <nInputLength> ]
    [ UPPERCASE | LOWERCASE ]
    [ ON GOTFOCUS <OnGotFocusProcedur> | <bBlock> ]
    [ ON LOSTFOCUS <OnLostFocusProcedure> | <bBlock> ]
    [ ON ENTER <OnEnterProcedure> | <bBlock> ]
    [ RIGHTALIGN ]
    [ NOTABSTOP ]
    [ HELPID <nHelpId> ]
    [ ITEMS <aItems> ] // the aItems array MUST be sorted
    [ ANYWHERESEARCH ]
    [ DROPHEIGHT <nDropHeight> ]
    [ ADDITIVE <lAdditive> ]
    [ ROWOFFSET <nRowOffset> ]
    [ COLOFFSET <nColOffset> ]

Alternative Syntax:

DEFINE COMBOSEARCHBOX <Controlname>
   <PropertyName> <PropertyValue>
   <EventName> <EventProcedure> | <bBlock>
END COMBOSEARCHBOX

Properties:

• Row

• Col

• Height

• Width

• Value

• Items

• FontName

• FontSize

• FontItalic

• FontUnderline

• FontStrikeout

• ToolTip

• BackColor

• FontColor

• CaretPos

• Name (R)

• TabStop (D)

• Parent (D)

• Numeric (D)

• MaxLength (D)

• UpperCase (D)

• LowerCase (D)

• RightAlign (D)

• HelpId (D)

• AnyWhereSearch(D)

• DropHeight (D)

• Additive (D)

• RowOffset (D)

• ColOffset (D)

D: Available at control definition only

R: Read-Only

• Events:

  • OnGotFocus

  • OnChange

  • OnLostFocus

  • OnEnter

• Methods:

  • Show

  • Hide

  • SetFocus

  • Release

  • Refresh

  • Save

• Caution:

  • The user can't have 'on change' procedure block for this box, since this event is handled internally.

  • Enabling Anywheresearch would search inside the string anywhere instead from the first character.

  • DropHeight specifies the maximum dropdown height of the ComboSearchBox.

  • The aItems array MUST be sorted.

  • Additive option can be used to retain the entered text by the user even if the item is not available in the aItems. This will be useful, if you want to add the item to the list. Default value is .f.

  • RowOffset and ColOffset values can be used to fix the ComboSearchBox placement in Panel Windows and windows with nocaptions or themed. RowOffset\/ColOffset can be positive or negative to move the combosearchbox to be shown. Please see the sample for details.

Authors:

Started by Bicahi Esgici <[email protected]>

Enhanced by S.Rathinagiri <[email protected]>

Revised by Grigory Filatov <[email protected]>