Spread 8.0 Documentation
XML File Export Information
Support Options
XML Export Reference > XML File Export > XML File Export Information

Glossary Item Box

XML File Export Information

When Spread exports an XML file or XML data to a buffer, it translates its data and property and method settings to XML data, as listed in the following table.

XML File Export

Spread Property or Method

Discussion

AddCellSpan

Ignores the spans in the spreadsheet. The data in each cell that was hidden by the spanned cell is exported to the XML data.

AllowCellOverflow

Ignores the setting of this property. The data in the cell is exported to XML in its entirety.

AllowEditOverflow

Ignores the setting of this property.

BackColor

Colors and other appearance settings are ignored.

CellNote

Cell notes are not exported to XML data.

CellTag

Cell tags are not exported to XML data.

CellType

For many cell types, the data and formatting in Spread are exported to XML data, as explained in the following rows.

Button

Contents of button cells are not exported.

Check box

If the check box cell is a two-state check box, the value 0 or 1 is exported to XML. If the check box cell is a three-state check box, the value 0, 1, or 2 is exported to XML.

Combo box

If formatted data is exported, the current value in the edit field of the combo box is exported. If unformatted data is exported, the index number of the current value in the edit field of the combo box is exported.

Currency

Currency cells are exported in the format in which they are displayed if you choose to export formatted data. Exporting unformatted data exports the values in the cells similar to returning the values using the Value property, as explained in the following rows.

TypeCurrencyDecimal

If exporting formatted data, the setting of the TypeCurrencyDecimal property determines the decimal character or characters in Spread, which is the character exported to the XML data. For unformatted data, the exported data uses the default decimal character, specified by the regional settings.

TypeCurrencyDecPlaces

The setting of the TypeCurrencyDecPlaces property determines the number of decimal digits displayed in Spread, which is the number of decimal digits exported to the XML data.

TypeCurrencyLeadingZero

The setting of the TypeCurrencyLeadingZero property determines whether the leading zero is displayed for values between -1 and 1 in Spread. If the leading zero is displayed in Spread, it is exported to the XML data.

TypeCurrencyNegStyle

If exporting formatted data, the setting of the TypeCurrencyNegStyle property determines the format displayed for negative values in currency cells, which is the format exported to the XML data. For unformatted data, the exported data uses the default negative style, specified by the regional settings.

TypeCurrencyPosStyle

If exporting formatted data, the setting of the TypeCurrencyPosStyle property determines the format displayed for positive values in currency cells, which is the format exported to the XML data. For unformatted data, the exported data uses the default negative style, specified by the regional settings.

TypeCurrencySeparator

If exporting formatted data, the setting of the TypeCurrencySeparator property determines the separator character in Spread, which is the character exported to the XML data. For unformatted data, the separator character is not exported.

TypeCurrencyShowSep

If exporting formatted data, the setting of the TypeCurrencyShowSep property determines whether the cell displays a separator character in Spread; if the cell displays the character, it is exported to the XML data. For unformatted data, the separator character is not exported.

TypeCurrencyShowSymbol

If exporting formatted data, the setting of the TypeCurrencyShowSymbol property determines whether the cell displays a currency character in Spread; if the cell displays the character, it is exported to the XML data. For unformatted data, the currency character is not exported.

TypeCurrencySymbol

If exporting formatted data, the setting of the TypeCurrencySymbol property determines the currency character in Spread, which is the character exported to the XML data. For unformatted data, the currency character is not exported.

Date

Date cells are exported in the format in which they are displayed, as explained in the following rows.

TypeDateCentury

If formatted data is exported, and the TypeDateCentury property is set to True, the displayed date displays the century digits, which are exported to XML. If unformatted data is exported, the date is exported in the format MMDDYYYY regardless of the setting of the TypeDateCentury property.

Note To avoid misunderstanding, always display century values in Spread so that they are exported to XML.

TypeDateFormat

If formatted data is exported, the setting of the TypeDateFormat property determines the date format in Spread, which is the format exported to XML. If unformatted data is exported, the date is exported in the format MMDDYYYY regardless of the setting of the TypeDateFormat property.

TypeDateSeparator

If formatted data is exported, the setting of the TypeDateSeparator property determines the date separator in Spread, which is the separator exported to XML. If unformatted data is exported, the date is exported in the format MMDDYYYY and no separator character is used, regardless of the setting of the TypeDateSeparator property.

