Upřesněné formátování textu

  • Článek

Windows Presentation Foundation (WPF) poskytuje robustní sadu rozhraní API pro zahrnutí textu do aplikace. Rozhraní API rozložení a uživatelského rozhraní (UI), jako TextBlockje například , poskytují nejběžnější a obecné prvky použití pro textovou prezentaci. Rozhraní API pro kreslení, jako GlyphRunDrawing je například a FormattedText, poskytují prostředky pro zahrnutí formátovaného textu do kreseb. WpF na nejpokročilejší úrovni poskytuje rozšiřitelný modul pro formátování textu, který řídí všechny aspekty textové prezentace, jako je správa úložiště textu, správa formátování textu a správa vložených objektů.

Toto téma obsahuje úvod do formátování textu WPF. Zaměřuje se na implementaci klienta a použití modulu formátování textu WPF.

Poznámka:

Všechny příklady kódu v tomto dokumentu najdete v ukázce rozšířeného formátování textu.

Předpoklady

V tomto tématu se předpokládá, že znáte rozhraní API vyšší úrovně používaná pro textovou prezentaci. Většina uživatelských scénářů nevyžaduje rozhraní API pro pokročilé formátování textu popsané v tomto tématu. Úvod do různých textových rozhraní API najdete v tématu Dokumenty ve WPF.

Upřesněné formátování textu

Ovládací prvky rozložení textu a uživatelského rozhraní ve WPF poskytují vlastnosti formátování, které umožňují snadno zahrnout do aplikace formátovaný text. Tyto ovládací prvky zpřístupňují řadu vlastností pro zpracování prezentace textu, která zahrnuje jeho typ písma, velikost a barvu. Za běžných okolností můžou tyto ovládací prvky zpracovávat většinu textové prezentace ve vaší aplikaci. Některé pokročilé scénáře ale vyžadují kontrolu nad textovým úložištěm i textová prezentace. WPF poskytuje rozšiřitelný modul pro formátování textu pro tento účel.

Pokročilé funkce formátování textu nalezené ve WPF se skládají z modulu formátování textu, úložiště textu, spuštění textu a vlastností formátování. Modul TextFormatterpro formátování textu vytvoří řádky textu, které se mají použít pro prezentaci. Toho dosáhnete zahájením procesu formátování řádku a voláním formátovače FormatLinetextu . Formátovací modul textu načte text z úložiště textu voláním metody úložiště GetTextRun . Objekty TextRun se pak vytvoří do TextLine objektů pomocí textového formátovače a předají vaší aplikaci pro kontrolu nebo zobrazení.

Použití formátovače textu

TextFormatter je modul pro formátování textu WPF a poskytuje služby pro formátování a dělení řádků textu. Formátovací modul textu dokáže zpracovat různé formáty textových znaků a styly odstavců a zahrnuje podporu pro mezinárodní rozložení textu.

Na rozdíl od tradičního textového rozhraní API TextFormatter komunikuje s klientem rozložení textu prostřednictvím sady metod zpětného volání. Vyžaduje, aby klient poskytl tyto metody v implementaci TextSource třídy. Následující diagram znázorňuje interakci rozložení textu mezi klientskou aplikací a TextFormatter.

Diagram of text layout client and TextFormatter

Formátovací modul textu se používá k načtení formátovaných textových řádků z textového úložiště, což je implementace TextSource. To se provádí tak, že nejprve pomocí metody vytvoříte instanci textového formátovače Create . Tato metoda vytvoří instanci textového formátovače a nastaví maximální výšku a šířku čáry hodnoty. Jakmile se vytvoří instance textového formátovače, proces vytvoření řádku se spustí voláním FormatLine metody. TextFormatter volá zpět do textového zdroje, aby se načetly parametry textu a formátování pro spuštění textu, které tvoří řádek.

V následujícím příkladu se zobrazí proces formátování textového úložiště. Objekt TextFormatter slouží k načtení textových čar z textového úložiště a následnému naformátování textové čáry pro kreslení do objektu DrawingContext.

