Infragistics logo
메뉴
.NET and JavaScript UI Controls
Version 24.2 (latest)

RowSizing Property

Returns or sets a value that determines the type of row sizing.
Syntax
public RowSizing RowSizing {get; set;}
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.

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

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
'Declaration
 
Public Property RowSizing As RowSizing
 
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;

}
'Declaration
 
Public Property RowSizing As RowSizing
 
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