Control Architect Help Documentation
×
Menu
Index

List View Filtering

 
 
List View Filtering
 
Generally a ListView type view element supports advanced filtering expressions using the wild card character set "!, *, ?".
 
Using these special filtering characters allows you to filter the data to a particular subset.
 

Examples

 
Wildcards are represented by "*" or "?", where "*" matches multiple characters and "?" matches only a single character.  The special character "!" negates the result of the text search.  You can also use the "|" pipe character to form a logical OR condition.  For example, let's assume the DataView has the following items.
 
Note:
Character range search is also supported using the bracket grouping as in "2F[CF]" where the range group "[CF]" specifies to find either of the characters 'C' or 'F' in the 3rd character position.  The characters specified in the range are not case sensitive.
 
2FC100
2FC200
2LC120
2FY200FC
LOG2345MP
LOG2345
MP2345LOG
 
The following filters will produce the following results.
 
Command
Filter
Result
FC
Will return 2FC100,2FC200,2FY200FC
!FC
Will return LOG2345MP,LOG2345,MP2345LOG
!LOG
Will return 2FC100,2FC200,2FY200FC
*MP
Will return LOG2345MP
MP*LOG
Will return MP2345LOG
?FC???
Will return 2FC100,2FC200
LOG*
Will return LOG2345MP,LOG2345
!LOG*
Will return 2FC100,2FC200,2FY200FC,MP2345LOG
?F[CF]
Will return 2FC100, 2FF100, 9FF100, but will not return 2FT100
?L|?F
Will return any tags that have either the character 'L' OR 'F' in the second character position {2FC100,2FC200,2LC120}
 
 
Notes
  • When using wildcards, it is possible to use multiple wildcards within the same token.
  • The * character matches one or more characters in the position of the string value being searched. 
  • The ! negation character can only be used as the first character in your filter text value.
 
1

Search Text: edit

1. Search Text: edit
Specify the filter text to apply to the selected data column.
 
2

Search Options: toggle button

2. Search Options: toggle button
Click this header button to toggle the expanded/collapsed state for the search options.  After choosing the required options, click the toggle button to collapse the options to allow specifying the filter text.
3

Clear Filter: button

3. Clear Filter: button
Click this button to clear the current filter results in the attached ListView.
4

Data Column Names: drop-down list

4. Data Column Names: drop-down list
This drop-down list will contain a list of column names available for filtering on the data in its attached ListView element.
5

Search Options: expanded

5. Search Options: expanded
Search options are available by clicking the header label to toggle its expanded state.