szövegdoboz

Az TextBox osztály lehetővé teszi a formázatlan szöveg megjelenítését vagy szerkesztését. Az TextBox gyakori használata a formázatlan szöveg szerkesztése egy űrlapon. A felhasználó nevét, telefonszámát és egyéb adatait kérő űrlap például vezérlőket használ TextBox a szövegbevitelhez.

Az alábbi táblázat a TextBox vezérlővel végzett gyakori feladatokat sorolja fel:

Cím	Description
Többsoros szövegdoboz-vezérlő létrehozása	Megtudhatja, hogyan hozhat létre több sornyi szöveget elfogadó szövegdobozt.
Észleli, hogy a szövegmezőben lévő szöveg megváltozott-e	Megtudhatja, hogyan reagálhat a szövegdobozok szövegváltozásaira.
Tabulátorkarakterek engedélyezése szövegdoboz-vezérlőben	Megtudhatja, hogyan engedélyezheti a tabulátorkarakterek használatát a Szövegdobozokban.
Sorok gyűjteményének lekérése a szövegdobozból	Megtudhatja, hogyan kérdezhet le szövegsorokat egy Szövegdobozból.
Szövegdoboz vezérlőelem írásvédetté tétele	Megtudhatja, hogyan akadályozhatja meg a szövegdobozok szerkesztését.
Vigye a kurzort a Szövegdoboz vezérlőelem szöveg elejére vagy végére	Megtudhatja, hogyan állíthatja be a kurzor pozícióját egy Szövegmezőben.
Szövegkijelölés lekérése	Megtudhatja, hogyan kérhet le kijelölt szöveget egy Szövegdobozból.
Fókusz beállítása szövegdoboz-vezérlőben	Megtudhatja, hogyan adhat fókuszt egy Szövegdoboznak.
Szövegdoboz vezérlőelem szöveges tartalmának beállítása	Megtudhatja, hogyan állíthatja be a kezdeti szöveget egy Szövegmezőben.
Helyesírás-ellenőrzés engedélyezése szövegszerkesztési vezérlőben	Megtudhatja, hogyan engedélyezheti a helyesírás-ellenőrzést a Szövegdobozokban.
Egyéni helyi menü használata szövegmezővel	Megtudhatja, hogyan hozhat létre egyéni helyi menüt egy Szövegdobozhoz.
Helyesírás-ellenőrzés használata kontextus menüvel	Megtudhatja, hogyan integrálhatja a helyesírás-ellenőrzést egy helyi menüvel.
Vízjel hozzáadása szövegdobozhoz	Megtudhatja, hogyan jeleníthet meg helyőrző szöveget egy Szövegmezőben.

TextBox vagy RichTextBox?

Mindkettőt TextBox , és 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, ezért ideális, ha csak egyszerű szöveget kell szerkeszteni (azaz a használatot egy űrlapon). Az 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 és egyéb tartalmakat igénylő dokumentum, cikk vagy blog szerkesztése a legjobban egy RichTextBox használatával valósítható meg. Az alábbi táblázat a következők elsődleges jellemzőit TextBoxRichTextBoxfoglalja ö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 tartalom, például képek, bekezdések, táblázatok és egyéb
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 ToggleBold (Ctr+B), számos alapszintű parancsot támogat mindkét vezérlő, például MoveToLineEnda . További információért lásd EditingCommands.

A támogatott TextBox funkciókat az alábbi szakaszok ismertetik. További információ: RichTextBoxRichTextBox – áttekintés.

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

Engedélyezheti a valós idejű helyesírás-ellenőrzést egy TextBox vagy RichTextBox. 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).

A helyesírás-ellenőrzés engedélyezéséről a Helyesírás-ellenőrzés engedélyezése szövegszerkesztési vezérlőkben című témakörben olvashat.

Helyi menü

Alapértelmezés szerint mindkettőnek TextBoxRichTextBox van helyi menüje, 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ó: Egyéni helyi menü használata szövegmezővel.

Szövegdobozok létrehozása

