XLSheetMBS.SelectionRange as string

XLSheetMBS.SetActiveCell(row as integer, col as integer)

XLSheetMBS.SetAutoFitArea(rowFirst as Integer = 0, colFirst as Integer = 0, rowLast as Integer = -1, colLast as Integer = -1)

The method setCol with -1 width value will affect only to the specified limited area.

XLSheetMBS.SetBorder(rowFirst as Integer, rowLast as Integer, colFirst as Integer, colLast as Integer, borderStyle as Integer, borderColor as Integer)

rowFirst - the first row of range;
rowLast - the last row of range;
colFirst - the first column of range;
colLast - the last column of range;
borderStyle - the border style;
borderColor - the border color.

XLSheetMBS.SetCol(colFirst as Integer, colLast as Integer, width as Double, format as XLFormatMBS = nil, hidden as boolean = false) as boolean

If format is nil then format is ignored. Columns may be hidden. Returns false if error occurs. Get error info with XLBookMBS.ErrorMessage property.

Column width measured as the number of characters of the maximum digit width of the numbers 0, 1, 2, ..., 9 as rendered in the normal style's font. Value -1 is used for autofit column widths. If format equals 0 then format is ignored. Columns may be hidden.

XLSheetMBS.SetColPx(colFirst as integer, colLast as integer, width as integer, format as XLFormatMBS = nil, hidden as boolean = false) as boolean

Value -1 is used for autofit column widths.
If format equals nil then format is ignored. Columns may be hidden.
Returns false if error occurs. Get an error info with the errorMessage function in XLBookMBS class.

XLSheetMBS.SetFooter(footer as string, margin as Double) as boolean

The footer text appears at the bottom of every page when printed. The length of the text must be less than or equal to 255. The footer text can contain special commands, for example a placeholder for the page number, current date or text formatting attributes. See setHeader for details. Margin is specified in inches.

Code	Description
&L	specifies the beginning of the left section
&P	specifies the current page number
&N	specifies the total number of pages
&\d{1,3}	specifies the text font size, where font size is measured in points, for example: &9 or &36
&S	specifies whether the strikethrough text style is on or off
&X	specifies whether the superscript text style is on or off
&Y	specifies whether the subscript text style is on or off
&C	specifies the beginning of the center section
&D	specifies a date
&T	specifies a time
&G	specifies a picture
&U	specifies whether the single underline text style is on or off
&E	specifies whether the double underline text style is on or off
&R	specifies the beginning of the right section
&Z	specifies a workbook file path
&F	specifies a workbook file name
&A	specifies a sheet name
&"fontname"	specifies the text font, for example: &"Comic Sans MS"
&B	specifies whether the bold text style is on or off
&I	specifies whether the italic text style is on or off
&&	specifies an ampersand character (&)

XLSheetMBS.SetHeader(header as string, margin as Double) as boolean

The text appears at the top of every page when printed. The length of the text must be less than or equal to 255. The header text can contain special commands, for example a placeholder for the page number, current date or text formatting attributes. Special commands are represented by single letter with a leading ampersand ("&"). Margin is specified in inches.

Code	Description
&L	specifies the beginning of the left section
&P	specifies the current page number
&N	specifies the total number of pages
&\d{1,3}	specifies the text font size, where font size is measured in points, for example: &9 or &36
&S	specifies whether the strikethrough text style is on or off
&X	specifies whether the superscript text style is on or off
&Y	specifies whether the subscript text style is on or off
&C	specifies the beginning of the center section
&D	specifies a date
&T	specifies a time
&G	specifies a picture
&U	specifies whether the single underline text style is on or off
&E	specifies whether the double underline text style is on or off
&R	specifies the beginning of the right section
&Z	specifies a workbook file path
&F	specifies a workbook file name
&A	specifies a sheet name
&"fontname"	specifies the text font, for example: &"Comic Sans MS"
&B	specifies whether the bold text style is on or off
&I	specifies whether the italic text style is on or off
&&	specifies an ampersand character (&)

XLSheetMBS.SetHorPageBreak(row as Integer, pageBreak as boolean = true) as boolean

// new document
Var x as new XLBookMBS

// add a sheet
Var s as XLSheetMBS = x.AddSheet

// write a cell
call s.WriteString(5,5, "Hello")

// now put a page break there
if s.SetHorPageBreak(5, true) then
  // and now we have one at row 5
  MsgBox str(s.GetHorPageBreakCount)+" "+str(s.GetHorPageBreak(0))
end if

Returns false if error occurs. Get error info with XLBookMBS.ErrorMessage property.

XLSheetMBS.SetMerge(rowFirst as Integer, rowLast as Integer, colFirst as Integer, colLast as Integer) as boolean

// create new xls file
Var book As New XLBookMBS(True)

