MaxLength Property

Gets/sets the maximum number of characters that are accepted for input by the end user in the cells associated with this UltraTreeNodeColumn.

Syntax

Visual Basic

'Declaration
 
Public Property MaxLength As Integer

C#

public int MaxLength {get; set;}

Remarks

Note: The default value, 0, indicates that no limit is imposed.

In the case where the UltraTreeNodeColumn represents an underlying System.Data.DataColumn, and the value of the MaxLength property is left at its default, the MaxLength property of that DataColumn defines the effective value.

When relying on the MaxLength property of a DataColumn, be sure to set the MissingSchemaAction property of the associated DataAdapter to MissingSchemaAction.AddWithKey; neglecting to do this will result in unexpected behavior.

Example

The following code sample demonstrates how to use the cell editing related properties pf the UltraTreeNodeColumn to customize the cell editing functionality for a particular column:

Visual Basic

Imports Infragistics.Win
Imports Infragistics.Win.UltraWinTree

    Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click

        Dim columnQuantity As UltraTreeNodeColumn = Me.ultraTree1.ColumnSettings.ColumnSets("Order Details").Columns("Quantity")
        Dim columnDiscount As UltraTreeNodeColumn = Me.ultraTree1.ColumnSettings.ColumnSets("Order Details").Columns("Discount")
        Dim columnProduct As UltraTreeNodeColumn = Me.ultraTree1.ColumnSettings.ColumnSets("Order Details").Columns("ProductID")

        '	Set the 'Quantity' column to have a ForeColor of blue for
        '	the active cell, allow editing, and restrict the number of
        '	characters accepted for input so that the end user cannot
        '	enter a value greater than 99. Also, don't allow null values.
        columnQuantity.ActiveCellAppearance.ForeColor = Color.Blue
        columnQuantity.AllowCellEdit = AllowCellEdit.Full
        columnQuantity.MaxLength = 2
        columnQuantity.Nullable = Nullable.Disallow

        '	make the 'Discount' column read-only.
        columnDiscount.AllowCellEdit = AllowCellEdit.ReadOnly

        '	Enable tooltips for the 'Product' column, since the
        '	name of the product might not always be fully visible.
        columnProduct.TipStyleCell = TipStyleCell.Show
    End Sub

C#

using Infragistics.Win;
using Infragistics.Win.UltraWinTree;
using System.Diagnostics;

		private void button3_Click(object sender, System.EventArgs e)
		{
			UltraTreeNodeColumn columnQuantity = this.ultraTree1.ColumnSettings.ColumnSets["Order Details"].Columns["Quantity"];
			UltraTreeNodeColumn columnDiscount = this.ultraTree1.ColumnSettings.ColumnSets["Order Details"].Columns["Discount"];
			UltraTreeNodeColumn columnProduct = this.ultraTree1.ColumnSettings.ColumnSets["Order Details"].Columns["ProductID"];

			//	Set the 'Quantity' column to have a ForeColor of blue for
			//	the active cell, allow editing, and restrict the number of
			//	characters accepted for input so that the end user cannot
			//	enter a value greater than 99. Also, don't allow null values.
			columnQuantity.ActiveCellAppearance.ForeColor = Color.Blue;
			columnQuantity.AllowCellEdit = AllowCellEdit.Full;
			columnQuantity.MaxLength = 2;
			columnQuantity.Nullable = Nullable.Disallow;

			//	make the 'Discount' column read-only.
			columnDiscount.AllowCellEdit = AllowCellEdit.ReadOnly;

			//	Enable tooltips for the 'Product' column, since the
			//	name of the product might not always be fully visible.
			columnProduct.TipStyleCell = TipStyleCell.Show;
		}

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