RichTextBox – áttekintés

A RichTextBox vezérlővel megjelenítheti vagy szerkesztheti a folyamat tartalmát, beleértve a bekezdéseket, képeket, táblázatokat stb. 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 a RichTextBox, mind a TextBox lehetővé teszi a felhasználók számára a szöveg szerkesztését, a két vezérlő azonban különböző helyzetekben használatos. A RichTextBox jobb választás, ha a felhasználónak formázott szöveget, képeket, táblázatokat vagy más gazdag 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. A TextBox kevesebb rendszererőforrást igényel, mint egy RichTextBox, és ideális, ha csak egyszerű szöveget kell szerkeszteni (azaz az űrlapok használatát). További információt a Szövegdobozok áttekintése című témakörben talál a TextBox-ről. Az alábbi táblázat a TextBox és a RichTextBoxfő 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	Igen

Megjegyzés:

Bár TextBox nem támogatja az olyan formázással kapcsolatos parancsokat, mint a ToggleBold (Ctr+B), számos alapszintű parancsot támogat mindkét vezérlő, például a MoveToLineEnd.

A fenti táblázat funkcióit később részletesebben is bemutatjuk.

RichTextBox létrehozása

Az alábbi kód bemutatja, hogyan hozhat létre olyan RichTextBox, amelyben a felhasználó szerkesztheti a gazdag tartalmakat.

<Page xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">

    <!-- A RichTextBox with no initial content in it. -->
    <RichTextBox />

</Page>

A RichTextBox-ban szerkesztett tartalom összefüggő tartalom. A folyamat tartalma számos elemet tartalmazhat, például formázott szöveget, képeket, listákat és táblázatokat. A folyamatdokumentumokkal kapcsolatos részletes információkért tekintse meg Folyamatdokumentumok áttekintése című témakört. A folyamattartalom tárolásához egy RichTextBox egy FlowDocument objektumot üzemeltet, amely viszont a szerkeszthető tartalmat tartalmazza. Egy RichTextBoxfolyamattartalmainak szemléltetéséhez az alábbi kód bemutatja, hogyan hozhat létre RichTextBox egy bekezdéssel és néhány félkövér szöveggel.

<Page xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">

  <StackPanel>
    <RichTextBox>
      <FlowDocument>
        <Paragraph>
          This is flow content and you can <Bold>edit me!</Bold>
        </Paragraph>
      </FlowDocument>
    </RichTextBox>
  </StackPanel>

</Page>

using System;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Media;
using System.Windows.Documents;
namespace SDKSample
{
    public partial class BasicRichTextBoxWithContentExample : Page
    {
        public BasicRichTextBoxWithContentExample()
        {
            StackPanel myStackPanel = new StackPanel();

            // Create a FlowDocument to contain content for the RichTextBox.
            FlowDocument myFlowDoc = new FlowDocument();

            // Create a Run of plain text and some bold text.
            Run myRun = new Run("This is flow content and you can ");
            Bold myBold = new Bold(new Run("edit me!"));

            // Create a paragraph and add the Run and Bold to it.
            Paragraph myParagraph = new Paragraph();
            myParagraph.Inlines.Add(myRun);
            myParagraph.Inlines.Add(myBold);

            // Add the paragraph to the FlowDocument.
            myFlowDoc.Blocks.Add(myParagraph);

            RichTextBox myRichTextBox = new RichTextBox();

            // Add initial content to the RichTextBox.
            myRichTextBox.Document = myFlowDoc;

            myStackPanel.Children.Add(myRichTextBox);
            this.Content = myStackPanel;
        }
    }
}

Imports System.Windows
Imports System.Windows.Controls
Imports System.Windows.Media
Imports System.Windows.Documents
Namespace SDKSample
    Partial Public Class BasicRichTextBoxWithContentExample
        Inherits Page
        Public Sub New()
            Dim myStackPanel As New StackPanel()

            ' Create a FlowDocument to contain content for the RichTextBox.
            Dim myFlowDoc As New FlowDocument()

            ' Create a Run of plain text and some bold text.
            Dim myRun As New Run("This is flow content and you can ")
            Dim myBold As New Bold(New Run("edit me!"))

            ' Create a paragraph and add the Run and Bold to it.
            Dim myParagraph As New Paragraph()
            myParagraph.Inlines.Add(myRun)
            myParagraph.Inlines.Add(myBold)

            ' Add the paragraph to the FlowDocument.
            myFlowDoc.Blocks.Add(myParagraph)

            Dim myRichTextBox As New RichTextBox()

            ' Add initial content to the RichTextBox.
            myRichTextBox.Document = myFlowDoc

            myStackPanel.Children.Add(myRichTextBox)
            Me.Content = myStackPanel

        End Sub
    End Class
