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:
12.1
12.2
12.3
12.4
12.5
13.0
13.1
13.2
13.3
13.4
Statistic
FMM
Blog
Set cell formats in given area.
Component | Version | macOS | Windows | Linux | Server | iOS SDK |
XL | 8.0 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |
Parameter | Description | Example | Flags |
---|---|---|---|
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 | |
First row | The first row to process. First row has index 0. | 3 | |
Last row | The last row to process. First row has index 0. | 6 | |
First column | The first column to process. First column has index 0. | 2 | |
Last column | The last column to process. First column has index 0. | 4 | |
Formats | The format to use. Can be separated with row and column delimiter to give each row and column a different format. But you can also use same format for all rows or for all columns. |
$dollarFormat | |
Row Delimiter | The row delimiter for the result. Default is new line character. |
"¶" | Optional |
Column Delimiter | The column delimiter for the result. Default is tab character. |
char(9) | Optional |
Returns number of errors or error.
Write bold row and data rows:
# create bold font & format
Set Variable [ $boldFont ; Value: MBS( "XL.Book.AddFont"; $bookRef) ]
Set Variable [ $r ; Value: MBS( "XL.Font.SetBold"; $bookRef; $boldFont; 1) ]
Set Variable [ $boldFormat ; Value: MBS( "XL.Book.AddFormat"; $bookRef) ]
Set Variable [ $r ; Value: MBS( "XL.Format.SetFont"; $bookRef; $boldFormat; $boldFont) ]
# Write a title row
Set Variable [ $r ; Value: MBS( "XL.Sheet.CellWriteTexts"; $bookRef; $sheet; 1; 1; 1; 4; "A,B,C,D"; ¶; "," ) ]
# Make it bold
Set Variable [ $r ; Value: MBS( "XL.Sheet.SetCellFormats"; $bookRef; $sheet; 1; 1; 1; 4; $boldFormat ) ]
# and write data
Set Variable [ $r ; Value: MBS( "XL.Sheet.CellWriteTexts"; $bookRef; $sheet; 2; 5; 1; 4; $data; ¶; "," ) ]
Set a range of cells to same format:
MBS( "XL.Sheet.SetCellFormats"; $BookRef; $sheet; 1; 3; 7; 10; $dollarFormat )
This function checks for a license.
Created 15th January 2018, last changed 29th January 2023