GridData.SetColumnLabel operator

Introduced

v4.0

Description

Sets a label string for a Column. Labels are optional. The visual appearance of row labels can be tweaked with the siUIGridHideColumnHeader and siUIGridLockColumnHeader attributes (see siPPGItemAttribute).

C# Syntax

GridData.SetColumnLabel( Int32 in_lColumnIndex, String in_Label );

Scripting Syntax

GridData.SetColumnLabel( ColumnIndex, [Label] );

Parameters

Parameter Type Description
ColumnIndex long Index of the Column. The left-most column has index 0.
Label String New Label, or an empty string to remove the label

Examples

JScript Example

//Demo of Labels

var oPSet = ActiveSceneRoot.AddProperty("CustomProperty",false,"GridLabelDemo") ;

var oParam = oPSet.AddGridParameter( "mygrid" ) ;

var oLayout = oPSet.PPGLayout;

var oPPGItem = oLayout.AddItem( "mygrid", "", siControlGrid ) ;

oPPGItem.SetAttribute( "NoLabel", true ) ;

oPPGItem.SetAttribute( "LockColumnHeader", true ) ;

oPPGItem.SetAttribute( "CY", 300 ) ;

var oGridData = oParam.Value

oGridData.ColumnCount = 2 ;

oGridData.RowCount = 100 ;

oGridData.SetColumnLabel( 0, "Column 0" ) ;

oGridData.SetColumnLabel( 1, "Column 1" ) ;

for ( var i = 0 ; i < oGridData.RowCount ; i++ )

{

	oGridData.SetRowLabel( i, "Row " + i.toString() ) ;

}

oGridData.SetCell( "Column 0", "Row 25", "SomeData" ) ;

if ( oGridData.GetRowLabel( 25 ) != "Row 25" )

{

	Logmessage( "Unexpected" ) ;

}

InspectObj( oPSet ) ;

See Also

GridData.SetRowLabel GridData.GetColumnLabel