PasswordChar プロパティ (CalendarTextBoxCellType)

CalendarTextBoxCellType でパスワードの文字をマスクするために使用される文字を取得または設定します。

構文

Visual Basic (宣言)
C#

Public Property PasswordChar As Char

public char PasswordChar {get; set;}

プロパティ値

CalendarTextBoxCellType に入力された文字をマスクするために使用される文字を表す System.Char 値。入力した文字をマスクしない場合は、値を '\0'（文字値）に設定します。既定値は '\0' です。

解説

UseSystemPasswordChar プロパティは、PasswordChar プロパティよりも優先されます。UseSystemPasswordChar が true に設定されている場合は常に、既定のシステムパスワード文字が使用され、PasswordChar で設定された文字は無視されます。

PasswordChar プロパティを使用している場合、このセルでキーボードを使用して切り取りまたはコピーを行うことはできません。そうすると、System.InvalidOperationException がスローされます。この場合、クリップボードには String.Empty が設定されます。ただし、編集モードのときは標準コントロールと同じように動作します。

重要:
PasswordChar、UseSystemPasswordChar、または ReadOnly が true に設定されている（または使用されている）ために CalendarTextBoxCellType がパスワードモードである場合、CalendarTextBoxCellType は制限モードになります。このモードでは、ImeMode は無効ですが、現在の ImeMode がキャッシュされるので、CalendarTextBoxCellType が制限モードでなくなった場合に ImeMode の値を復元できます。デザイナの観点から見ると、表示される ImeMode の値は実際の値です。

重要:

PasswordChar、UseSystemPasswordChar、または ReadOnly が true に設定されている（または使用されている）ために CalendarTextBoxCellType がパスワードモードである場合、CalendarTextBoxCellType は制限モードになります。このモードでは、ImeMode は無効ですが、現在の ImeMode がキャッシュされるので、CalendarTextBoxCellType が制限モードでなくなった場合に ImeMode の値を復元できます。デザイナの観点から見ると、表示される ImeMode の値は実際の値です。

使用例

次のサンプルコードは、CalendarTextBoxCellType のいくつかの重要なプロパティを示します。セルにテキスト全体を表示できない場合、省略記号文字列 "......" が表示されます。HighlightText プロパティが true に設定されているため、編集モードに入るとテキストが選択されます。MaxLength は 10 なので、元のテキストを削除してテキストを入力する場合、10 文字だけ入力できます。大文字のテキストは小文字に変換されます。このサンプルコードは、CalendarTextBoxCellType クラスに示されている詳細なコード例の一部を抜粋したものです。

C#
Visual Basic

private void Form1_Load(object sender, EventArgs e)
{
    CalendarTextBoxCellType textBoxCell1 = new CalendarTextBoxCellType();
    //If the text cannot display completely, one '......' string will be shown at the text's end, hover the cell, the whole text will be shown in tool tip.
    textBoxCell1.Ellipsis = CalendarGridEllipsisMode.EllipsisEnd;
    textBoxCell1.EllipsisString = "......";
    //Enter the edit mode, the text will be highlight selected.
    textBoxCell1.HighlightText = true;
    textBoxCell1.MaxLength = 10;
    //The value will be casted to lower case.
    textBoxCell1.CharacterCasing = CharacterCasing.Lower;

    CalendarTextBoxCellType textBoxCell2 = new CalendarTextBoxCellType();
    //Input text in textBoxCell2, it will be treated as password, always display '#'.
    textBoxCell2.PasswordChar = '#';
    textBoxCell2.UseSystemPasswordChar = false;

    CalendarTemplate template1 = CalendarTemplate.CreateDefaultTemplate();
    template1.Content[1, 0].CellType = textBoxCell1;
    template1.Content[1, 0].Value = "DELETE THIS STRING TO INPUT BY YOURSELF, ONLY 10 CHARACTERS CAN BE INPUT";
    template1.Content[2, 0].CellType = textBoxCell2;
    template1.Content[2, 0].Value = "12345";

    gcCalendarGrid1.Template = template1;
}

Private Sub Form1_Load(sender As Object, e As EventArgs)
    Dim textBoxCell1 As New CalendarTextBoxCellType()
    'If the text cannot display completely, one '......' string will be shown at the text's end, hover the cell, the whole text will be shown in tool tip.
    textBoxCell1.Ellipsis = CalendarGridEllipsisMode.EllipsisEnd
    textBoxCell1.EllipsisString = "......"
    'Enter the edit mode, the text will be highlight selected.
    textBoxCell1.HighlightText = True
    textBoxCell1.MaxLength = 10
    'The value will be casted to lower case.
    textBoxCell1.CharacterCasing = CharacterCasing.Lower

    Dim textBoxCell2 As New CalendarTextBoxCellType()
    'Input text in textBoxCell2, it will be treated as password, always display '#'.
    textBoxCell2.PasswordChar = "#"c
    textBoxCell2.UseSystemPasswordChar = False

    Dim template1 As CalendarTemplate = CalendarTemplate.CreateDefaultTemplate()
    template1.Content(1, 0).CellType = textBoxCell1
    template1.Content(1, 0).Value = "DELETE THIS STRING TO INPUT BY YOURSELF, ONLY 10 CHARACTERS CAN BE INPUT"
    template1.Content(2, 0).CellType = textBoxCell2
    template1.Content(2, 0).Value = "12345"

    gcCalendarGrid1.Template = template1
End Sub

参照

CalendarTextBoxCellType クラス
 CalendarTextBoxCellType メンバ