RichTextBox Genel Bakışı

Denetim; RichTextBox paragraflar, görüntüler, tablolar ve daha fazlası dahil olmak üzere akış içeriğini görüntülemenizi veya düzenlemenizi sağlar. Bu konuda sınıfı tanıt ve hem hem de C#'de Extensible Application Markup Language TextBox kullanımına örnekler verilmiştir.

TextBox mı yoksa RichTextBox mı?

Hem RichTextBox hem de kullanıcıların metin TextBox düzenlemesine izin verir, ancak iki denetim farklı senaryolarda kullanılır. , kullanıcının biçimlendirilmiş metinleri, resimleri, tabloları veya diğer zengin içeriği düzenlemesi gerektiğinde RichTextBox daha iyi bir seçenektir. Örneğin, biçimlendirme, görüntü vb. gerektiren bir belge, makale veya blog düzenleme en iyi şekilde kullanılarak RichTextBox kullanılmaktadır. A, bir'den daha az sistem kaynağı gerektirir ve yalnızca düz metinlerin (formlarda kullanım) TextBoxRichTextBox düzende olması gerekirken idealdir. hakkında daha fazla bilgi için bkz. TextBox'a Genel Bakış. Aşağıdaki tabloda ve ana özellikleri TextBoxRichTextBox özetlenmiştir.

Denetim Gerçek zamanlı Yazım Denetimi Bağlam Menüsü Gibi biçimlendirme komutları ToggleBold (Ctr+B) FlowDocument görüntüler, paragraflar, tablolar gibi içerikler.
TextBox Yes Yes Hayır Hayır.
RichTextBox Yes Yes Yes Yes

Not

TextBox(Ctr+B) gibi biçimlendirmeyle ilgili komutları desteklemese de, gibi her iki ToggleBold denetim de birçok temel komutu MoveToLineEnd destekler.

Yukarıdaki tabloda yer alan özellikler daha sonra daha ayrıntılı olarak ele alır.

RichTextBox Oluşturma

Aşağıdaki kodda, bir kullanıcının zengin RichTextBox içeriği düzenleyemezken nasıl oluşturularak oluşturularak ilgili koda yer verilmiştir.

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

Özellikle, bir içinde düzenlenen içerik RichTextBox akış içeriğidir. Flow, biçimlendirilmiş metin, görüntüler, listeler ve tablolar gibi birçok öğe türü içerebilir. Akış Flow ayrıntılı bilgi için bkz. Belgeye Genel Bakış. Akış içeriğini içermek için, bir RichTextBox nesnesi FlowDocument barındırarak düzenlenebilir içeriği içerir. Akış içeriğini bir içinde göstermek için, aşağıdaki kodda bir paragraf ve kalın metin RichTextBoxRichTextBox ile nasıl oluşturulacakları gösterilir.

<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

Aşağıdaki çizimde bu örneğin nasıl işlen olduğu gösterilmiştir.

RichTextBox with content

ve gibi ParagraphBold öğeler, içindeki içeriğin nasıl görüntülendiğinden RichTextBox belirler. Kullanıcı içeriği RichTextBox düzenlerken bu akış içeriğini değiştirir. Akış içeriğinin özellikleri ve içerikle çalışma hakkında daha fazla bilgi edinmek için bkz. Flow Belgeye Genel Bakış.

Not

Flow RichTextBox içeriği, diğer denetimlerde yer alan akış içeriği gibi davranmaz. Örneğin, içinde sütun yoktur ve RichTextBox bu nedenle otomatik yeniden boyutlandırma davranışı yoktur. Ayrıca arama, görüntüleme modu, sayfa gezintisi ve yakınlaştırma gibi yerleşik özellikler bir içinde RichTextBox kullanılamaz.

Gerçek Zamanlı Yazım Denetimi

veya içinde gerçek zamanlı yazım denetlemeyi TextBoxRichTextBox etkinleştirabilirsiniz. Yazım denetimi açık olduğunda, yanlış yazılmış sözcüklerin altında kırmızı bir çizgi görünür (aşağıdaki resme bakın).

Textbox with spell-checking

Yazım denetimi etkinleştirme hakkında bilgi edinmek için bkz. Metin Düzenleme Denetiminde Yazım Denetlemeyi Etkinleştirme.

Bağlam Menüsü

Varsayılan olarak, TextBox ve RichTextBox kullanıcı denetimin içine sağ tıkladığında görüntülenen bir bağlam menüsüne sahip olur. Bağlam menüsü kullanıcının kesme, kopyalama veya yapıştırma izinlerini verir (aşağıdaki çizime bakın).

TextBox with context menu

Varsayılan menüyü geçersiz kılmak için kendi özel bağlam men ekleyebilirsiniz. Daha fazla bilgi için bkz. RichTextBox'ta Özel Bağlam Menüsünü Konumlandırma.

Komutları Düzenleme

Düzenleme komutları, kullanıcıların bir içindeki düzenlenebilir içeriği biçimlendirmelerini RichTextBox sağlar. Temel düzenleme komutlarının yanı sıra RichTextBox desteklemez biçimlendirme TextBox komutları da içerir. Örneğin, bir içinde düzenlerken, bir kullanıcı Kalın metin biçimlendirmesini değiştirmek için RichTextBox Ctr+B tuşlarına bassa. Kullanılabilir EditingCommands komutların tam listesi için bkz. . Klavye kısayollarını kullanmaya ek olarak, komutları düğmeler gibi diğer denetimlere de takabilirsiniz. Aşağıdaki örnekte, kullanıcının metin biçimlendirmesini değiştirmek için kullanabileceği düğmeleri içeren basit bir araç çubuğunun nasıl oluşturularak ilgili bilgiler ve bilgiler ve bilgiler yer a edilmektedir.

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

Aşağıdaki çizimde bu örneğin nasıl görüntü olduğu gösterilmiştir.

RichTextBox with ToolBar

İçerik Değiştiklerini Algıla

Genellikle olay, bir veya içinde yer alan metnin beklediğiniz gibi daha sonra TextChangedTextBox ne zaman RichTextBoxKeyDown değiştiğni algılamak için kullanılmalıdır. Örnek için bkz. TextBox'ta Metin Değiştir olduğunda Algılama.

RichTextBox İçeriğini Kaydetme, Yükleme ve Yazdırma

Aşağıdaki örnek, bir dosyasının içeriğinin bir dosyaya nasıl kaydedilr, bu içeriği dosyasına geri RichTextBox yükleyen RichTextBox ve içeriğini yazdıran bir örnek gösterir. Aşağıda örnek için işaretleme verilmiştir.

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

Aşağıda, örneğin arkasındaki kod verilmiştir.

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

Ayrıca bkz.