MaxLength プロパティ (TextCellType)

セルに保持できる最大文字数またはバイト数を取得または設定します。これは依存関係プロパティです。

シンタックス

Visual Basic
C#

'宣言
 
Public Property MaxLength As Integer

public int MaxLength {get; set;}

プロパティ値

MaxLengthUnit プロパティに従って決定される、コントロールに入力できる文字数またはバイト数。

既定値はゼロです。

例外

例外	解説
System.ArgumentException	指定された値が 0 未満です。

解説

MaxLength プロパティを使用して、ユーザーがセルに入力できる文字数を制限できます。既定値は０で、文字数が制限されないことを示します。０より大きい任意の数を指定すると、それが最大文字数になります。表示結果には、この MaxLength プロパティと共に MaxLengthUnit も影響します。

使用例

次のサンプルコードは TextCellTypeを作成し, このセルが大文字入力とスペース入力を許可し、6文字以上入力された場合は次のセルに移動するようにします。

C#
Visual Basic

public void SetTextCell5()
{
TextCellType textCellType1 = new TextCellType();

textCellType1.AutoConvert = true;
//The input characters will be converted to capital letters automatically and allow to input 'space' key.
textCellType1.Format = "AS";
//If you try to input 'grapecity' in cell, only the 'grape' is left.
textCellType1.MaxLength = 5;
textCellType1.MaxLengthUnit = GrapeCity.Windows.SpreadGrid.Editors.LengthUnit.Char;
//When you try to input 6th char, the focus will move next cell.
textCellType1.ExitOnLastChar = true;
//The input text will overwrite the existed character.
textCellType1.EditMode = GrapeCity.Windows.SpreadGrid.Editors.EditMode.Overwrite;

this._gcSpreadGrid1[0, 0].CellType = textCellType1;
}

Public Sub SetTextCell5()
Dim textCellType1 As New TextCellType()

textCellType1.AutoConvert = True
'The input characters will be converted to capital letters automatically and allow to input 'space' key.
textCellType1.Format = "AS"
'If you try to input 'grapecity' in cell, only the 'grape' is left.
textCellType1.MaxLength = 5
textCellType1.MaxLengthUnit = GrapeCity.Windows.SpreadGrid.Editors.LengthUnit.[Char]
'When you try to input 6th char, the focus will move next cell.
textCellType1.ExitOnLastChar = True
'The input text will overwrite the existed character.
textCellType1.EditMode = GrapeCity.Windows.SpreadGrid.Editors.EditMode.Overwrite

Me._gcSpreadGrid1(0, 0).CellType = textCellType1
End Sub

参照

TextCellType クラス
 TextCellType メンバ