// create sheet
Var sheet as XLSheetMBS = book.AddSheet("Sheet1")

// create a format with border
Var borderFormat As XLFormatMBS = book.AddFormat
borderFormat.SetBorder 2
borderFormat.SetBorderColor &hFF0000

// now fill a cell and merge a few more cells.
Var r1 As Boolean = sheet.WriteString(2, 2, "Hello World", borderFormat)
Var r2 As Boolean = sheet.SetMerge(2, 4, 2, 4)

// write file
Var file As FolderItem = SpecialFolder.Desktop.Child("Generate.xlsx")

if book.Save(file) then
  file.Launch
else
  MsgBox "Failed to create file."+EndOfLine+EndOfLine+book.ErrorMessage
end if

Returns false if error occurs. Get error info with XLBookMBS.ErrorMessage property.

Some examples using this method:

• /XL/Writing data

XLSheetMBS.SetNamedRange(name as string, rowFirst as Integer, rowLast as Integer, colFirst as Integer, colLast as Integer, scopeId as Integer = -2) as boolean

scopeId - index of sheet for local named range or ScopeWorkbook for global named range.
Returns false if error occurs. Get error info with XLBookMBS.errorMessage.

XLSheetMBS.SetPicture(row as Integer, col as Integer, PictureID as Integer, scale as Double = 1.0, OffsetX as Integer = 0, OffsetY as Integer = 0, pos as Integer = 0)

Use XLBookMBS.addPicture() for getting picture identifier.

scale = 0 means the picture is stretched inside the specified cell or merged area.

See also:

• SetPicture(row as Integer, col as Integer, PictureID as Integer, width as Integer, height as Integer, OffsetX as Integer = 0, OffsetY as Integer = 0, pos as Integer = 0)

XLSheetMBS.SetPicture(row as Integer, col as Integer, PictureID as Integer, width as Integer, height as Integer, OffsetX as Integer = 0, OffsetY as Integer = 0, pos as Integer = 0)

Use XLBookMBS.addPicture() for getting a picture identifier.

Width and height can be -1 for default size of picture.

See also:

• SetPicture(row as Integer, col as Integer, PictureID as Integer, scale as Double = 1.0, OffsetX as Integer = 0, OffsetY as Integer = 0, pos as Integer = 0)

XLSheetMBS.SetPrintArea(rowFirst as Integer, rowLast as Integer, colFirst as Integer, colLast as Integer)

XLSheetMBS.SetPrintFit(wPages as Integer, hPages as Integer)

XLSheetMBS.SetPrintRepeatCols(colFirst as Integer, colLast as Integer)

XLSheetMBS.SetPrintRepeatRows(rowFirst as Integer, rowLast as Integer)

XLSheetMBS.SetProtectEx(protect as boolean = true, password as string = "", enhancedProtection as Integer = -1)

It is possible to combine a few EnhancedProtection values with operator BitwiseOr.

XLSheetMBS.SetRow(row as Integer, height as Double, format as XLFormatMBS = nil, hidden as boolean = false) as boolean

If format is nil then format is ignored. Row may be hidden. Returns false if error occurs. Get error info with XLBookMBS.ErrorMessage property.

Height is in points. If you want to convert from pixels to points you can use this calculation: points = pixels * 72 / 96. So for a height of 72 pixel, you pass 54 points.

XLSheetMBS.SetRowPx(row as integer, height as integer, format as XLFormatMBS = nil, hidden as boolean = false) as boolean

If format equals nil then format is ignored. Row may be hidden. Returns false if error occurs. Get an error info with the errorMessage function in XLBookMBS class.

XLSheetMBS.SetTabColor(colorValue as Integer)

XLSheetMBS.SetTabRgbColor(red as Integer, green as Integer, blue as Integer)

XLSheetMBS.SetTopLeftView(row as Integer, col as Integer)

// create new xls file
Var book as new XLBookMBS(false)

// create sheet
Var sheet as XLSheetMBS = book.AddSheet("Sheet1")

// set top left view
sheet.SetTopLeftView(2,3)

// read values
Var col, row as Integer
sheet.GetTopLeftView(row, col)

MsgBox str(Row)+", "+str(col) // shows 2, 3

XLSheetMBS.SetVerPageBreak(row as Integer, pageBreak as boolean = true) as boolean

Returns false if error occurs. Get error info with XLBookMBS.ErrorMessage property.

XLSheetMBS.Split(row as Integer, col as Integer)

Splits a sheet at position (row, col) or specifies the position of frozen pane. This function allows to freeze a header at top position or freeze some columns on the right.

XLSheetMBS.SplitInfo(byref row as Integer, byref col as Integer) as Boolean

row: vertical position of the split;
col: horizontal position of the split.
Returns true on success.