Spread Windows Forms 12.0 Product Documentation
Understanding How Cell Types Display and Format Data
Spread Windows Forms 12.0 Product Documentation > Developer's Guide > Customizing Interaction with Cell Types > Understanding How Cell Types Work > Understanding How Cell Types Display and Format Data

The value of the Text property contains the formatted data as displayed in the cell; the value of the Value property contains the unformatted data as saved in the model. You can use the SheetView, GetText and GetValue methods to obtain the contents of the cell, regardless of cell type.

The following table lists the editable cell types, and how each cell type works with the data, whether formatted (Text) or unformatted (Value).

Editable Cell Type Sample Input Formatted Data Unformatted Data
CurrencyCellType "$10,000.00" "$10,000.00" 10000.00
DateTimeCellType "10/29/2002" "10/29/2002" DateTime object of Tuesday, October 29, 2002 12:00:00 AM
GcCharMaskCellType "123-45-6789" "123-45-6789" "123456789"
GcDateTimeCellType "10/29/2002" "10/29/2002" DateTime object of Tuesday, October 29, 2002 12:00:00 AM
GcMaskCellType "123-45-6789" "123-45-6789" "123456789"
GcNumberCellType "10000.00" "10000.00" 10000.00
GcTextBoxCellType Any text String of that text String of that text
GcTimeSpanCellType "1.22:50:40" "1.22:50:40" TimeSpan object {1.22:50:40}
GeneralCellType Any data String of that data Depends on whether DateTime, Boolean, or Text returns the DateTime object, the Boolean value, or the Text value
MaskCellType "123-45-6789" "123-45-6789" "123456789"
NumberCellType "10000.00" "10000.00" 10000.00
PercentCellType "15%" "15%" 0.15
RegularExpressionCellType "99-999-9999" "99-999-9999" "99-999-9999"
TextCellType Any text String of that text String of that text

The following table lists the graphical cell types, and how each cell type works with the Text and Value properties.

Graphical Cell Type Sample Input Text Data Value Data
BarCodeCellType Picture as data N/A N/A
ButtonCellType two-state True "1" True
  False "0" False
  Not set looks false Empty string False
CheckBoxCellType two-state True (checked) "True" 1
  False (unchecked) "False" 0
  Not set looks false Empty string False
CheckBoxCellType three-state True (checked) "1" 1
  False (unchecked) "0" 0
  Indeterminate (gray) "2" 2
  Not set looks false Empty string 0
ColorPickerCellType Selected color Color name Color name
ComboBoxCellType and MultiColumnComboBoxCellType Any item Text of selected item Text of selected item or index of selected item (see the EditorValue property)
  Nothing selected Empty string Null
GcComboBoxCellType Any item Text of selected item Text of selected item or index of selected item (see the EditorValue property)
  Nothing selected Empty string Null
HyperLinkCellType any text Array of Boolean values: "True" (for visited link) or "False" (for not visited) Array of Boolean values: "True" (for visited link) or "False" (for not visited)
ImageCellType Picture as data N/A N/A
ListBoxCellType Array Array Array
MultiOptionCellType Any item selected Text of selected item Index of selected item (numeric)
  Nothing selected Empty string Null
ProgressCellType 15, between 10 and 20 "50%" (string representation of numeric value) 15 (actual value)
RichTextCellType String in rich text format String in rich text format String in rich text format
SliderCellType 4, between 0 and 10 "4" (string representation of numeric value) 4

For information on other aspects of cell display, refer to Resizing a Cell to Fit the Data.

See Also