In addition to the Pre-defined Filter Control Components, designers can also add any number of Generic Filter Control Components to a Pollstar100 Application. Since Filter Controls act upon columns of Sample Data, it is likely that a designer wishing to provide Generic Panels for displaying additional custom-defined Sample Data fields, may also want to provide associated Filter Controls as well.
Generic Filter Control Components enable the end-user to enter a pattern string that must be matched in the Sample Data field corresponding to the associated Generic Text Panel or Generic Dates Panel, for all Sample Data records returned to the client.
For Sample Data fields containing text data; default, case insensitive filtering is employed via the preg_match PHP function. Details concerning the valid syntax of preg_match pattern strings can be found at http://uk2.php.net/manual/en/reference.pcre.pattern.syntax.php. Designers can override the default filtering method by changing the field data type of the Generic Text Panel corresponding to the Sample Data field. This table describes the types of filtering that are available for each available sample field data type definition:
Custom XML Tag
Use the following XML tag to define a Generic Filter Control Component within your Custom XML file:
|
Common Properties
Generic Filter Control Components inherit the following common Filter Control Properties:
Component Visibility Properties
Location Properties
Margins Properties
Text Properties
Image Properties
Opacity Properties
Specialised Properties
Generic Filter Control Components inherit the following specialised Properties:
Unique ID
Use this Property to assign a unique identifier to the generic Component.
Sample Field ID
Use this Property to associate the generic Component with a specific column of Sample Data.
Default Property Values
The following default Property values are defined for Generic Filter Control Components:
|
Property Name
|
Default Value
|
|
Visible
|
true
|
|
X
|
undefined
|
|
Y
|
undefined
|
|
Width
|
undefined
|
|
Height
|
undefined
|
|
Margins
|
0, 0, 0, 0
|
|
Text
|
enter filter >>
|
|
TextFont
|
Times New Roman
|
|
TextAlign
|
left
|
|
TextColour
|
0
|
|
TextSize
|
12
|
|
TextItalic
|
false
|
|
TextBold
|
false
|
|
TextUnderline
|
false
|
|
TextBorder
|
false
|
|
Image
|
default
|
|
Opacity
|
100
|
|
BorderRadius
|
0
|
|
BorderColour
|
0
|
|
BorderWeight
|
0
|
|
Colours
|
undefined
|
|
UniqueID
|
undefined
|
|
SampleFieldID
|
undefined
|
Related Topics
Cookie Related Properties