A TextBox lehet egy sor magas, vagy állhat több sorból. Az egyetlen sor TextBox a legjobb megoldás kis mennyiségű egyszerű szöveg (például "Név", "Telefonszám" és más adatok űrlapon történő beviteléhez). Az alábbi példa bemutatja, hogyan hozhat létre egyetlen sort 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>

Olyan is létrehozható TextBox , amely lehetővé teszi, hogy a felhasználó több sornyi szöveget írjon be. Ha például az űrlap egy életrajzi vázlatot kért a felhasználótól, akkor egy többsoros szöveget támogató szöveget szeretne használni TextBox . Az alábbi példa bemutatja, hogyan használható az Extensible Application Markup Language (XAML) egy TextBox olyan vezérlő definiálásához, 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 az TextWrapping attribútumot úgy állítja be, hogy Wrap, a szöveg új sorba törik, amikor a TextBox vezérlőelem széléhez ér, és szükség esetén automatikusan bővíti a TextBox vezérlőt, hogy helyet biztosítson egy új sornak.

Ha az AcceptsReturn attribútumot true úgy állítja be, hogy a RETURN billentyű lenyomásakor új sort szúrjon be, szükség esetén automatikusan kiterjeszti az TextBox az új sorhoz tartozó helyet.

Az VerticalScrollBarVisibility attribútum hozzáad egy görgetősávot a TextBox elemhez, így a TextBox tartalma görgethetővé válik, ha a TextBox meghaladja az azt tartalmazó keret vagy ablak méretét.

További információért a különböző, a TextBox használatához kapcsolódó feladatokról, lásd a cikk tetején található útmutató jellegű témaköröket.

Tartalomváltozások észlelése

Általában az TextChanged eseményt kell használni annak észlelésére, amikor a szöveg egy TextBox vagy RichTextBox változik, és nem a KeyDown, ahogy azt esetleg várnád. Ilyen például a Szövegdoboz szövegének módosulásának észlelése.

Stílusok és sablonok

Módosíthatja az alapértelmezett beállítást ControlTemplate , hogy egyedi megjelenést adjon a TextBox vezérlőnek. További információ: Mik azok a stílusok és sablonok? és hogyan hozhat létre sablonokat vezérlőkhöz.

Tartalomtulajdonság

A TextBox vezérlő a Text tulajdonságot használja a szöveges tartalom megjelenítéséhez.

Részek

Az alábbi táblázat a vezérlőelem elnevezett részeit sorolja fel TextBox .

Rész	Típus	Description
PART_Tartalomgazda	FrameworkElement	A szöveges tartalmat üzemeltető keretrendszerelem.

Vizualizációs állapotok

Az alábbi táblázat a vezérlőelem vizualizációs állapotát sorolja fel TextBox .

VisualState név	VisualStateGroup neve	Description
Disabled	CommonStates	A vezérlő le van tiltva.
Focused	FocusStates	A vezérlő billentyűzetfókuszt használ.
InvalidFocused (ÉrvénytelenFókuszálás)	ÉrvényesítésiÁllapotok	A vezérlő érvényesítési hibával rendelkezik, és billentyűzetfókuszt használ.
ÉrvénytelenFókuszNélküli	ÉrvényesítésiÁllapotok	A vezérlő érvényesítési hibával rendelkezik, de nincs billentyűzetfókusza.
Egér fölé húzás	CommonStates	Az egér a vezérlő felett van.
Normal	CommonStates	A vezérlő normál állapotban van.
ReadOnly	CommonStates	A vezérlő írásvédett módban van.
Fókuszálatlan	FocusStates	A vezérlő nem rendelkezik billentyűzetfókusszal.
Érvényes	ÉrvényesítésiÁllapotok	A vezérlő érvényes, és nem rendelkezik érvényesítési hibával.

Lásd még

• PasswordBox
• RichTextBox
• TextBlock
• TextBox
• EditingCommands
• RichTextBox – áttekintés
• Formázás a ControlTemplates példával
• WPF-vezérlők gyűjteményének minta