Infragistics logo
메뉴
.NET and JavaScript UI Controls
Version

CellMultiLine Property (UltraGridColumn)

Determines if the cell's data should be displayed in a multi-line format.
Syntax
'Declaration
 
Public Property CellMultiLine As Infragistics.Win.DefaultableBoolean
public Infragistics.Win.DefaultableBoolean CellMultiLine {get; set;}
Remarks

This property controls the display of multiple lines of text in edit cells in the band or the grid controlled by the specified override. When True, text will wrap in the area of the cell. If the RowSizing property is set to automatically resize the row, the row will expand in height until all lines of text are displayed (or the number of lines specified by the RowSizingAutoMaxLines property is reached).

The CellMultiLine property does not pertain to multi-line editing, only display. Also, you should note that setting a cell to multi-line mode will disable data masking. Only single-line cells can be masked (using the MaskInput and MaskDisplayMode properties.)

Example
Following code enables displaying and inputting multiline text in a column.

Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinGrid

  Private Sub Button24_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button24.Click

      ' When CellMultiline is set to true on a column, the UltraGrid will display
      ' multiline text and also allow the user to enter multiline text. If 
      ' CellMultiline is set to false, any multiline text in cells will only display
      ' the first line.

      Dim column As UltraGridColumn = Me.UltraGrid1.DisplayLayout.Bands(0).Columns(0)

      ' Set the CellMultiline to true so the UltraGrid allows for multiline text
      ' in the column.
      column.CellMultiLine = DefaultableBoolean.True

      ' You can also set the VertScrollBar to true to show vertical scrollbar when
      ' a cell in the column is in edit mode.
      column.VertScrollBar = True

  End Sub
using Infragistics.Shared;
using Infragistics.Win;
using Infragistics.Win.UltraWinGrid;
using System.Diagnostics;

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

	// When CellMultiline is set to true on a column, the UltraGrid will display
	// multiline text and also allow the user to enter multiline text. If 
	// CellMultiline is set to false, any multiline text in cells will only display
	// the first line.

	UltraGridColumn column = this.ultraGrid1.DisplayLayout.Bands[0].Columns[0];

	// Set the CellMultiline to true so the UltraGrid allows for multiline text
	// in the column.
	column.CellMultiLine = DefaultableBoolean.True;

	// You can also set the VertScrollBar to true to show vertical scrollbar when
	// a cell in the column is in edit mode.
	column.VertScrollBar = true;

}
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