FindOptions

FindOptions class

Represents find options.

class FindOptions;

Example

const { Workbook, FindOptions, CellArea, LookInType } = require("aspose.cells.node");

//Instantiate the workbook object
var workbook = new Workbook("input/Book1.xls");
//Get Cells collection 
var cells = workbook.getWorksheets().get(0).getCells();
//Instantiate FindOptions Object
var findOptions = new FindOptions();
//Create a Cells Area
var ca = new CellArea();
ca.startRow = 8;
ca.startColumn = 2;
ca.endRow = 17;
ca.endColumn = 13;

//Set cells area for find options
findOptions.setRange(ca);
//Set searching properties
findOptions.setSearchBackward(false);
findOptions.setSearchOrderByRows(true);
findOptions.setLookInType(LookInType.Values);
//Find the cell with 0 value
var cell = cells.find(0, null, findOptions);

Constructors

NameDescription
constructor()Default Constructor.

Methods

MethodDescription
getCaseSensitive()Indicates if the searched string is case sensitive.
setCaseSensitive(boolean)Indicates if the searched string is case sensitive.
getLookAtType()Look at type.
setLookAtType(LookAtType)Look at type.
isRangeSet()Indicates whether the searched range is set.
getSearchBackward()Whether search backward for cells.
setSearchBackward(boolean)Whether search backward for cells.
getSearchOrderByRows()Indicates whether search order by rows or columns.
setSearchOrderByRows(boolean)Indicates whether search order by rows or columns.
getLookInType()Look in type.
setLookInType(LookInType)Look in type.
getRegexKey()Indicates whether the searched key is regex. If true the searched key will be taken as regex and parsed. Otherwise the key will be parsed according to the rules in ms excel.
setRegexKey(boolean)Indicates whether the searched key is regex. If true the searched key will be taken as regex and parsed. Otherwise the key will be parsed according to the rules in ms excel.
getValueTypeSensitive()Indicates whether searched cell value type should be same with the searched key.
setValueTypeSensitive(boolean)Indicates whether searched cell value type should be same with the searched key.
getStyle()The format to search for.
setStyle(Style)The format to search for.
getConvertNumericData()Gets or sets a value that indicates whether converting the searched string value to numeric data.
setConvertNumericData(boolean)Gets or sets a value that indicates whether converting the searched string value to numeric data.
getRange()Gets and sets the searched range.
setRange(CellArea)Sets the searched range.
isNull()Checks whether the implementation object is null.

constructor()

Default Constructor.

constructor();

getCaseSensitive()

Indicates if the searched string is case sensitive.

getCaseSensitive() : boolean;

setCaseSensitive(boolean)

Indicates if the searched string is case sensitive.

setCaseSensitive(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getLookAtType()

Look at type.

getLookAtType() : LookAtType;

Returns

LookAtType

setLookAtType(LookAtType)

Look at type.

setLookAtType(value: LookAtType) : void;

Parameters:

ParameterTypeDescription
valueLookAtTypeThe value to set.

isRangeSet()

Indicates whether the searched range is set.

isRangeSet() : boolean;

getSearchBackward()

Whether search backward for cells.

getSearchBackward() : boolean;

setSearchBackward(boolean)

Whether search backward for cells.

setSearchBackward(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getSearchOrderByRows()

Indicates whether search order by rows or columns.

getSearchOrderByRows() : boolean;

setSearchOrderByRows(boolean)

Indicates whether search order by rows or columns.

setSearchOrderByRows(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getLookInType()

Look in type.

getLookInType() : LookInType;

Returns

LookInType

setLookInType(LookInType)

Look in type.

setLookInType(value: LookInType) : void;

Parameters:

ParameterTypeDescription
valueLookInTypeThe value to set.

getRegexKey()

Indicates whether the searched key is regex. If true the searched key will be taken as regex and parsed. Otherwise the key will be parsed according to the rules in ms excel.

getRegexKey() : boolean;

setRegexKey(boolean)

Indicates whether the searched key is regex. If true the searched key will be taken as regex and parsed. Otherwise the key will be parsed according to the rules in ms excel.

setRegexKey(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getValueTypeSensitive()

Indicates whether searched cell value type should be same with the searched key.

getValueTypeSensitive() : boolean;

setValueTypeSensitive(boolean)

Indicates whether searched cell value type should be same with the searched key.

setValueTypeSensitive(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getStyle()

The format to search for.

getStyle() : Style;

Returns

Style

setStyle(Style)

The format to search for.

setStyle(value: Style) : void;

Parameters:

ParameterTypeDescription
valueStyleThe value to set.

getConvertNumericData()

Gets or sets a value that indicates whether converting the searched string value to numeric data.

getConvertNumericData() : boolean;

setConvertNumericData(boolean)

Gets or sets a value that indicates whether converting the searched string value to numeric data.

setConvertNumericData(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getRange()

Gets and sets the searched range.

getRange() : CellArea;

Returns

Returns the searched range.

setRange(CellArea)

Sets the searched range.

setRange(ca: CellArea) : void;

Parameters:

ParameterTypeDescription
caCellAreathe searched range.

isNull()

Checks whether the implementation object is null.

isNull() : boolean;