MaxLength プロパティ

この UltraTreeNodeColumn に関連付けられたセルでエンドユーザーが入力できる最大文字数を取得または設定します。

シンタックス

Visual Basic

'宣言
 
Public Property MaxLength As Integer

C#

public int MaxLength {get; set;}

解説

注: デフォルト値は 0 で、制限がないことを示します。

UltraTreeNodeColumn が基になる System.Data.DataColumn を表していて、 MaxLengthプロパティの値がデフォルトのままの場合は、DataColumnのMaxLengthプロパティによって有効な値が定義されます。

DataColumnの MaxLength プロパティを利用するときは、関連付けられたDataAdapterの MissingSchemaAction プロパティを必ず MissingSchemaAction.AddWithKey に設定してください。そうしないと、予期しない動作が発生します。

使用例

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