Infragistics logo
메뉴
.NET and JavaScript UI Controls
Version

RowSizingAutoMaxLines Property

Returns or sets the maximum number of lines a row will display when Auto-Sizing is enabled.
Syntax
'Declaration
 
Public Property RowSizingAutoMaxLines As Integer
public int RowSizingAutoMaxLines {get; set;}
Remarks

You can use the RowSizing property to specify that the control should automatically adjust the height of rows to accommodate multiple lines of text in the band or the grid controlled by the specified override. If a row contains one or more cells with the CellMultiLine property set to display more than one line of text, the row can resize itself so that all the text in the cell(s) is visible. Depending on the setting of RowSizing, just the row containing a multiline cell may be resized, or all the rows in the band or grid may be resized to match the one containing the multiline cell.

The RowSizingAutoMaxLines property is used to limit amount of row resizing the control will use to accommodate multiline cells. If one or more rows are being resized to display multiple lines of text, their height will only be increased enough to display the number of lines of text specified by this property. Use this property when you have rows that are being automatically resized and you want to display memo or long text fields in a multiline cell, but do not want rows growing too tall and disrupting the overall layout of the grid.

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
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;

}
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