Infragistics(R) NetAdvantage(R) Windows Forms
RowSizing Property
See Also  Example E-mail your feedback on this topic.
Infragistics.Win.UltraWinGrid Namespace > UltraGridOverride Class : RowSizing Property

Returns or sets a value that determines the type of row sizing.

Syntax

Visual Basic (Declaration) 
Public Property RowSizing As RowSizing
C# 
public RowSizing RowSizing {get; set;}

Example

Following code sets some of the properties available for controlling row sizing.

Visual BasicCopy Code
Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinGrid

  Private Sub Button79_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button79.Click

      ' Set the RowSizing on the layout's override to Free so the rows in the UltraGrid
      ' can be resized independently. By default, row heights are syncronized so when one
      ' row is resized, all the rows in that band will be rezied to that height.
      Me.UltraGrid1.DisplayLayout.Override.RowSizing = RowSizing.Free

      ' Set DefaultRowHeight off the layout's override to 20 so all the rows in the UltraGrid
      ' are sized to 20.
      Me.UltraGrid1.DisplayLayout.Override.DefaultRowHeight = 20

      ' RowSizingArea indicates which part of a row can be used to resize the row. By default,
      ' the user can resize rows using the row-selectors. You can set it to EntireRow to allow
      ' resizing using the entire row and not just the row-selector.
      Me.UltraGrid1.DisplayLayout.Override.RowSizingArea = RowSizingArea.EntireRow

      ' You can override that grid-wide setting for a particular band by setting it on the
      ' override of that band. Set the RowSizing to Fixed to prevent the user from reszing
      ' rows.
      Me.UltraGrid1.DisplayLayout.Bands(1).Override.RowSizing = RowSizing.Fixed
      Me.UltraGrid1.DisplayLayout.Bands(1).Override.DefaultRowHeight = 40

      ' With the RowSizing modes of AutoFree and AutoFixed, the UltraGrid resizes the rows
      ' based on its contents. By default, the UltraGrid will resize the row without any 
      ' limit. You can use the RowSizingAutoMaxLines property to limit the row-autosizing
      ' to a certain number of lines.
      Me.UltraGrid1.DisplayLayout.Bands(2).Override.RowSizing = RowSizing.AutoFree
      Me.UltraGrid1.DisplayLayout.Bands(2).Override.RowSizingAutoMaxLines = 5

  End Sub
C#Copy Code
using Infragistics.Shared;
using Infragistics.Win;
using Infragistics.Win.UltraWinGrid;
using System.Diagnostics;

private void button79_Click(object sender, System.EventArgs e)
{

	// Set the RowSizing on the layout's override to Free so the rows in the UltraGrid
	// can be resized independently. By default, row heights are syncronized so when one
	// row is resized, all the rows in that band will be rezied to that height.
	this.ultraGrid1.DisplayLayout.Override.RowSizing = RowSizing.Free;

	// Set DefaultRowHeight off the layout's override to 20 so all the rows in the UltraGrid
	// are sized to 20.
	this.ultraGrid1.DisplayLayout.Override.DefaultRowHeight = 20;

	// RowSizingArea indicates which part of a row can be used to resize the row. By default,
	// the user can resize rows using the row-selectors. You can set it to EntireRow to allow
	// resizing using the entire row and not just the row-selector.
	this.ultraGrid1.DisplayLayout.Override.RowSizingArea = RowSizingArea.EntireRow;

	// You can override that grid-wide setting for a particular band by setting it on the
	// override of that band. Set the RowSizing to Fixed to prevent the user from reszing
	// rows.
	this.ultraGrid1.DisplayLayout.Bands[1].Override.RowSizing = RowSizing.Fixed;
	this.ultraGrid1.DisplayLayout.Bands[1].Override.DefaultRowHeight = 40;

	// With the RowSizing modes of AutoFree and AutoFixed, the UltraGrid resizes the rows
	// based on its contents. By default, the UltraGrid will resize the row without any 
	// limit. You can use the RowSizingAutoMaxLines property to limit the row-autosizing
	// to a certain number of lines.
	this.ultraGrid1.DisplayLayout.Bands[2].Override.RowSizing = RowSizing.AutoFree;
	this.ultraGrid1.DisplayLayout.Bands[2].Override.RowSizingAutoMaxLines = 5;

}

Remarks

The RowSizing property specifies whether the user can resize rows using the mouse in the band or the grid controlled by the specified override and, if they can, how that resizing is accomplished. The grid can also resize rows automatically, based on the amount of data present in the cells that make up the row. If one cell contains a large amount of text, the row can be resized to accommodate all the text, or a particular number of lines of text, provided the cell is capable of displaying multiple lines of text. The RowSizing property also determines whether rows are resized independently of one another, or whether their heights are synchronized.

When using one of the auto-sizing settings, the size of each row is determined by the number of lines of text required to display the contents of a cell. The cell in the row that displays the most lines of text determines the size of the entire row. The CellMultiLine property is used to specify whether the text in a cell will wrap to multiple lines. You can limit the number of lines used by setting the RowSizingAutoMaxLines property.

See Also