Filter

Grid and list filter search fields are available as of BR! 4.3.

A new field type is defined (similar to SEARCH):

RINPUT FIELDS "nn,nn,15/FILTER 10,leading-attributes,row,col,grid column to search [, filter-type] [, CASE]": string-value

For example:

RINPUT FIELDS "4,50,15/FILTER 10,,10,10,2,ALL": Findfield$

Parameters

nn and nn are the row and column to position the field on the screen.

Size/ and Characters signifies how large the filter field will be in columns, and how many characters can be entered into it. In the example, 15/ and 10 provide a 15 column field where the operator can enter 10 characters.

Leading attributes can be any attributes desired (optional).

Row and col are the starting row and column of the grid or list you wish to search.

Grid column to search is the number of the grid column the filter will test against. See tip below.

Filter Types

• LEADING - Filter searching is done left justified using only leading characters (default).
• WORD - Each word is leading matched.
• ALL - The entire string is searched for a match (similar to POS).

CASE may optionally be used to make all searching case sensitive. Case insensitivity is the default.

String-value is the variable name which will apply to whatever the operator enters into the field for searching.

For both FILTER and SEARCH, the up and down arrows now affect only the selection bar in the grid/list being presented.

Tip

To make all items in the list or grid searchable with the filter, a programmer may wish to add a 'secret' undisplayed column which contains all the information from each row, then by designating this column in the FILTER syntax, the operator will be able to search all the information at once.