ImageGear for .NET User Guide > Using ImageGear for .NET > Using ImageGear.Formats.Office Namespace > Working with Excel Documents > SpreadsheetML Groups Supported by ImageGear > Worksheets |
Sheets are the fundamental parts within a workbook, and are where the user does most of their spreadsheet work. The most common type of sheet is the worksheet, which is represented as a grid of cells. Worksheet cells can contain text, numbers, dates and formulas. Cells can be formatted as well.
For the other sheet types such as chartsheets and dialogsheets, the content is ignored and a blank 8.5” x 11” page will be created in its place. |
Feature |
Description |
Comment | ||
Row |
This element expresses information about an entire row of a worksheet, and contains all cell definitions for a particular row in the worksheet. |
The following row attributes are supported:
ImageGear does not support the outline feature, which enables the user to collapse and expand one or more rows in the application. | ||
Cell |
This element represents a cell in the worksheet. Information about the cell’s location (reference), value, data type, formatting, and formula is expressed here. |
The cell element is fully supported by ImageGear. However, certain cell formatting characteristics are not. See the Styles section for more details. | ||
Merged Cells |
The element expressed the ranged of a merged cell in the worksheet. |
Merged cells are fully supported in most cases. However, there is a specific limitation of merged cells if they break across page boundaries in the paginated worksheet view (ImageGear.Formats.Office.ImGearExcelSheetPage). In this case, all text of the merged cells will be contained on the page where the first section of the merged cell exists. | ||
Cell Value |
This element expresses the value contained in a cell. If the cell contains a string, then this value is an index into the shared string table, pointing to the actual string value. Otherwise, the value of the cell is expressed directly in this element. Cells containing formulas express the last calculated result of the formula in this element. |
The cell value element is fully supported by ImageGear. However, certain cell formatting characteristics are not. See the Styles section for more details.
| ||
Inline Text |
This element allows for strings to be expressed directly in the cell definition instead of implementing the shared string table. |
Fully supported. | ||
Picture | Specifies the existence of an embedded picture. | ImageGear supports raster pictures only. | ||
Shape | Specifies the existence of a shape. |
ImageGear supports a limited set of shapes.
The shapes not listed above will not be rendered by ImageGear. | ||
Chart | Specifies the existence of a chart. |
ImageGear supports a limited set of charts:
ImageGear supports all possible combinations of above mentioned Charts. | ||
Break |
This element defines individual row or column breaks. |
Both horizontal (row) and vertical (column) page breaks are fully supported. | ||
Column Width & Formatting |
This element defines the column width and formatting for one or more columns of the worksheet. |
SpreadsheetML defines column formatting attributes to allow rows and columns to be expanded and collapsed from the user interface. This feature called outline is not supported by ImageGear. Supported column attributes are:
| ||
Dimension |
This element specifies the used range of the worksheet. It specifies the row and column bounds of used cells in the worksheet. This is optional and is not required. |
ImageGear will attempt to use the dimension element to correctly size the worksheet page to encompass the active content. If the dimension element does not exist, the worksheet content will be scanned to determine the range of used cells manually. | ||
Page Margins |
This element defines the page margins for a sheet. |
Supported margins are:
| ||
Page Setup |
This element defines the page setup settings for the worksheet. |
The page setup collection describes a variety of settings for printing a worksheet. ImageGear currently only uses the page size attribute to automatically determine a size for pages when a worksheet is paginated. Other page setup attributes are ignored. The following page sizes are supported for automatic detection:
| ||
Sheet Format Properties |
This element defines several formatting properties for a worksheet. |
The following sheet formatting properties are supported:
|
The DrawingML charts rendered by ImageGear and rendered by MS Office may have visual differences, because OpenXML specification does not contain rendering details for some chart elements. These differences include the relative positions of chart elements such as: title, axes, axes ticks, labels, legend, order of series in a legend, number of major and minor gridlines, and number of labels per axis. Also, combined charts axes maximum and minimum values (chart scaling) may differ from MS Office; as a result, the combined charts (relative positions of chart data series) rendered by ImageGear in the same plot area may visually differ from MS Office rendering. These differences do not have strict definition in OpenXML specification, and their rendering details are left up to the implementers. |
Property dialogs of XLSX Charts have various customization settings. For those properties there are a few limitations in ImageGear that should be considered. Please note that only the supported properties/features are listed below; features not listed are not currently supported.
Line Charts
Bar/Column Charts
Line Charts
Label Options
Label Contains
Value
Label Position (Center, Left, Right, Above, Below)
Fill
No fill
Solid fill
Linear or Radial Gradient fill
Picture or texture fill
Automatic fill
Border Color
No line
Solid line
Automatic
Border Styles
Single solid or dashed line
Bar/Column Charts
Label Options
Label Contains
Value
Label Position (Center, Inside End, Inside Base, Outside End)
Fill
No fill
Solid fill
Linear or Radial Gradient fill
Picture or texture fill
Automatic fill
Border Color
No line
Solid line
Automatic
Border Styles
Single solid or dashed line