End Namespace

Az alábbi ábra bemutatja, hogyan jelenik meg ez a minta.

Az olyan elemek, mint a Paragraph és a Bold határozzák meg a RichTextBox belüli tartalom megjelenését. Amikor egy felhasználó szerkeszt egy RichTextBox tartalmat, megváltoztatja ezt a folyamattartalmat. A folyamattartalom funkcióiról és annak használatáról további információt Folyamatdokumentum áttekintésecímű témakörben talál.

Megjegyzés:

A RichTextBox belüli folyamattartalmak nem viselkednek pontosan úgy, mint a más vezérlőkben található folyamattartalmak. Például a RichTextBox formátumban nincsenek oszlopok, és ezért nincs automatikus átméretezési viselkedés. Emellett a beépített funkciók, például a keresés, a megtekintési mód, a lapnavigáció és a nagyítás nem érhetők el a RichTextBox.

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

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 ábrát).

Létrehozhat saját egyéni helyi menüt az alapértelmezett menü felülbírálására. Lásd a(z) Egyéni helyi menü elhelyezését a RichTextBox-ban a további információkért.

Parancsok szerkesztése

A szerkesztési parancsok lehetővé teszik a felhasználók számára a szerkeszthető tartalom formázását egy RichTextBoxbelül. Az alapvető szerkesztési parancsok mellett RichTextBox olyan formázási parancsokat is tartalmaz, amelyeket TextBox nem támogat. Ha például egy RichTextBox-ban szerkeszt, a felhasználó a Ctrl+B billentyűkombinációval válthat félkövér szövegformázásra. Az elérhető parancsok teljes listáját lásd a EditingCommands. A billentyűparancsok használata mellett a parancsokat más vezérlőkhöz, például gombokhoz is csatlakoztathatja. Az alábbi példa bemutatja, hogyan hozhat létre egy egyszerű eszközsávot, amely gombokat tartalmaz, amelyekkel a felhasználó módosíthatja a szövegformázást.

