RichTextBox.MaxLength Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

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 je text přiřazen k ovládacímu RichTextBox prvku 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 k ovládacímu prvku. Tento příklad vyžaduje, aby RichTextBox byl do formuláře přidán ovládací prvek s názvem richTextBox1a aby byla volána metoda v příkladu s textem zadaným parametru, který má být vložen do ovládacího prvku. Příklad také vyžaduje, aby vlastnost MaxLength byla nastavena na hodnotu, která omezuje 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 hodnotu 0, je maximální délka textu, který lze zadat do ovládacího prvku, 64 kB znaků. Tato vlastnost se obvykle používá, pokud 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 k omezení délky 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 ovlivňuje pouze text zadaný do ovládacího prvku za běhu.

Viz také

• MaxLength