Version

SetRowHeaderColumnWidth Method

Sets the graphical width of the specified row header column.
Syntax
'Declaration
 
Public Sub SetRowHeaderColumnWidth( _
   ByVal columnIndex As Integer, _
   ByVal value As Integer _
) 
public void SetRowHeaderColumnWidth( 
   int columnIndex,
   int value
)

Parameters

columnIndex
value
Remarks

Row headers are arranged differently depending on the value of the RowHeaderLayout property.

When RowHeaderLayout is set to 'Standard', each level of each hierarchy occupies one logical column. A row axis containing (for example) three hierarchies, each with two levels results in six logical columns. In this case, specifying a value of five changes the size of the last column (the second level of the third hierarchy).

When RowHeaderLayout is set to 'Compact' or 'SuperCompact', each header column corresponds to a single hierarchy. Individual levels cannot be resized, since with the compact layouts, headers deeper than level zero are nested within the 'parent' header. To change the width of the last column of row headers, the value of the columnIndex parameter would be specified as (n - 1), where n represents the total number of hierarchies on the row axis.

Specifying a value of zero for the value parameter restores the width of the column to its default setting.

Specifying a value less than zero for either parameter causes an exception to be thrown. Specifying a value greater than the index of the last column, however, is permitted; in this case the setting takes effect when enough hierarchies are added to the row axis such that the number previously specified now represents a valid index. In the case of the 'Standard' row header layout, this may also happen when additional levels are expanded, since that action also causes the number of row header columns to increase.

Once a row header column's width is explicitly set, either programmatically or by the end user, the value persists for the lifetime of the control. To reset any given column's width, specify zero for the value parameter. To reset all column widths in one atomic operation, use the ResetAllRowHeaderColumnWidths method.

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, 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