GrapeCity MultiRow Windows Forms Documentation
FormattedValue Property (Cell)
Example 


Gets the value which is the formatted representation of Value.
Syntax
<BrowsableAttribute(False)>
Public ReadOnly Property FormattedValue As Object
Dim instance As Cell
Dim value As Object
 
value = instance.FormattedValue
[Browsable(false)]
public object FormattedValue {get;}

Property Value

A System.Object value that represents the formatted representation of Value.
Remarks

The Value property is the actual data object contained by the cell, whereas the FormattedValue property is the formatted representation of the data. The ValueType and FormattedValueType properties correspond to the data types of these values, respectively.

Getting this property value calls the OnCellFormatting method, which raises the GcMultiRow.CellFormatting event. You can handle the event to customize the value conversion.

If formatting is unsuccessful, the GcMultiRow.DataError event occurs. If there is no handler for this event or the handler sets the DataErrorEventArgs.ThrowException property to true, an exception is thrown.

Example
This example gets the FormattedValue property.
GrapeCity.Win.MultiRow.TextBoxCell text1 = new GrapeCity.Win.MultiRow.TextBoxCell();
GrapeCity.Win.MultiRow.CheckBoxCell check2 = new GrapeCity.Win.MultiRow.CheckBoxCell();
GrapeCity.Win.MultiRow.Template template1 = GrapeCity.Win.MultiRow.Template.CreateGridTemplate(new GrapeCity.Win.MultiRow.Cell[] { text1, check2 }, 160, GrapeCity.Win.MultiRow.AutoGenerateGridTemplateStyles.ColumnHeader | GrapeCity.Win.MultiRow.AutoGenerateGridTemplateStyles.RowHeaderAutoNumber);
template1.ColumnHeaders[0].Cells[0].Value = "Column1";
gcMultiRow1.Template = template1;
gcMultiRow1.RowCount = 3;
gcMultiRow1[1, 0].Value = "test";
listBox1.Items.Add(gcMultiRow1[1, 0].FormattedValue.ToString());
listBox1.Items.Add(gcMultiRow1[1, 0].FormattedValueType.ToString());
Dim text1 As New GrapeCity.Win.MultiRow.TextBoxCell()
Dim check2 As New GrapeCity.Win.MultiRow.CheckBoxCell()
Dim template1 As GrapeCity.Win.MultiRow.Template = GrapeCity.Win.MultiRow.Template.CreateGridTemplate(new GrapeCity.Win.MultiRow.Cell() {text1, check2}, 160, GrapeCity.Win.MultiRow.AutoGenerateGridTemplateStyles.ColumnHeader Or GrapeCity.Win.MultiRow.AutoGenerateGridTemplateStyles.RowHeaderAutoNumber)
template1.ColumnHeaders(0).Cells(0).Value = "Column1"
GcMultiRow1.Template = template1
GcMultiRow1.RowCount = 3
GcMultiRow1(1, 0).Value = "test"
ListBox1.Items.Add(GcMultiRow1(1, 0).FormattedValue.ToString())
ListBox1.Items.Add(GcMultiRow1(1, 0).FormattedValueType.ToString())
Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also

Reference

Cell Class
Cell Members

 

 


Copyright © GrapeCity, inc. All rights reserved.