<Window x:Class="RichTextBoxInputPanelDemo.Window1"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" Height="400" Width="600"
    >
  <Grid>

    <!-- Set the styles for the tool bar. -->
    <Grid.Resources>
      <Style TargetType="{x:Type Button}" x:Key="formatTextStyle">
        <Setter Property="FontFamily" Value="Palatino Linotype"></Setter>
        <Setter Property="Width" Value="30"></Setter>
        <Setter Property="FontSize" Value ="14"></Setter>
        <Setter Property="CommandTarget" Value="{Binding ElementName=mainRTB}"></Setter>
      </Style>

      <Style TargetType="{x:Type Button}" x:Key="formatImageStyle">
        <Setter Property="Width" Value="30"></Setter>
        <Setter Property="CommandTarget" Value="{Binding ElementName=mainRTB}"></Setter>
      </Style>
    </Grid.Resources>

    <DockPanel Name="mainPanel">

      <!-- This tool bar contains all the editing buttons. -->
      <ToolBar Name="mainToolBar" Height="30" DockPanel.Dock="Top">

        <Button Style="{StaticResource formatImageStyle}" Command="ApplicationCommands.Cut" ToolTip="Cut">
          <Image Source="Images\EditCut.png"></Image>
        </Button>
        <Button Style="{StaticResource formatImageStyle}" Command="ApplicationCommands.Copy" ToolTip="Copy">
          <Image Source="Images\EditCopy.png"></Image>
        </Button>
        <Button Style="{StaticResource formatImageStyle}" Command="ApplicationCommands.Paste" ToolTip="Paste">
          <Image Source="Images\EditPaste.png"></Image>
        </Button>
        <Button Style="{StaticResource formatImageStyle}" Command="ApplicationCommands.Undo" ToolTip="Undo">
          <Image Source="Images\EditUndo.png"></Image>
        </Button>
        <Button Style="{StaticResource formatImageStyle}" Command="ApplicationCommands.Redo" ToolTip="Redo">
          <Image Source="Images\EditRedo.png"></Image>
        </Button>

        <Button Style="{StaticResource formatTextStyle}" Command="EditingCommands.ToggleBold" ToolTip="Bold">
          <TextBlock FontWeight="Bold">B</TextBlock>
        </Button>
        <Button Style="{StaticResource formatTextStyle}" Command="EditingCommands.ToggleItalic" ToolTip="Italic">
          <TextBlock FontStyle="Italic" FontWeight="Bold">I</TextBlock>
        </Button>
        <Button Style="{StaticResource formatTextStyle}" Command="EditingCommands.ToggleUnderline" ToolTip="Underline">
          <TextBlock TextDecorations="Underline" FontWeight="Bold">U</TextBlock>
        </Button>
        <Button Style="{StaticResource formatImageStyle}" Command="EditingCommands.IncreaseFontSize" ToolTip="Grow Font">
          <Image Source="Images\CharacterGrowFont.png"></Image>
        </Button>
        <Button Style="{StaticResource formatImageStyle}" Command="EditingCommands.DecreaseFontSize" ToolTip="Shrink Font">
          <Image Source="Images\CharacterShrinkFont.png"></Image>
        </Button>

        <Button Style="{StaticResource formatImageStyle}" Command="EditingCommands.ToggleBullets" ToolTip="Bullets">
          <Image Source="Images\ListBullets.png"></Image>
        </Button>
        <Button Style="{StaticResource formatImageStyle}" Command="EditingCommands.ToggleNumbering" ToolTip="Numbering">
          <Image Source="Images/ListNumbering.png"></Image>
        </Button>
        <Button Style="{StaticResource formatImageStyle}" Command="EditingCommands.AlignLeft" ToolTip="Align Left">
          <Image Source="Images\ParagraphLeftJustify.png"></Image>
        </Button>
        <Button Style="{StaticResource formatImageStyle}" Command="EditingCommands.AlignCenter" ToolTip="Align Center">
          <Image Source="Images\ParagraphCenterJustify.png"></Image>
        </Button>
        <Button Style="{StaticResource formatImageStyle}" Command="EditingCommands.AlignRight" ToolTip="Align Right">
          <Image Source="Images\ParagraphRightJustify.png"></Image>
        </Button>
        <Button Style="{StaticResource formatImageStyle}" Command="EditingCommands.AlignJustify" ToolTip="Align Justify">
          <Image Source="Images\ParagraphFullJustify.png"></Image>
        </Button>
        <Button Style="{StaticResource formatImageStyle}" Command="EditingCommands.IncreaseIndentation" ToolTip="Increase Indent">
          <Image Source="Images\ParagraphIncreaseIndentation.png"></Image>
        </Button>
        <Button Style="{StaticResource formatImageStyle}" Command="EditingCommands.DecreaseIndentation" ToolTip="Decrease Indent">
          <Image Source="Images\ParagraphDecreaseIndentation.png"></Image>
        </Button>

      </ToolBar>

      <!-- By default pressing tab moves focus to the next control. Setting AcceptsTab to true allows the 
           RichTextBox to accept tab characters. -->
      <RichTextBox Name="mainRTB" AcceptsTab="True"></RichTextBox>
    </DockPanel>
  </Grid>
</Window>

Az alábbi ábra bemutatja, hogyan jelenik meg ez a minta.

Tartalomváltozások észlelése

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

RichTextBox-tartalom mentése, betöltése és nyomtatása

Az alábbi példa bemutatja, hogyan lehet egy RichTextBox tartalmát egy fájlba menteni, visszatölteni a tartalmat a RichTextBox-be, és hogyan lehet kinyomtatni. Az alábbiakban látható a példához tartozó jelölés.

<Page xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  x:Class="SDKSample.SaveLoadPrintRTB" >

  <StackPanel>
    <RichTextBox Name="richTB">
      <FlowDocument>
        <Paragraph>
          <Run>Paragraph 1</Run>
        </Paragraph>
      </FlowDocument>
    </RichTextBox>

    <Button Click="SaveRTBContent">Save RTB Content</Button>
    <Button Click="LoadRTBContent">Load RTB Content</Button>
    <Button Click="PrintRTBContent">Print RTB Content</Button>
  </StackPanel>

</Page>

Az alábbiakban a példa mögötti kód látható.

using System;
using System.IO;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Documents;
using System.Windows.Media;

namespace SDKSample
{

    public partial class SaveLoadPrintRTB : Page
    {

