Topics   All   MacOS (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Deprecated   Guides   Examples   Videos
New in version: 9.3   9.4   9.5   10.0   10.1   10.2   10.3   10.4   10.5   10.6    Statistic    FMM    Blog  

XL.Sheet.AutoFilter.AddFilter

Adds the filter value.

Parameters

Parameter	Description	Example
bookRef	The reference to the workbook. Please use XL.LoadBook to load a file.	$ref
sheetIndex	The index of the sheet. This number ranges from 0 to XL.Book.SheetCount-1.	0
FilterColumnIndex	The column index of the filter. Range from 0 to XL.Sheet.AutoFilter.ColumnSize-1.	$FilterColumn
Filter	The filter value.

Result

Returns OK or error.

Description

Examples

Add filters:

Set Variable [ $r ; Value: MBS( "XL.Sheet.AutoFilter.AddFilter"; $book; $sheet; 0; "Japan") ]
Set Variable [ $r ; Value: MBS( "XL.Sheet.AutoFilter.AddFilter"; $book; $sheet; 0; "USA") ]
Set Variable [ $r ; Value: MBS( "XL.Sheet.AutoFilter.AddFilter"; $book; $sheet; 0; "Switzerland") ]

Add filter with a list of values:

# AUTO FILTER: :: Applies the AutoFilter to the sheet
Set Variable [ $r ; Value: MBS( "XL.Sheet.AutoFilter"; $book; $sheet) ]
#
# Select Cells :: Sets the cell range of AutoFilter with header.
Set Variable [ $r ; Value: MBS( "XL.Sheet.AutoFilter.SetRef"; $book; $sheet; $headerRow; $lastRow; 4; 4 ) ]
#
# Add Filter :: Adds the filter values from a values list.
Set Variable [ $filterCount ; Value: ValueCount ( $FilterValues ) ]
Set Variable [ $filterIndex ; Value: 1 ]
Loop
    Set Variable [ $filterValue ; Value: GetValue($filterValues; $filterIndex) ]
    Set Variable [ $r ; Value: MBS( "XL.Sheet.AutoFilter.AddFilter"; $book; $sheet; 0; $filterValue) ]
    #
    # next
    Set Variable [ $filterIndex ; Value: $filterIndex + 1 ]
    Exit Loop If [ $filterIndex > $filterCount ]
End Loop
#
# Apply Filter :: Applies the AutoFilter to the sheet
Set Variable [ $r ; Value: MBS( "XL.Sheet.ApplyFilter"; $book; $sheet) ]

See also

• XL.Book.SheetCount
• XL.LoadBook
• XL.Sheet.ApplyFilter
• XL.Sheet.AutoFilter
• XL.Sheet.AutoFilter.Clear
• XL.Sheet.AutoFilter.ColumnSize
• XL.Sheet.AutoFilter.Filter
• XL.Sheet.AutoFilter.FilterSize
• XL.Sheet.AutoFilter.GetSort
• XL.Sheet.AutoFilter.SetSort

Created 1st July 2017, last changed 16th March 2020

XL.Sheet.AutoFilter   -   XL.Sheet.AutoFilter.Clear

Feedback: Report problem or ask question.