Edit

Edit cells are exported in the format in which they are displayed, as explained in the following rows.

TypeEditCharCase

The setting of the TypeEditCharCase property determines the text case in Spread, which is the text case exported to XML.

TypeEditPassword

The data displayed in the cell is exported. If the cell displays a placeholder character, such as "*", that character is exported.

Number

Number cells are exported in the format in which they are displayed if you choose to export formatted data. Exporting unformatted data exports the values in the cells similar to returning the values using the Value property, as explained in the following rows.

TypeNumberDecimal

If exporting formatted data, the setting of the TypeNumberDecimal property determines the decimal character or characters in Spread, which is the character exported to the XML data. For unformatted data, the exported data uses the default decimal character, specified by the regional settings.

TypeNumberDecPlaces

The setting of the TypeNumberDecPlaces property determines the number of decimal digits displayed in Spread, which is the number of decimal digits exported to the XML data.

TypeNumberLeadingZero

The setting of the TypeNumberLeadingZero property determines whether the leading zero is displayed for values between -1 and 1 in Spread. If the leading zero is displayed in Spread, it is exported to the XML data.

TypeNumberNegStyle

If exporting formatted data, the setting of the TypeNumberNegStyle property determines the format displayed for negative values in number cells, which is the format exported to the XML data. For unformatted data, the exported data uses the default negative style, specified by the regional settings.

TypeNumberSeparator

If exporting formatted data, the setting of the TypeNumberSeparator property determines the separator character in Spread, which is the character exported to the XML data. For unformatted data, the separator character is not exported.

TypeNumberShowSep

If exporting formatted data, the setting of the TypeNumberShowSep property determines whether the cell displays a separator character in Spread; if the cell displays the character, it is exported to the XML data. For unformatted data, the separator character is not exported.

Owner-Drawn

Contents of owner-drawn cells are not exported.

Percent

Percent cells are exported in the format in which they are displayed if you choose to export formatted data. Exporting unformatted data exports the values in the cells similar to returning the values using the Value property, as explained in the following rows.

TypePercentDecimal

If exporting formatted data, the setting of the TypePercentDecimal property determines the decimal character or characters in Spread, which is the character exported to the XML data. For unformatted data, the exported data uses the default decimal character, specified by the regional settings.

TypePercentDecPlaces

The setting of the TypePercentDecPlaces property determines the number of decimal digits displayed in Spread, which is the number of decimal digits exported to the XML data.

TypePercentLeadingZero

The setting of the TypePercentLeadingZero property determines whether the leading zero is displayed for values between -1 and 1 in Spread. If the leading zero is displayed in Spread, it is exported to the XML data.

TypePercentNegStyle

If exporting formatted data, the setting of the TypePercentNegStyle property determines the format displayed for negative values in percent cells, which is the format exported to the XML data. For unformatted data, the exported data uses the default negative style, specified by the regional settings.

PIC

The data in PIC cells is exported, as explained in the following rows.

TypePicDefaultText

Default text is not exported unless the user has typed some data in the cell, in which case the PIC cell displays the data and the default text, and it is all exported.

TypePicMask

The setting of the TypePicMask property determines which data users can enter in the cell. The data provided by the users is exported, as are the literal characters defined in the PIC cell.

Picture

Contents of picture cells are not exported.

Static text

Static text cells are exported in the format in which they are displayed.

Scientific

Scientific cells are exported in the format in which they are displayed.

TypeScientificDecimal

If exporting formatted data, the setting of the TypeScientificDecimal property determines the decimal character or characters in Spread, which is the character exported to the XML data. For unformatted data, the exported data uses no decimal symbol or places.

TypeScientificDecPlaces

If exporting formatted data, the setting of the TypeScientificDecPlaces property determines the number of decimal places in Spread, which is the number of decimal digits exported to the XML data. For unformatted data, the exported data uses no decimal places.

Time

Time cells are exported in the format in which they are displayed or as data, as explained in the following rows.

TypeTime24Hour

If formatted data is exported, the setting of the TypeTime24Hour property determines whether the cell displays time in 12- or 24-hour format in Spread; whichever format the cell displays is the format exported to XML. If unformatted data is exported, the time value is exported as a 24-hour time value in the format HHMMSS, regardless of the setting of the TypeTime24Hour property.

