Multiline プロパティ (GcTextBox)

複数行のテキストの入力と表示を可能にするかどうかを取得または設定します。

構文

Visual Basic (宣言)
C#

Public Property Multiline As Boolean

public bool Multiline {get; set;}

プロパティ値

値	説明
True	コントロールに複数行のテキストを入力および表示きます。
False	改行コードが無効になり、複数行にはできません。

既定値はFalseです。

解説

MultiLine プロパティがTrueに設定されている場合、 WrapMode プロパティをWordWrapあるいはCharWrapにすると、入力されたテキストは、自動的に次の行に折り返されます。 WrapMode プロパティをNoWrapにすると、改行文字が入力されるまで次の行へは折り返されません。

スクロールバーを表示するには、ScrollBars プロパティを使用します。また、ScrollBarMode プロパティで、スクロールバーを常に表示するか、コンテキストに応じて自動的に表示させるかを指定できます。

MultiLine プロパティをTrueにした場合のキーボード操作は、 AcceptsReturn プロパティと AcceptsTab プロパティの設定内容により異なります。詳細は、これらのプロパティの項目を参照してください。

MultiLine プロパティがTrueのとき、Microsoft.VisualBasic.Strings.Chr( 10 )と Microsoft.VisualBasic.Strings.Chr( 13 )で表される改行復帰文字が有効になります。 MultiLine プロパティがFalseのときでも、これらの文字コードをコーディングまたはコピー＆ペーストによってText プロパティに設定することが可能です。ただし、この設定は、MultiLine プロパティがTrueに設定されるまで有効にはなりません。

また、MultiLine プロパティがFalseの場合、エンドユーザーがタブおよび改行復帰文字をキーボードから入力することはできません。 MultiLine プロパティがTrueのときにエンドユーザーによるタブ文字入力を有効にするには、 AcceptsTab プロパティをTrueに設定する必要があります。

使用例

C#
Visual Basic

//  Please use the following namespace
//  using System.Windows.Forms;
//  using GrapeCity.Win.Editors;

public void CreateMultilineGcTextBox()
{
    // Create an instance of a GcTextBox control.
    GcTextBox gcTextBox1 = new GcTextBox();

    // Set the Multiline property to true.
    gcTextBox1.Multiline = true;
    // Add vertical scroll bars to the GcTextBox control.
    gcTextBox1.ScrollBars = ScrollBars.Vertical;
    // Allow the RETURN key in the GcTextBox control.
    gcTextBox1.AcceptsReturn = true;
    // Allow the TAB key to be entered in the GcTextBox control.
    gcTextBox1.AcceptsTab = true;
    // Set WrapMode to WrapMode.WordWrap to allow text to wrap to the next line.
    gcTextBox1.WrapMode = GrapeCity.Win.Editors.WrapMode.WordWrap;
    // Set the default text of the control.
    gcTextBox1.Text = "Power Tools!" + Environment.NewLine + "This is the second line.";
}

'  Please use the following namespace
'  Imports System.Windows.Forms
'  Imports GrapeCity.Win.Editors

Public Sub CreateGcMultilineTextBox()
    ' Create an instance of a GcTextBox control.
    Dim gcTextBox1 As New GcTextBox()

    ' Set the Multiline property to true.
    gcTextBox1.Multiline = True
    ' Add vertical scroll bars to the GcTextBox control.
    gcTextBox1.ScrollBars = ScrollBars.Vertical
    ' Allow the RETURN key in the GcTextBox control.
    gcTextBox1.AcceptsReturn = True
    ' Allow the TAB key to be entered in the GcTextBox control.
    gcTextBox1.AcceptsTab = True
    ' Set WrapMode to WrapMode.WordWrap to allow text to wrap to the next line.
    gcTextBox1.WrapMode = GrapeCity.Win.Editors.WrapMode.WordWrap
    ' Set the default text of the control.
    gcTextBox1.Text = "Power Tools!" + Environment.NewLine + "This is the second line."
End Sub

参照

GcTextBox クラス
 GcTextBox メンバ
 ScrollBars プロパティ
 AcceptsReturn プロパティ
 AcceptsTab プロパティ
 WrapMode プロパティ