FilterGroupMarker()

Inserts a marker in a filter expression and operates on the grouped set of expressions that follow and precede it. Call FilterGroupBegin() to start a group. Call the desired filter tokens to build up the group, and then call FilterGroupEnd() to terminate the group.

Token ID

AFTKN_FILTER_GROUP_MARKER or 842

Syntax

VOID FilterGroupMarker(ENUM FilterHandleType; 
                       ENUM FilterOperator)

Parameters

FilterHandleType As ENUM

Unique filter identifier:

  • 315 Default
FilterOperator As ENUM
  • 316 And
  • 317 Or

Remarks

Rather than actually identifying a group, FilterGroupMarker operates on the groups before and after. For example, consider the following code

Commandr.Execute('FilterGroupBegin('+Filter+'Or!)' ,RetString);

Commandr.Execute(’FilterGroupBegin(’+Filter+’And!)’ ,RetString);
Commandr.Execute('filtersetDate('+Filter+'CreateDate!;;;GTE!;Yesterday!;-15)'
     ,RetString);
Commandr.Execute('FilterGroupEnd('+Filter+')' ,RetString);

Commandr.Execute('FilterGroupMarker('+Filter+'Or!)' ,RetString);

Commandr.Execute('FilterGroupBegin('+Filter+'And!)' ,RetString);
Commandr.Execute('filtersetDate('+Filter+'CreateDate!;;;Equal!;Today!;)'
     ,RetString);
Commandr.Execute('FilterGroupEnd('+Filter+')' ,RetString);

Commandr.Execute('FilterGroupEnd('+Filter+')' ,RetString);

FilterGroupMarker will ’OR’ the results of the grouped set before and the grouped set after. If you viewed this filter through the client, it would look like the following

(Created is greater than or equal to 15 Days before Yesterday) OR (Created is Today)