TypeTimeSeconds

If formatted data is exported, the setting of the TypeTimeSeconds property determines whether the cell displays the seconds value in Spread; if the cell displays seconds, the seconds value is exported to XML. If unformatted data is exported, the time value is exported as a 24-hour time value in the format HHMMSS, regardless of the setting of the TypeTimeSeconds property.

TypeTimeSeparator

If formatted data is exported, the setting of the TypeTimeSeparator property determines which time separator character the cell displays in Spread; whichever separator the cell displays is exported to XML. If unformatted data is exported, the time value is exported as a 24-hour time value in the format HHMMSS, regardless of the setting of the TypeTimeSeparator property.

ColHeaderRows

The additional column header rows are ignored. The text in the column header row specified by the ColHeadersAutoTextIndex property is used as the element tags.

ColHeadersAutoText

Sets text in column headers as element tags.

ColHeadersAutoTextIndex

The text in the column header row specified by the ColHeadersAutoTextIndex property is used as the element tags.

ColHeadersShow

Setting this property does not have an effect on the export. The XML file uses the heading numbering or text that would be displayed if ColHeadersAutoText is set to True to name the element tags.

ColHeadersUserSortIndex

The setting of the ColHeadersUserSortIndex property is ignored.

ColHidden

Spread does not export hidden columns to XML.

ColID

Column ID settings are ignored.

ColMerge

Merged cells are treated as individual cells, each containing the same data. The merge setting is ignored.

ColWidth

The column width setting is ignored.

Font

Font settings are ignored.

Formula

Current value in the cell at time of export is exported to XML.

Tip Before you perform the export, recalculate the formulas in the spreadsheet to be sure you are exporting the most current value.

GridShowHoriz

Appearance settings are ignored.

GridShowVert

Appearance settings are ignored.

LockBackColor

Colors and other appearance settings are ignored.

LockForeColor

Colors and other appearance settings are ignored.

MaxCols

Using the ExportToXML method or the SSExportToXML function, the fpSpread control exports all the columns and rows that contain data in the spreadsheet to XML. If you specify a range of cells using the ExportRangeToXML method or the SSExportRangeToXML function, all the cells you specify that contain data are exported to XML.

MaxRows

Using the ExportToXML method or the SSExportToXML function, the fpSpread control exports all the columns and rows that contain data in the spreadsheet to XML. If you specify a range of cells using the ExportRangeToXML method or the SSExportRangeToXML function, all the cells you specify that contain data are exported to XML.

RowHeaderCols

The row headers are ignored.

RowHeadersAutoText

The row headers are ignored.

RowHeadersAutoTextIndex

The row headers are ignored.

RowHeadersShow

The row headers are ignored.

RowHeight

The row height setting is ignored.

RowHidden

Spread does not export hidden rows to XML.

RowMerge

Merged cells are treated as individual cells, each containing the same data. The merge setting is ignored.

ShadowColor

Colors and other appearance settings are ignored.

ShadowText

Colors and other appearance settings are ignored.

StartingColNumber

Numbering used in Spread exports to the XML data, and is used as the element tags.

StartingRowNumber

The row header is ignored.

TwoDigitYearMax

The XML data receives dates in the same format as they were displayed in the spreadsheet. Therefore, if the TypeDateCentury property is set to True so that dates display century digits, this value affects how the century values were determined in Spread, if the year values were provided as two-digit values.

TypeEllipses

Ignores the setting of this property. The data in the cell is exported to XML in its entirety.

TypeHAlign

Appearance settings are ignored.

TypeNegRed

Appearance settings are ignored.

TypeSpinInc

Spin button settings are ignored.

TypeSpinWrap

Spin button settings are ignored.

TypeTextOrient

Appearance settings are ignored.

TypeVAlign

Appearance settings are ignored.

VirtualMode

Set the VirtualMode property to False before exporting the spreadsheet from Spread. If you do not turn virtual mode off before exporting from Spread, the XML data will contain only the data that is currently in the virtual buffer.

Other settings

 

Control border

Appearance settings are ignored.

Empty cells

Empty cells are not exported to XML data.

Leading or trailing spaces in cells

Leading or trailing spaces are exported as data.

© 2002-2014 ComponentOne, a division of GrapeCity. All Rights Reserved.