MaxLength プロパティ (SuperEditBase)

コントロール内に入力または貼り付け可能な最大文字数を取得または設定します。

構文

Visual Basic
C#

public virtual int MaxLength {get; set;}

'Declaration
 
Public Overridable Property MaxLength As Integer

'使用法
 
Dim instance As SuperEditBase
Dim value As Integer
 
instance.MaxLength = value
 
value = instance.MaxLength

プロパティ値

最大文字数を表すInteger

解説

ユーザーまたはコードがコントロールの最大長を超える文字を挿入または提供しようとすると、UserErrorイベントが発生します。コントロールがフォーカスを失うまで検証しないようにするには、UserEntryプロパティをUserEntry.FreeFormatに設定します。UserEntryプロパティをFreeFormatに設定した場合、ユーザーまたはコードがコントロールの最大長を超える文字を挿入または提供すると、コントロールがフォーカスを失ったときにInvalidDataイベントが発生します。

注意：コントロールをMaxLengthプロパティで指定した上限値を超える文字を含むデータベースフィールドに連結した場合、データベースからのデータはコントロール内でトランケートされます。値を変更した場合、変更された値（トランケートされている可能性があります）がデータベースに書き込まれます。

このプロパティが使用できるのは実行時のみです。

例

control.EditModeCursorPosition = FarPoint.Win.EditModeCursorPosition.LastKnownPosition;
control.Text = "This is a test for HideSelection";
control.ControlType = FarPoint.Win.ControlType.Normal;
control.SelectionStart = 2;
control.SelectionLength = 5;
control.Selectable = true;
control.HideSelection = false;
control.AutoMenu = true;
textBox1.Text = control.SelectedText();
control.MaxLength = 9;

Visual Basic

control.EditModeCursorPosition = FarPoint.Win.EditModeCursorPosition.LastKnownPosition
control.Text = "This is a test for HideSelection"
control.ControlType = FarPoint.Win.ControlType.Normal
control.SelectionStart = 2
control.SelectionLength = 5
control.Selectable = True
control.HideSelection = False
control.AutoMenu = True
TextBox1.Text = control.SelectedText()
control.MaxLength = 9

参照

SuperEditBase クラス
 SuperEditBase メンバ
 InvalidData イベント
 UserEntry プロパティ
 UserError イベント