TXlsFile.SetCellFromString Method
Converts a string to the best datatype, and the enters it into a cell.
Remarks
When using TExcelFile.SetCellValue(Integer, Integer, TCellValue, Integer) to set a cell value, you have to know the datatype you want to enter. That is, if you have a string s="1/1/2002" and call SetCellValue(1,1,s); the cell A1 will end up with a string "1/1/2002" and not with a date. The same if you have a string holding a number.
SetCellFromString tries to solve this problem. When you call SetCellFromString(1, 1, s) it will look:
- If s contains a valid number: If it does, it will enter the number into the cell, and not the string s
- If s contains a boolean: If s equals the words "TRUE" or "FALSE" (or whatever you define on the constants TxtTrue and TxtFalse) it will enter the boolean into the cell
- If s contains a date: If s is a valid date (according to your windows settings, or with a list of allowed date/time formats) it will enter a number into the cell and format the cell as a date. (see 'Date cells' in the Api Developer Guide)
- In any other case, it will enter the string s into the cell.
Syntax
Unit: FlexCel.XlsAdapter
procedure TXlsFile.SetCellFromString(const sheet: Integer; const row: Integer; const col: Integer; const value: TRichString; const XF: Integer; const dateFormats: TArray<string>); overload; override;
Parameters
<-> | Parameter | Type | Description |
---|---|---|---|
const | sheet | Integer | Sheet where the cell is (1 based) |
const | row | Integer | Cell Row (1 based) |
const | col | Integer | Cell Column (1 based) |
const | value | TRichString | Value to enter into the cell. |
const | XF | Integer | New XF of the cell. It can be modified, i.e. if you enter a date, the XF will be converted to a Date XF. |
const | dateFormats | TArray<string> | Note:This format must be expressed with .NET notation, as specified here: http://msdn.microsoft.com/en-us/library/8kb3ddd4(v=vs.110).aspx .A list of formats allowed for dates and times. Windows is a little liberal in what it thinks can be a date, and it can convert things like "1.2" into dates. By setting this property, you can ensure the dates are only in the formats you expect. If you leave it null, we will trust "DateTime.TryParse" to guess the correct values. |