TextBox – přehled

  • Článek

Třída TextBox umožňuje zobrazit nebo upravit neformátovaný text. Běžným použitím je TextBox úprava neformátovaného textu ve formuláři. Například formulář, který žádá o jméno uživatele, telefonní číslo atd., by používal TextBox ovládací prvky pro zadávání textu. Toto téma představuje TextBox třídu a poskytuje příklady, jak ji používat v jazyce XAML (Extensible Application Markup Language) i v jazyce C#.

TextBox nebo RichTextBox?

RichTextBox Umožňuje TextBox uživatelům zadávat text, ale tyto dva ovládací prvky se používají v různých scénářích. A TextBox vyžaduje méně systémových prostředků, RichTextBox takže je ideální, když je potřeba upravit jenom prostý text (tj. použití ve formuláři). A RichTextBox je lepší volbou, pokud je nutné, aby uživatel upravil formátovaný text, obrázky, tabulky nebo jiný podporovaný obsah. Například úprava dokumentu, článku nebo blogu, který vyžaduje formátování, obrázky atd., je nejlepší dosáhnout pomocí RichTextBox. Následující tabulka shrnuje primární funkce TextBox a RichTextBox.

Ctrl Kontrola pravopisu v reálném čase Místní nabídka Formátování příkazů jako ToggleBold (Ctr+B) FlowDocument obsah, jako jsou obrázky, odstavce, tabulky atd.
TextBox Ano Ano No Č.
RichTextBox Ano Yes Ano (viz Přehled RichTextBoxu) Ano (viz Přehled RichTextBoxu)

Poznámka:

I když TextBox nepodporuje formátování souvisejících příkazů pro úpravy, jako je ToggleBold (Ctr+B), podporuje mnoho základních příkazů oba ovládací prvky, jako MoveToLineEndje . Další informace naleznete v tématu EditingCommands.

Funkce podporované v TextBox následujících částech najdete v následujících částech. Další informace naleznete v RichTextBoxtématu RichTextBox Overview.

Kontrola pravopisu v reálném čase

Kontrolu pravopisu v reálném čase můžete povolit v TextBoxRichTextBox Když je kontrola pravopisu zapnutá, pod chybně napsanými slovy se zobrazí červená čára (viz obrázek níže).

Textbox with spell-checking

Informace o povolení kontroly pravopisu v ovládacím prvku pro úpravy textu najdete v tématu Povolení kontroly pravopisu v ovládacím prvku pro úpravy textu.

Místní nabídka

Ve výchozím nastavení mají místní TextBoxRichTextBox nabídku, která se zobrazí, když uživatel klikne pravým tlačítkem myši uvnitř ovládacího prvku. Místní nabídka umožňuje uživateli vyjmout, zkopírovat nebo vložit (viz obrázek níže).

TextBox with context menu

Můžete vytvořit vlastní místní nabídku, která přepíše výchozí chování. Další informace najdete v tématu Použití vlastní místní nabídky s textboxem .

Vytváření textových polí

A TextBox může být jedna čára ve výšce nebo se skládá z více čar. Jeden řádek TextBox je nejvhodnější pro zadávání malých objemů prostého textu (tj. "Název", "Telefon Číslo" atd. ve formuláři). Následující příklad ukazuje, jak vytvořit jeden řádek 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>

Můžete také vytvořit, TextBox aby uživatel mohl zadat více řádků textu. Pokud například formulář požádal o životopisný skic uživatele, měli byste použít TextBox text, který podporuje více řádků textu. Následující příklad ukazuje, jak pomocí jazyka XAML (Extensible Application Markup Language) definovat TextBox ovládací prvek, který se automaticky rozšíří tak, aby vyhovoval více řádkům textu.

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

Nastavením atributu TextWrapping způsobíte Wrap , že se text při dosažení okraje TextBox ovládacího prvku zalomí na nový řádek, a v případě potřeby automaticky rozbalí TextBox ovládací prvek tak, aby zahrnoval prostor pro nový řádek.

Když stisknete klávesu RETURN, nastavíte atribut tak AcceptsReturn , aby true se při stisknutí klávesy RETURN vložil nový řádek, a v případě potřeby se automaticky rozbalí TextBox , aby zahrnoval prostor pro nový řádek.

Atribut VerticalScrollBarVisibility přidá posuvník do objektu TextBox, aby bylo možné procházet obsah TextBox , pokud TextBox rozšíření přesahuje velikost rámečku nebo okna, které ho ohraničuje.

Další informace o různých úkolech přidružených k použití naleznete TextBoxv tématu Postupy témata.

Zjistit, kdy se obsah změní

TextChanged Událost by se obvykle měla použít ke zjištění, kdy text v TextBox textu nebo RichTextBox se změní, spíše než KeyDown byste očekávali. Příklad najdete v tématu Zjistit, kdy se text v textovém poli změnil .

Viz také