Delen via

Overzicht van tekstvak

Met de TextBox-klasse kunt u niet-opgemaakte tekst weergeven of bewerken. Een algemeen gebruik van een TextBox is het bewerken van niet-opgemaakte tekst in een formulier. Een formulier waarin bijvoorbeeld wordt gevraagd om de naam, het telefoonnummer van de gebruiker, enzovoort, gebruikt TextBox besturingselementen voor tekstinvoer. In dit onderwerp wordt de TextBox-klasse geïntroduceerd en vindt u voorbeelden van het gebruik ervan in zowel Extensible Application Markup Language (XAML) als C#.

Tekstvak of RichTextBox?

Met zowel TextBox als RichTextBox kunnen gebruikers tekst invoeren, maar de twee besturingselementen worden gebruikt voor verschillende scenario's. A TextBox vereist minder systeembronnen dan een RichTextBox zodat het ideaal is wanneer alleen tekst zonder opmaak moet worden bewerkt (dat wil bijvoorbeeld het gebruik in een formulier). Een RichTextBox is een betere keuze wanneer de gebruiker opgemaakte tekst, afbeeldingen, tabellen of andere ondersteunde inhoud moet bewerken. Als u bijvoorbeeld een document, artikel of blog bewerkt waarvoor opmaak, afbeeldingen, enzovoort is vereist, kunt u het beste een RichTextBoxgebruiken. De onderstaande tabel bevat een overzicht van de primaire functies van TextBox en RichTextBox.

Beheersing Spellingcontrole in realtime Contextmenu Opmaakopdrachten zoals ToggleBold (Ctr+B) FlowDocument-inhoud, zoals afbeeldingen, alinea's, tabellen, enzovoort.
TextBox Ja Ja Nee. Nee.
RichTextBox Ja Ja Ja (zie RichTextBox-overzicht) Ja (zie RichTextBox-overzicht)

Opmerking

Hoewel TextBox geen ondersteuning biedt voor het opmaken van bewerkingsopdrachten zoals ToggleBold (Ctr+B), worden veel basisopdrachten ondersteund door beide besturingselementen, zoals MoveToLineEnd. Zie EditingCommands voor meer informatie.

Functies die door TextBox worden ondersteund, worden behandeld in de onderstaande secties. Zie RichTextBoxvoor meer informatie over .

Spellingcontrole in realtime

U kunt realtime spellingcontrole inschakelen in een TextBox of RichTextBox. Wanneer spellingcontrole is ingeschakeld, verschijnt er een rode lijn onder verkeerd gespelde woorden (zie de onderstaande afbeelding).

tekstvak met spellingcontrole

Zie Spellingcontrole inschakelen in een besturingselement voor tekstbewerking voor meer informatie over het inschakelen van spellingcontrole.

Contextmenu

Standaard hebben zowel TextBox als RichTextBox een contextmenu dat wordt weergegeven wanneer een gebruiker met de rechtermuisknop in de controle klikt. Met het contextmenu kan de gebruiker knippen, kopiëren of plakken (zie de onderstaande afbeelding).

tekstvak met contextmenu

U kunt uw eigen aangepaste contextmenu maken om het standaardgedrag te overschrijven. Zie Een aangepast contextmenu gebruiken met een tekstvak voor meer informatie.

Tekstvakken maken

Een TextBox kan één lijn in hoogte zijn of uit meerdere lijnen bestaan. Eén regel TextBox is het beste voor het invoeren van kleine hoeveelheden tekst zonder opmaak (bijvoorbeeld 'Naam', 'Telefoonnummer', enzovoort) in een formulier). In het volgende voorbeeld ziet u hoe u één regel TextBoxmaakt.

<Page  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
  <StackPanel>
    <TextBox Width="200" MaxLength="100" />
  </StackPanel>
</Page>

U kunt ook een TextBox maken waarmee de gebruiker meerdere regels tekst kan invoeren. Als uw formulier bijvoorbeeld om een biografische schets van de gebruiker vraagt, wilt u een TextBox gebruiken die meerdere regels tekst ondersteunt. In het volgende voorbeeld ziet u hoe u Extensible Application Markup Language (XAML) gebruikt om een TextBox controle te definiëren die automatisch uitbreidt om meerdere regels tekst te tonen.

<TextBox
  Name="tbMultiLine"
  TextWrapping="Wrap"
  AcceptsReturn="True"
  VerticalScrollBarVisibility="Visible"
>
  This TextBox will allow the user to enter multiple lines of text.  When the RETURN key is pressed, 
  or when typed text reaches the edge of the text box, a new line is automatically inserted.
</TextBox>

Wanneer u het kenmerk TextWrapping instelt op Wrap, zorgt dit ervoor dat de tekst naar een nieuwe regel wordt verplaatst zodra de rand van de TextBox-besturing is bereikt, waardoor de TextBox-besturing automatisch wordt uitgebreid om, indien nodig, ruimte toe te voegen voor een nieuwe regel.

Door het kenmerk AcceptsReturn op true in te stellen, wordt er een nieuwe regel ingevoegd wanneer op de RETURN-toets wordt gedrukt. Zo nodig wordt de TextBox automatisch uitgebreid om ruimte te bieden voor een nieuwe regel.

Het kenmerk VerticalScrollBarVisibility voegt een schuifbalk toe aan de TextBox, zodat de inhoud van de TextBox door kan worden geschoven als de TextBox groter wordt dan het frame of venster dat het omsluit.

Zie voor meer informatie over de verschillende taken die bij het gebruik van een TextBoxzijn gekoppeld, de How-to Onderwerpen.

Detecteren wanneer inhoud verandert

Meestal moet de gebeurtenis TextChanged worden gebruikt om te detecteren wanneer de tekst in een TextBox of RichTextBox verandert, in plaats van KeyDown zoals u zou verwachten. Zie Detecteren wanneer tekst in een tekstvak is gewijzigd voor een voorbeeld.

Zie ook