// Create a DrawingGroup object for storing formatted text.
textDest = new DrawingGroup();
DrawingContext dc = textDest.Open();

// Update the text store.
_textStore.Text = textToFormat.Text;
_textStore.FontRendering = _currentRendering;

// Create a TextFormatter object.
TextFormatter formatter = TextFormatter.Create();

// Format each line of text from the text store and draw it.
while (textStorePosition < _textStore.Text.Length)
{
   // Create a textline from the text store using the TextFormatter object.
   using (TextLine myTextLine = formatter.FormatLine(
       _textStore,
       textStorePosition,
       96*6,
       new GenericTextParagraphProperties(_currentRendering),
       null))
   {
       // Draw the formatted text into the drawing context.
       myTextLine.Draw(dc, linePosition, InvertAxes.None);

       // Update the index position in the text store.
       textStorePosition += myTextLine.Length;

       // Update the line position coordinate for the displayed line.
       linePosition.Y += myTextLine.Height;
   }
}

// Persist the drawn text content.
dc.Close();

// Display the formatted text in the DrawingGroup object.
myDrawingBrush.Drawing = textDest;

' Create a DrawingGroup object for storing formatted text.
textDest = New DrawingGroup()
Dim dc As DrawingContext = textDest.Open()

' Update the text store.
_textStore.Text = textToFormat.Text
_textStore.FontRendering = _currentRendering

' Create a TextFormatter object.
Dim formatter As TextFormatter = TextFormatter.Create()

' Format each line of text from the text store and draw it.
Do While textStorePosition < _textStore.Text.Length
   ' Create a textline from the text store using the TextFormatter object.
   Using myTextLine As TextLine = formatter.FormatLine(_textStore, textStorePosition, 96*6, New GenericTextParagraphProperties(_currentRendering), Nothing)
       ' Draw the formatted text into the drawing context.
       myTextLine.Draw(dc, linePosition, InvertAxes.None)

       ' Update the index position in the text store.
       textStorePosition += myTextLine.Length

       ' Update the line position coordinate for the displayed line.
       linePosition.Y += myTextLine.Height
   End Using
Loop

' Persist the drawn text content.
dc.Close()

' Display the formatted text in the DrawingGroup object.
myDrawingBrush.Drawing = textDest

Implementace úložiště textu klienta

Když rozšíříte modul formátování textu, budete muset implementovat a spravovat všechny aspekty úložiště textu. Toto není triviální úkol. Úložiště textu zodpovídá za sledování vlastností spuštění textu, vlastností odstavce, vložených objektů a dalšího podobného obsahu. Poskytuje také textový formátovací modul s jednotlivými TextRun objekty, které textový formátovací modul používá k vytváření TextLine objektů.

Aby bylo možné zpracovat virtualizaci textového úložiště, musí být textové úložiště odvozeno z TextSource. TextSource definuje metodu, pomocí které formátovací modul textu načítá text z úložiště textu. GetTextRun je metoda používaná textovým formátovacím programem k načtení textu, která se používá při formátování řádku. Volání opakovaně GetTextRun provádí formátovací modul textu, dokud nedojde k některé z následujících podmínek:

  • Vrátí TextEndOfLine se podtřída nebo podtřída.

  • Kumulovaná šířka textu překračuje maximální šířku čáry zadanou v volání pro vytvoření formátovače textu nebo volání metody textového FormatLine formátovače.

  • Vrátí se sekvence novéhořádku Unicode, například CF, LF nebo CRLF.

Poskytování spuštění textu

Jádrem procesu formátování textu je interakce mezi formátovačem textu a úložištěm textu. TextSource Implementace poskytuje textový formátovací modul TextRun s objekty a vlastnostmi, se kterými se má text formátovat. Tuto interakci zpracovává GetTextRun metoda, která je volána textovým formátovačem.

Následující tabulka uvádí některé předdefinované TextRun objekty.

