ig.spreadsheet.SpreadsheetCellRangeFormat
Dependencies
-
alignment
- .alignment( );
- Return Type:
- ig.excel.HorizontalCellAlignment
- Return Type Description:
- The horizontal alignment of the content in a cell.
Gets the horizontal alignment of the content in a cell.
Exceptions
Exception Description ig.excel.InvalidEnumArgumentException The value assigned is not defined in the HorizontalCellAlignment enumeration. -
alignment
- .alignment( value:ig.excel.HorizontalCellAlignment );
- Return Type:
- ig.excel.HorizontalCellAlignment
- Return Type Description:
- The horizontal alignment of the content in a cell.
Sets the horizontal alignment of the content in a cell.
- value
- Type:ig.excel.HorizontalCellAlignment
Exceptions
Exception Description ig.excel.InvalidEnumArgumentException The value assigned is not defined in the HorizontalCellAlignment enumeration. -
fill
- .fill( );
- Return Type:
- ig.excel.CellFill
- Return Type Description:
- The fill of the cell.
Gets the fill of the cell.
-
fill
- .fill( value:ig.excel.CellFill );
- Return Type:
- ig.excel.CellFill
- Return Type Description:
- The fill of the cell.
Sets the fill of the cell.
- value
- Type:ig.excel.CellFill
-
font
- .font( );
- Return Type:
- ig.excel.IWorkbookFont
- Return Type Description:
- The default font formatting.
Gets the default font formatting.
Remarks
This font formatting is just the default font used in the cell. This can be overridden by strings on a character by character basis by using the FormattedString class.
See Also
-
formatString
- .formatString( );
- Return Type:
- string
- Return Type Description:
- The number format string.
Gets the number format string.
Exceptions
Exception Description ig.ArgumentException The assigned value is an invalid format string and Workbook.validateFormatStrings is True. Remarks
For more information on excel format strings, consult Microsoft Excel help.
-
formatString
- .formatString( value:string );
- Return Type:
- string
- Return Type Description:
- The number format string.
Sets the number format string.
- value
- Type:string
Exceptions
Exception Description ig.ArgumentException The assigned value is an invalid format string and Workbook.validateFormatStrings is True. Remarks
For more information on excel format strings, consult Microsoft Excel help.
-
indent
- .indent( );
- Return Type:
- number
- Return Type Description:
- The indent in units of average character widths or -1 to use the default indent.
Gets the indent in units of average character widths.
Exceptions
Exception Description ig.ArgumentOutOfRangeException The assigned value is not -1 and is outside the valid indent level range of 0 and 250. Remarks
A value of -1 indicates that the default value should be used.
-
indent
- .indent( value:number );
- Return Type:
- number
- Return Type Description:
- The indent in units of average character widths or -1 to use the default indent.
Sets the indent in units of average character widths.
- value
- Type:number
Exceptions
Exception Description ig.ArgumentOutOfRangeException The assigned value is not -1 and is outside the valid indent level range of 0 and 250. Remarks
A value of -1 indicates that the default value should be used.
-
locked
- .locked( );
- Return Type:
- boolean
- Return Type Description:
- The valid which indicates whether the cell is locked in protected mode.
Gets the valid which indicates whether the cell is locked in protected mode.
-
locked
- .locked( value:boolean );
- Return Type:
- boolean
- Return Type Description:
- The valid which indicates whether the cell is locked in protected mode.
Sets the valid which indicates whether the cell is locked in protected mode.
- value
- Type:boolean
-
rotation
- .rotation( );
- Return Type:
- number
- Return Type Description:
- The rotation of the cell content in degrees.
Gets the rotation of the cell content in degrees.
Remarks
Cell text rotation, in degrees; 0 – 90 is up 0 – 90 degrees, 91 – 180 is down 1 – 90 degrees, and 255 is vertical.
-
rotation
- .rotation( value:number );
- Return Type:
- number
- Return Type Description:
- The rotation of the cell content in degrees.
Sets the rotation of the cell content in degrees.
- value
- Type:number
Remarks
Cell text rotation, in degrees; 0 – 90 is up 0 – 90 degrees, 91 – 180 is down 1 – 90 degrees, and 255 is vertical.
-
setBorders
- .setBorders( borders:ig.spreadsheet.SpreadsheetCellRangeBorders, borderColor:ig.excel.WorkbookColorInfo, borderStyle:ig.excel.CellBorderLineStyle );
Sets the specified borders for the associated range to the specified style and color.
- borders
- Type:ig.spreadsheet.SpreadsheetCellRangeBorders
- Identifies the borders to be changed
- borderColor
- Type:ig.excel.WorkbookColorInfo
- The color for the borders
- borderStyle
- Type:ig.excel.CellBorderLineStyle
- The style for the borders
-
shrinkToFit
- .shrinkToFit( );
- Return Type:
- boolean
- Return Type Description:
- The value indicating whether the cell content will shrink to fit the cell.
Gets the value indicating whether the cell content will shrink to fit the cell.
Exceptions
Exception Description ig.excel.InvalidEnumArgumentException The value assigned is not defined in the ExcelDefaultableBoolean enumeration. Remarks
If True, the size of the cell font will shrink so all data fits within the cell.
-
shrinkToFit
- .shrinkToFit( value:boolean );
- Return Type:
- boolean
- Return Type Description:
- The value indicating whether the cell content will shrink to fit the cell.
Sets the value indicating whether the cell content will shrink to fit the cell.
- value
- Type:boolean
Exceptions
Exception Description ig.excel.InvalidEnumArgumentException The value assigned is not defined in the ExcelDefaultableBoolean enumeration. Remarks
If True, the size of the cell font will shrink so all data fits within the cell.
-
style
- .style( );
- Return Type:
- ig.excel.WorkbookStyle
- Return Type Description:
- A WorkbookStyle instance if this is a cell or differential format, or null if this is a style format.
Gets the parent WorkbookStyle of the format.
Exceptions
Exception Description ig.InvalidOperationException The value assigned is non-null and the format is a style format. ig.ArgumentException The value assigned is from a different Workbook. Remarks
The parent style of a cell or differential format provides default format values. Depending on which FormatOptions flags are present, only certain groups of format properties will be resolved from parent style. When any of the properties in a group is set to a non-default value, the FormatOptions will automatically have that flag included so the format provides values in that group rather than the style providing values in that group.
By default, all cell and differential formats will have a parent style of the normal style, which is exposed by the WorkbookStyleCollection.normalStyle property. If a value of null is assigned as the Style for a cell or differential format, then NormalStyle will actually be set.
-
style
- .style( value:ig.excel.WorkbookStyle );
- Return Type:
- ig.excel.WorkbookStyle
- Return Type Description:
- A WorkbookStyle instance if this is a cell or differential format, or null if this is a style format.
Sets the parent WorkbookStyle of the format.
- value
- Type:ig.excel.WorkbookStyle
Exceptions
Exception Description ig.InvalidOperationException The value assigned is non-null and the format is a style format. ig.ArgumentException The value assigned is from a different Workbook. Remarks
The parent style of a cell or differential format provides default format values. Depending on which FormatOptions flags are present, only certain groups of format properties will be resolved from parent style. When any of the properties in a group is set to a non-default value, the FormatOptions will automatically have that flag included so the format provides values in that group rather than the style providing values in that group.
By default, all cell and differential formats will have a parent style of the normal style, which is exposed by the WorkbookStyleCollection.normalStyle property. If a value of null is assigned as the Style for a cell or differential format, then NormalStyle will actually be set.
-
verticalAlignment
- .verticalAlignment( );
- Return Type:
- ig.excel.VerticalCellAlignment
- Return Type Description:
- The vertical alignment of the content in a cell.
Gets the vertical alignment of the content in a cell.
Exceptions
Exception Description ig.excel.InvalidEnumArgumentException The value assigned is not defined in the VerticalCellAlignment enumeration. -
verticalAlignment
- .verticalAlignment( value:ig.excel.VerticalCellAlignment );
- Return Type:
- ig.excel.VerticalCellAlignment
- Return Type Description:
- The vertical alignment of the content in a cell.
Sets the vertical alignment of the content in a cell.
- value
- Type:ig.excel.VerticalCellAlignment
Exceptions
Exception Description ig.excel.InvalidEnumArgumentException The value assigned is not defined in the VerticalCellAlignment enumeration. -
wrapText
- .wrapText( );
- Return Type:
- boolean
- Return Type Description:
- The value which indicates whether text will wrap in a cell.
Gets the value which indicates whether text will wrap in a cell.
Exceptions
Exception Description ig.excel.InvalidEnumArgumentException The value assigned is not defined in the ExcelDefaultableBoolean enumeration. Remarks
If True, and the row associated with the cell has a default WorksheetRow.height, the row's height will automatically be increased to fit wrapped content.
-
wrapText
- .wrapText( value:boolean );
- Return Type:
- boolean
- Return Type Description:
- The value which indicates whether text will wrap in a cell.
Sets the value which indicates whether text will wrap in a cell.
- value
- Type:boolean
Exceptions
Exception Description ig.excel.InvalidEnumArgumentException The value assigned is not defined in the ExcelDefaultableBoolean enumeration. Remarks
If True, and the row associated with the cell has a default WorksheetRow.height, the row's height will automatically be increased to fit wrapped content.