SearchFilter Pass-Through Attribute Properties

Iron Speed Designer Pass-Through Attributes

These attributes control specific types of controls generated by Iron Speed Designer.  Generally these attributes govern specific portions of code that is generated for your application depending on the selected attributes and their values.

Pass-Through Attribute

Description

AutoTypeAhead

True

Enables the interactive search feature.

False

Disables the interactive search feature.  False is assumed if the AutoTypeAhead pass-through attribute is not present.

AutoTypeAheadDelay

The time, in milliseconds, that must pass before the Automatic Type Ahead feature fetches suggestions from the database.  The value may be any integer greater than 0.

 The default value is “Default” which represents the value specified in the Application Generation Options dialog.  If the pass-through attribute is not present, then “Default” is assumed.

AutoTypeAheadListSize

Specifies the maximum number of suggestions returned from the database by the Automatic Type Ahead feature.

The default value is “Default” which represents the value specified in the Application Generation Options dialog.  If the pass-through attribute is not present then “Default” is assumed.

AutoTypeAheadMatchedStringDisplay

AtBeginningOfMatchedString

Displays strings starting from the word where the search text is found.

InMiddleOfMatchedString

Displays some text before the word where search text is found and some text after the word where search text is found.

AtEndOfMatchedString

Displays the text string upto and including the word where the search text is found.

AutoTypeAheadMinChars

The minimum number of characters that must be entered (typed) into the search control before Automatic Type Ahead can fetch the suggestions from the database.

The default value is “Default” which represents the value specified in the Application Generation Options dialog.  If the pass-through attribute is not present, then “Default” is assumed.

AutoTypeAheadSearch

Determines how to search in the string.

WordsStartingWithSearchString

Search for words beginning with the text entered in the search control’s text box containing words beginning after the separation characters specified in AutoTypeAheadWordSeparationCharacters.

AnyWhereInText

Search for text starting anywhere in the field.

The default value is “WordsStartingWithSearchString”.

AutoTypeAheadWordSeparators

Specifies a regular expression representing non-alphabetic characters that form a word boundary.  AutoTypeAheadWordSeperators works only when the AutoTypeAheadSearch pass-through attribute is “WordsStartingWithSearchString”.

The default value is [^a-zA-Z0-9].  Iron Speed Designer does not validate this string for syntactic correctness, so please be careful when changing the value.

CaseSensitive

Indicates whether the search should be case sensitive.

true

Perform a case-sensitive text search.

false

A case-sensitive search is not performed.

Fields

Specifies the fields to be searched.

Operator

Specifies the type of search operation to apply to the fields.

ASP.NET Control Properties

The ASP.NET controls have a wide variety of properties that can be used to govern the controls’ behaviors.  You can enter any .NET control property into the Attributes tab and Iron Speed Designer will insert them into the generated control tags.

Pass-Through Attribute

Description

Columns

Specifies the screen width, in characters, of a text box.

Note: Use the MaxLength pass-through attribute to specify how many characters can be entered into the text box control.

Applies To

Text Box

Interactive search feature caveats

The width of the suggestion list box is governed by Columns pass-through attribute for the SearchArea text box.  The default value is 50 characters.

When interactive search is enabled (AutoTypeAhead is ‘True’) and the SearchArea control’s operator is set to “EqualsTo”, the feature attempts to find records whose values start with the typed text.

When interactive search is disabled and the SearchArea control’s operator is set to “EqualsTo” (Operator is ‘EqualsTo’), the feature attempt to find records where the data is equal to the typed text.

When search text is typed into a search control, the interactive search feature returns a list of suggestions.  The suggestion item’s length may not be equal to the length specified by ‘Columns’ pass-through attribute if the suggestion item contains new line.  If a suggested item contains new-line characters before the search text then it displays text after new line.  If it contains a new-line after the search text then the text is displayed upto the new line.

For URL fields, the interactive search works only if the complete string ‘http://’ is typed or if the URL is typed without ‘http://’.

See also

Pass-Through Attributes

SearchFilter Tag