TextBox – áttekintés

A TextBox osztály lehetővé teszi a formázatlan szöveg megjelenítését vagy szerkesztését. A TextBox-t gyakran használják formázatlan szöveg szerkesztésére egy űrlapon. Egy felhasználó nevét, telefonszámát stb. kérő űrlap például TextBox vezérlőelemeket használna a szövegbevitelhez. Ez a témakör bemutatja a TextBox osztályt, és példákat tartalmaz arra, hogyan használható az Extensible Application Markup Language (XAML) és a C# nyelven is.

TextBox vagy RichTextBox?

Mind TextBox, mind RichTextBox lehetővé teszi a felhasználók számára a szöveg bevitelét, de a két vezérlő különböző forgatókönyvekhez használható. Az A TextBox kevesebb rendszererőforrást igényel, mint egy RichTextBox ilyen, ezért ideális, ha csak egyszerű szöveget kell szerkeszteni (azaz a használatot egy űrlapon). A RichTextBox jobb választás, ha a felhasználónak formázott szöveget, képeket, táblázatokat vagy más támogatott tartalmat kell szerkesztenie. Például egy formázást, képeket stb. igénylő dokumentum, cikk vagy blog szerkesztése a legjobb megoldás egy RichTextBoxhasználatával. Az alábbi táblázat a TextBox és a RichTextBoxelsődleges jellemzőit foglalja össze.

Vezérlő	Valós idejű helyesírás-ellenőrzés	Helyi menü	Formázási parancsok, például ToggleBold (Ctr+B)	FlowDocument olyan tartalmakat, mint a képek, bekezdések, táblázatok stb.
TextBox	Igen	Igen	Nem	Nem.
RichTextBox	Igen	Igen	Igen (lásd RichTextBox áttekintés)	Igen (lásd RichTextBox áttekintés)

Megjegyzés:

Bár TextBox nem támogatja a formázással kapcsolatos szerkesztési parancsokat, például a ToggleBold (Ctr+B), számos alapvető parancsot támogat mindkét vezérlő, például a MoveToLineEnd. További információért lásd a EditingCommands jelű részt.

A TextBox által támogatott funkciókat az alábbi szakaszok ismertetik. A RichTextBoxRichTextBox áttekintésicímű témakörben talál további információt.

Valós idejű helyesírás-ellenőrzés

A valós idejű helyesírás-ellenőrzést engedélyezheti a TextBox-ban vagy a RichTextBox-ben. Ha a helyesírás-ellenőrzés be van kapcsolva, piros vonal jelenik meg a hibásan írt szavak alatt (lásd az alábbi képet).

Lásd a Helyesírás-ellenőrzés engedélyezése szövegszerkesztő vezérlőben című témakört, hogy megtanulja, hogyan engedélyezheti a helyesírás-ellenőrzést.

Helyi menü

Alapértelmezés szerint TextBox és RichTextBox is rendelkezik helyi menüvel, amely akkor jelenik meg, amikor egy felhasználó a jobb gombbal a vezérlőn belülre kattint. A helyi menü lehetővé teszi a felhasználó számára a kivágást, másolást vagy beillesztést (lásd az alábbi képet).

Létrehozhat saját egyéni helyi menüt az alapértelmezett viselkedés felülbírálásához. További információért lásd: Egyéni helyi menü használata szövegdobozzal.

Szövegdobozok létrehozása

A TextBox lehet egyetlen vonalmagasság vagy több sorból is állhat. Az egysoros TextBox kis mennyiségű egyszerű szöveg (pl. "Név", "Telefonszám" stb.) beviteléhez ajánlott. Az alábbi példa bemutatja, hogyan hozható létre egyetlen sor TextBox.

<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>

Létrehozhat egy TextBox is, amely lehetővé teszi, hogy a felhasználó több sornyi szöveget írjon be. Például, ha az űrlapban egy életrajzi vázlatot kértek a felhasználótól, akkor egy olyan TextBox-t szeretne használni, amely támogatja a többsoros szöveget. Az alábbi példa bemutatja, hogyan használható az XAML (Extensible Application Markup Language) egy olyan TextBox vezérlőelem definiálására, amely automatikusan kibővül több sornyi szöveghez.

<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>

Ha a TextWrapping attribútumot Wrap értékre állítja, a szöveg új sorba törik a TextBox vezérlőelem szélének elérésekor, és szükség esetén automatikusan kiterjeszti a TextBox vezérlőelemet, hogy helyet foglaljon egy új sornak.

Ha a AcceptsReturn attribútumot true értékre állítja, a RETURN billentyű lenyomásakor új sor kerül beszúrásra, és szükség esetén automatikusan kibontja a TextBox, hogy helyet foglaljon egy új sornak.

A VerticalScrollBarVisibility attribútum hozzáad egy görgetősávot a TextBox, hogy a TextBox tartalma görgethető legyen, ha a TextBox a keret vagy az azt tartalmazó ablak mérete fölé nő.

A TextBoxhasználatával kapcsolatos különböző feladatokról további információt Útmutatókcímű témakörben talál.

Tartalomváltozások észlelése

Általában a TextChanged eseményt kell használni, hogy észlelje, amikor a szöveg a TextBox-ben vagy a RichTextBox-ben megváltozik, ahelyett, hogy a KeyDown-as eseményt használná, ahogy azt várnánk. Lásd a „Hogyan érzékelhető, ha a szöveg egy szövegdobozban megváltozik” példát.

Lásd még

• útmutató témakörök
• RichTextBox áttekintése