QScript ExcelWorksheet

From Q
Jump to navigation Jump to search

This is only available in Displayr.

ExcelWorksheet

Represents a worksheet inside an Excel workbook. A worksheet contains one or more tables.

equals(obj)

Whether two objects are the same.
objThe object to compare against.
Returns:true or false
Example:
data_file.getQuestionByName('Q2').equals(data_file.questions()[0])

error

Errors associated with this item as a string. Returns null if there are no errors. Warnings are excluded. Errors only surface on individual tables (Excel tables, SQL tables, summary tables); workbooks, worksheets, queries and SQL connections return null.

getTableByName(name)

Finds a table by name.
nameThe name (title) of the table.
Returns:An ExcelSummaryTable object, or null if no matching table exists.

guid

Get the internal identifier for this worksheet, which is unique for all items in the document.

name

Get/set the name of this item. Setting is silently ignored for items that do not support a name change.

referenceName

Get/set the reference name for this item, used to refer to it in the source code of other items. Setting is only supported on individual tables (Excel tables, SQL tables, summary tables); on workbooks, worksheets, SQL queries and SQL connections the setter is a silent no-op.

subItems

Returns an array containing all tables in this worksheet.

tables

Gets an array containing all tables in this worksheet. The first table is [0].

type

Returns ExcelWorksheet.

workbook

Gets the workbook that contains this worksheet.