RichTextBox.MaxLength Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

RichTextBox.cs

Získá nebo nastaví maximální počet znaků, které uživatel může zadat nebo vložit do ovládacího prvku formátovaného textového pole.

public:
 virtual property int MaxLength { int get(); void set(int value); };

public override int MaxLength { get; set; }

member this.MaxLength : int with get, set

Public Overrides Property MaxLength As Integer

Hodnota vlastnosti

Int32

Počet znaků, které lze zadat do ovládacího prvku. Výchozí hodnota je Int32.MaxValue.

Výjimky

ArgumentException

Hodnota přiřazená vlastnosti je menší než 0.

Příklady

Následující příklad kódu ukazuje, jak použít MaxLength vlastnost k určení, zda text přiřazen k ovládacímu RichTextBox prvku je větší než hodnota přiřazená MaxLength vlastnosti. Pokud text není větší, použije příklad SelectedText vlastnost k přiřazení textu ovládacímu prvku. Tento příklad vyžaduje, aby RichTextBox ovládací prvek s názvem richTextBox1, byl přidán do formuláře a že metoda v příkladu je volána s textem zadaným do parametru, který má být vložen do ovládacího prvku. Příklad také vyžaduje, aby MaxLength vlastnost byla nastavena na hodnotu pro omezení zadávání textu do objektu RichTextBox.

private:
   void AddMyText( String^ textToAdd )
   {
      // Determine if the text to add is larger than the max length property.
      if ( textToAdd->Length > richTextBox1->MaxLength )
         // Alert user text is too large.
         MessageBox::Show( "The text is too large to add to the RichTextBox" ); // Add the text to be added to the control.
      else
         richTextBox1->SelectedText = textToAdd;
   }

private void AddMyText(string textToAdd)
{
    // Determine if the text to add is larger than the max length property.
    if (textToAdd.Length > richTextBox1.MaxLength)
        // Alert user text is too large.
        MessageBox.Show("The text is too large to addo to the RichTextBox");
    else
        // Add the text to be added to the control.
        richTextBox1.SelectedText = textToAdd;
}

Private Sub AddMyText(ByVal textToAdd As String)
    ' Determine if the text to add is larger than the max length property.
    If textToAdd.Length > richTextBox1.MaxLength Then
        ' Alert user text is too large.
        MessageBox.Show("The text is too large to addo to the RichTextBox")
        ' Add the text to be added to the control.
    Else
        richTextBox1.SelectedText = textToAdd
    End If
End Sub

Poznámky

Pokud je tato vlastnost nastavena na 0, maximální délka textu, který lze zadat do ovládacího prvku, je 64 kB znaků. Tato vlastnost se obvykle používá, když RichTextBox se používá k zobrazení jednoho řádku textu ve formátu RTF (RTF). Tuto vlastnost můžete použít k omezení délky textu zadaného v ovládacím prvku pro hodnoty, jako jsou PSČ a telefonní čísla, nebo omezit délku textu zadaného při zadávání dat do databáze. Text zadaný do ovládacího prvku můžete omezit na maximální délku odpovídajícího pole v databázi.

Poznámka:

V kódu můžete nastavit hodnotu Text vlastnosti na hodnotu, která má délku větší než hodnota určená MaxLength vlastností. Tato vlastnost má vliv pouze na text zadaný do ovládacího prvku za běhu.

Viz také

• MaxLength