        // Handle "Save RichTextBox Content" button click.
        void SaveRTBContent(Object sender, RoutedEventArgs args)
        {

            // Send an arbitrary URL and file name string specifying
            // the location to save the XAML in.
            SaveXamlPackage("C:\\test.xaml");
        }

        // Handle "Load RichTextBox Content" button click.
        void LoadRTBContent(Object sender, RoutedEventArgs args)
        {
            // Send URL string specifying what file to retrieve XAML
            // from to load into the RichTextBox.
            LoadXamlPackage("C:\\test.xaml");
        }

        // Handle "Print RichTextBox Content" button click.
        void PrintRTBContent(Object sender, RoutedEventArgs args)
        {
            PrintCommand();
        }

        // Save XAML in RichTextBox to a file specified by _fileName
        void SaveXamlPackage(string _fileName)
        {
            TextRange range;
            FileStream fStream;
            range = new TextRange(richTB.Document.ContentStart, richTB.Document.ContentEnd);
            fStream = new FileStream(_fileName, FileMode.Create);
            range.Save(fStream, DataFormats.XamlPackage);
            fStream.Close();
        }

        // Load XAML into RichTextBox from a file specified by _fileName
        void LoadXamlPackage(string _fileName)
        {
            TextRange range;
            FileStream fStream;
            if (File.Exists(_fileName))
            {
                range = new TextRange(richTB.Document.ContentStart, richTB.Document.ContentEnd);
                fStream = new FileStream(_fileName, FileMode.OpenOrCreate);
                range.Load(fStream, DataFormats.XamlPackage);
                fStream.Close();
            }
        }

        // Print RichTextBox content
        private void PrintCommand()
        {
            PrintDialog pd = new PrintDialog();
            if ((pd.ShowDialog() == true))
            {
                //use either one of the below
                pd.PrintVisual(richTB as Visual, "printing as visual");
                pd.PrintDocument((((IDocumentPaginatorSource)richTB.Document).DocumentPaginator), "printing as paginator");
            }
        }
    }
}

Imports System.IO
Imports System.Windows
Imports System.Windows.Controls
Imports System.Windows.Documents
Imports System.Windows.Media

Namespace SDKSample

    Partial Public Class SaveLoadPrintRTB
        Inherits Page

        ' Handle "Save RichTextBox Content" button click.
        Private Sub SaveRTBContent(ByVal sender As Object, ByVal args As RoutedEventArgs)

            ' Send an arbitrary URL and file name string specifying
            ' the location to save the XAML in.
            SaveXamlPackage("C:\test.xaml")
        End Sub

        ' Handle "Load RichTextBox Content" button click.
        Private Sub LoadRTBContent(ByVal sender As Object, ByVal args As RoutedEventArgs)
            ' Send URL string specifying what file to retrieve XAML
            ' from to load into the RichTextBox.
            LoadXamlPackage("C:\test.xaml")
        End Sub

        ' Handle "Print RichTextBox Content" button click.
        Private Sub PrintRTBContent(ByVal sender As Object, ByVal args As RoutedEventArgs)
            PrintCommand()
        End Sub

        ' Save XAML in RichTextBox to a file specified by _fileName
        Private Sub SaveXamlPackage(ByVal _fileName As String)
            Dim range As TextRange
            Dim fStream As FileStream
            range = New TextRange(richTB.Document.ContentStart, richTB.Document.ContentEnd)
            fStream = New FileStream(_fileName, FileMode.Create)
            range.Save(fStream, DataFormats.XamlPackage)
            fStream.Close()
        End Sub

        ' Load XAML into RichTextBox from a file specified by _fileName
        Private Sub LoadXamlPackage(ByVal _fileName As String)
            Dim range As TextRange
            Dim fStream As FileStream
            If File.Exists(_fileName) Then
                range = New TextRange(richTB.Document.ContentStart, richTB.Document.ContentEnd)
                fStream = New FileStream(_fileName, FileMode.OpenOrCreate)
                range.Load(fStream, DataFormats.XamlPackage)
                fStream.Close()
            End If
        End Sub

        ' Print RichTextBox content
        Private Sub PrintCommand()
            Dim pd As New PrintDialog()
            If (pd.ShowDialog() = True) Then
                'use either one of the below      
                pd.PrintVisual(TryCast(richTB, Visual), "printing as visual")
                pd.PrintDocument(((CType(richTB.Document, IDocumentPaginatorSource)).DocumentPaginator), "printing as paginator")
            End If
        End Sub
    End Class
End Namespace

Lásd még

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