TextBoxBase.Multiline 속성

정의

이 컨트롤이 여러 줄을 입력할 수 있는 TextBox 컨트롤인지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether this is a multiline text box control.

public:
 virtual property bool Multiline { bool get(); void set(bool value); };
public virtual bool Multiline { get; set; }
member this.Multiline : bool with get, set
Public Overridable Property Multiline As Boolean

속성 값

컨트롤이 여러 줄을 입력할 수 있는 TextBox 컨트롤이면 true이고, 그렇지 않으면 false입니다.true if the control is a multiline text box control; otherwise, false. 기본값은 false입니다.The default is false.

예제

다음 코드 예제에서는 TextBox, 파생 클래스를 여러 줄을 만들려면 TextBox 세로 스크롤 막대를 사용 하 여 제어 합니다.The following code example uses TextBox, a derived class, to create a multiline TextBox control with vertical scroll bars. 또한이 예제에서는 합니다 AcceptsTab, AcceptsReturn, 및 WordWrap 속성을 여러 줄 텍스트 상자 컨트롤을 텍스트 문서를 만드는 데 유용 합니다.This example also uses the AcceptsTab, AcceptsReturn, and WordWrap properties to make the multiline text box control useful for creating text documents.

public:
   void CreateMyMultilineTextBox()
   {
      // Create an instance of a TextBox control.
      TextBox^ textBox1 = gcnew TextBox;
      
      // Set the Multiline property to true.
      textBox1->Multiline = true;
      // Add vertical scroll bars to the TextBox control.
      textBox1->ScrollBars = ScrollBars::Vertical;
      // Allow the RETURN key in the TextBox control.
      textBox1->AcceptsReturn = true;
      // Allow the TAB key to be entered in the TextBox control.
      textBox1->AcceptsTab = true;
      // Set WordWrap to true to allow text to wrap to the next line.
      textBox1->WordWrap = true;
      // Set the default text of the control.
      textBox1->Text = "Welcome!" + Environment::NewLine + "Second Line";
   }
public void CreateMyMultilineTextBox()
 {
    // Create an instance of a TextBox control.
    TextBox textBox1 = new TextBox();
    
    // Set the Multiline property to true.
    textBox1.Multiline = true;
    // Add vertical scroll bars to the TextBox control.
    textBox1.ScrollBars = ScrollBars.Vertical;
    // Allow the RETURN key in the TextBox control.
    textBox1.AcceptsReturn = true;
    // Allow the TAB key to be entered in the TextBox control.
    textBox1.AcceptsTab = true;
    // Set WordWrap to true to allow text to wrap to the next line.
    textBox1.WordWrap = true;
    // Set the default text of the control.
    textBox1.Text = "Welcome!" + Environment.NewLine + "Second Line";
 }
Public Sub CreateMyMultilineTextBox()
    ' Create an instance of a TextBox control.
    Dim textBox1 As New TextBox()
    
    ' Set the Multiline property to true.
    textBox1.Multiline = True
    ' Add vertical scroll bars to the TextBox control.
    textBox1.ScrollBars = ScrollBars.Vertical
    ' Allow the RETURN key in the TextBox control.
    textBox1.AcceptsReturn = True
    ' Allow the TAB key to be entered in the TextBox control.
    textBox1.AcceptsTab = True
    ' Set WordWrap to true to allow text to wrap to the next line.
    textBox1.WordWrap = True
    ' Set the default text of the control.
    textBox1.Text = "Welcome!" & Environment.NewLine & "Second Line"
End Sub

설명

여러 줄 텍스트 상자를 사용 하면 두 줄 이상의 텍스트 컨트롤에 표시할 수 있습니다.A multiline text box allows you to display more than one line of text in the control. 경우는 WordWrap 속성이 true, 여러 줄 텍스트 상자에 입력 한 텍스트 컨트롤의 다음 줄으로 줄 바꿈됩니다.If the WordWrap property is set to true, text entered into the multiline text box is wrapped to the next line in the control. 경우는 WordWrap 속성이 false, 여러 줄 텍스트 상자 컨트롤에 입력 한 텍스트 줄 바꿈 문자를 입력할 때까지 동일한 줄에 표시 됩니다.If the WordWrap property is set to false, text entered into the multiline text box control will be displayed on the same line until a newline character is entered.

다음 줄 바꿈 문자로 사용할 수 있습니다.The following can be used as newline characters:

  • Environment.NewLine

  • ControlChars.CrLfControlChars.CrLf

  • vbCrLf (Visual Basic만 해당)vbCrLf (Visual Basic only)

스크롤 막대를 사용 하 여 텍스트 상자에 추가할 수 있습니다는 ScrollBars 속성을 가로 및/또는 세로 스크롤 막대를 표시 합니다.You can add scroll bars to a text box using the ScrollBars property to display horizontal and/or vertical scroll bars. 이 컨트롤의 크기를 초과 하는 텍스트를 스크롤할 수 있습니다.This allows the user to scroll through the text that extends beyond the dimensions of the control.

참고

때문에 기본값인은 Multiline 속성은 false의 기본 크기를 TextBox 크기를 조정 하는 경우에 글꼴 크기에 따라 수는 TextBox합니다.Because the default value of the Multiline property is false, the default size of a TextBox will be in accordance with the font size even if you resize the TextBox. 에 대 한 일관 된 크기를 가져오려면 사용자 TextBox설정, 해당 Multiline 속성을 true입니다.To get a consistent size for your TextBox, set its Multiline property to true.

참고

일본어 운영 체제의 경우는 Multiline 속성이로 설정 되어 true설정의 PasswordChar 속성 시스템 보안을 손상 시킬 암호의 텍스트가 표시 됩니다.On Japanese operating systems, if the Multiline property is set to true, setting the PasswordChar property will display the text of the password, thus compromising system security. 따라서 일본어 운영 체제를 설정 합니다 Multiline 속성을 false 설정 하는 경우는 PasswordChar 속성입니다.Therefore, on Japanese operating systems, set the Multiline property to false if you set the PasswordChar property.

참고

이 속성이 false 모두에 대해 기본적으로의 경우는 예외 클래스를 파생 합니다 RichTextBox 컨트롤입니다.This property is set to false by default for all derived classes, with the exception of the RichTextBox control.

에 대 한를 RichTextBox 컨트롤을 RichTextBox.Multiline 속성 컨트롤을 자동으로 조정할지를 다음과 같이 여부에 영향을 줍니다.For a RichTextBox control, the RichTextBox.Multiline property affects whether or not the control will automatically resize, as follows:

적용 대상

추가 정보