Typ textového spuštění Využití
TextCharacters Specializovaný text se spouští k předání reprezentace znaků glyfů zpět do textového formátovače.
TextEmbeddedObject Specializovaný text se používá k poskytování obsahu, ve kterém se měří, testuje a kreslení provádí celý, například tlačítko nebo obrázek v textu.
TextEndOfLine Specializovaný text se používá k označení konce řádku.
TextEndOfParagraph Specializovaný text se používá k označení konce odstavce.
TextEndOfSegment Specializované spuštění textu, které slouží k označení konce segmentu, například k ukončení oboru ovlivněného předchozím TextModifier spuštěním.
TextHidden Specializovaný text se používá k označení rozsahu skrytých znaků.
TextModifier Specializovaný textový běh použitý k úpravě vlastností textu se spouští v jeho oboru. Obor se rozšiřuje na další odpovídající TextEndOfSegment spuštění textu nebo na další TextEndOfParagraph.

Libovolný z předdefinovaných TextRun objektů může být podtříděn. To umožňuje zdroji textu poskytnout textový formátovací modul s textem, který obsahuje vlastní data.

Následující příklad ukazuje metodu GetTextRun . Toto textové úložiště vrací TextRun objekty do textového formátovače pro zpracování.

// Used by the TextFormatter object to retrieve a run of text from the text source.
public override TextRun GetTextRun(int textSourceCharacterIndex)
{
   // Make sure text source index is in bounds.
   if (textSourceCharacterIndex < 0)
      throw new ArgumentOutOfRangeException("textSourceCharacterIndex", "Value must be greater than 0.");
   if (textSourceCharacterIndex >= _text.Length)
   {
      return new TextEndOfParagraph(1);
   }

   // Create TextCharacters using the current font rendering properties.
   if (textSourceCharacterIndex < _text.Length)
   {
      return new TextCharacters(
         _text,
         textSourceCharacterIndex,
         _text.Length - textSourceCharacterIndex,
         new GenericTextRunProperties(_currentRendering));
   }

   // Return an end-of-paragraph if no more text source.
   return new TextEndOfParagraph(1);
}

' Used by the TextFormatter object to retrieve a run of text from the text source.
Public Overrides Function GetTextRun(ByVal textSourceCharacterIndex As Integer) As TextRun
   ' Make sure text source index is in bounds.
   If textSourceCharacterIndex < 0 Then
      Throw New ArgumentOutOfRangeException("textSourceCharacterIndex", "Value must be greater than 0.")
   End If
   If textSourceCharacterIndex >= _text.Length Then
      Return New TextEndOfParagraph(1)
   End If

   ' Create TextCharacters using the current font rendering properties.
   If textSourceCharacterIndex < _text.Length Then
      Return New TextCharacters(_text, textSourceCharacterIndex, _text.Length - textSourceCharacterIndex, New GenericTextRunProperties(_currentRendering))
   End If

   ' Return an end-of-paragraph if no more text source.
   Return New TextEndOfParagraph(1)
End Function

Poznámka:

V tomto příkladu poskytuje úložiště textu stejné vlastnosti textu pro celý text. Pokročilá úložiště textu by musela implementovat vlastní správu rozsahu, aby jednotlivé znaky měly různé vlastnosti.

Určení vlastností formátování

TextRun objekty jsou formátovány pomocí vlastností poskytovaných textovým úložištěm. Tyto vlastnosti mají dva typy a TextParagraphPropertiesTextRunProperties. TextParagraphProperties popisovač inkluzivních vlastností odstavce, například TextAlignment a FlowDirection. TextRunProperties jsou vlastnosti, které se můžou lišit pro každý text spuštěný v odstavci, například štětec popředí a Typefacevelikost písma. Chcete-li implementovat vlastní odstavce a vlastní typy vlastností spuštění textu, musí vaše aplikace vytvořit třídy odvozené z TextParagraphProperties a TextRunProperties v uvedeném pořadí.

Viz také