EllipsisString プロパティ (TextBoxCell)

TextBoxCellの省略記号文字列を取得または設定します。

構文

Visual Basic (宣言)
C#

Public Property EllipsisString As String

public string EllipsisString {get; set;}

プロパティ値

TextBoxCellの省略記号文字列を表すSystem.String値。既定値は...です。

解説

このプロパティはEllipsisと組み合わせて使用します。

'\r'、'\n'、'\t'などの特殊文字を含む文字列を設定した場合、その特殊文字は無視されます。

セルの一部のスタイル（CellStyle.Multiline、CellStyle.TextAngle、CellStyle.TextAdjustment、CellStyle.LineAdjustmentなど）が使用されている場合、省略記号文字列は表示できません。

使用例

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

C#
Visual Basic

private void Form1_Load(object sender, EventArgs e)
{
    TextBoxCell textBoxCell1 = new TextBoxCell();
    //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 = MultiRowEllipsisMode.EllipsisEnd;
    textBoxCell1.EllipsisString = "......";
    //Enter the edit mode, the text will be highlight selected.
    textBoxCell1.HighlightText = true;
    textBoxCell1.Value = "DELETE THIS STRING TO INPUT BY YOURSELF, ONLY 10 CHARACTERS CAN BE INPUT";
    textBoxCell1.MaxLength = 10;
    //The value will be casted to lower case.
    textBoxCell1.CharacterCasing = CharacterCasing.Lower;

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

    Template template1 = Template.CreateGridTemplate(new Cell[] { textBoxCell1, textBoxCell2 }, 160,
        AutoGenerateGridTemplateStyles.ColumnHeader | AutoGenerateGridTemplateStyles.RowHeaderAutoNumber);

    gcMultiRow1.Template = template1;
    gcMultiRow1.RowCount = 3;
}

Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Load
    Dim textBoxCell1 As New TextBoxCell()
    '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 = MultiRowEllipsisMode.EllipsisEnd
    textBoxCell1.EllipsisString = "......"
    'Enter the edit mode, the text will be highlight selected.
    textBoxCell1.HighlightText = True
    textBoxCell1.Value = "DELETE THIS STRING TO INPUT BY YOURSELF, ONLY 10 CHARACTERS CAN BE INPUT"
    textBoxCell1.MaxLength = 10
    'The value will be casted to lower case.
    textBoxCell1.CharacterCasing = CharacterCasing.Lower

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

    Dim template1 As Template = Template.CreateGridTemplate(New Cell() {textBoxCell1, textBoxCell2})

    gcMultiRow1.Template = template1
    gcMultiRow1.RowCount = 3
End Sub

参照

TextBoxCell クラス
 TextBoxCell メンバ
 Ellipsis プロパティ