Gewusst wie: Erstellen von Text mit Kontur

Aktualisiert: November 2007

Wenn Sie Textzeichenfolgen in einer Windows Presentation Foundation (WPF)-Anwendung mit Verzierungen versehen, verwenden Sie in den meisten Fällen Text in Form einer Auflistung diskreter Zeichen oder Symbole. Sie können beispielsweise einen Pinsel mit linearem Farbverlauf erstellen und auf die Foreground-Eigenschaft eines TextBox-Objekts anwenden. Wenn Sie das Textfeld anzeigen oder bearbeiten, wird der Pinsel mit linearem Farbverlauf automatisch auf den aktuellen Satz von Zeichen in der Textzeichenfolge angewendet.

Beispiel für die Anwendung eines Pinsel mit linearem Farbverlauf auf ein Textfeld

Sie können Text aber auch in Geometry-Objekte umwandeln, sodass Sie andere optisch vielfältige Textarten erstellen können. Sie können beispielsweise auf Grundlage der Gliederung einer Textzeichenfolge ein Geometry-Objekt erstellen.

Beispiel für die Anwendung eines Pinsels mit linearem Farbverlauf auf die Konturgeometrie von Text

Wenn Text in ein Geometry-Objekt konvertiert wird, handelt es sich nicht mehr um eine Auflistung von Zeichen. Sie können die Zeichen in der Zeichenfolge nicht mehr ändern. Sie können jedoch die Darstellung des konvertierten Texts beeinflussen, indem Sie dessen Stricheigenschaften und Fülleigenschaften ändern. Der Strich bezieht sich auf die Kontur des konvertierten Texts und die Füllung auf den Bereich innerhalb der Kontur des konvertierten Texts.

In den folgenden Beispielen werden mehrere Verfahren zum Erstellen visueller Effekte durch Ändern des Strichs und der Füllung von konvertiertem Text veranschaulicht.

Beispiel für das Festlegen von verschiedenen Farben für Striche und Füllung

Beispiel für die Anwendung eines Bildpinsels auf den Strich

Es ist auch möglich, das umgebende Feldrechteck oder die Hervorhebung des konvertierten Texts zu ändern. Im folgenden Beispiel wird das Erstellen visueller Effekte durch Ändern des Strichs und der Hervorhebung von konvertiertem Text veranschaulicht.

Beispiel für die Anwendung eines Bildpinsels auf den Strich und die Hervorhebung

Tipp

Das vollständige Codebeispiel, aus dem die folgenden Codebeispiele stammen, finden Sie unter Beispiel für ein benutzerdefiniertes Steuerelement mit gegliedertem Text.

Beispiel

Der Schlüssel bei der Konvertierung von Text in ein Geometry-Objekt liegt in der Verwendung des FormattedText-Objekts. Nachdem Sie dieses Objekt erstellt haben, können Sie den Text mit den Methoden BuildGeometry und BuildHighlightGeometry in Geometry-Objekte konvertieren. Die erste Methode gibt die Geometrie des formatierten Texts zurück und die zweite Methode die Geometrie des Felds, das den formatierten Text umgibt. Im folgenden Codebeispiel wird veranschaulicht, wie Sie ein FormattedText-Objekt erstellen, und wie Sie die Geometrien des formatierten Texts sowie seines umgebenden Felds abrufen.

/// <summary>
/// Create the outline geometry based on the formatted text.
/// </summary>
public void CreateText()
{
    System.Windows.FontStyle fontStyle = FontStyles.Normal;
    FontWeight fontWeight = FontWeights.Medium;

    if (Bold == true) fontWeight = FontWeights.Bold;
    if (Italic == true) fontStyle = FontStyles.Italic;

    // Create the formatted text based on the properties set.
    FormattedText formattedText = new FormattedText(
        Text,
        CultureInfo.GetCultureInfo("en-us"),
        FlowDirection.LeftToRight,
        new Typeface(
            Font,
            fontStyle,
            fontWeight,
            FontStretches.Normal),
        FontSize,
        System.Windows.Media.Brushes.Black // This brush does not matter since we use the geometry of the text. 
        );

    // Build the geometry object that represents the text.
    _textGeometry = formattedText.BuildGeometry(new System.Windows.Point(0, 0));

    // Build the geometry object that represents the text hightlight.
    if (Highlight == true)
    {
        _textHighLightGeometry = formattedText.BuildHighlightGeometry(new System.Windows.Point(0, 0));
    }
}

Um die abgerufenen Geometry-Objekte anzuzeigen, müssen Sie auf den DrawingContext des Objekts zugreifen, das den konvertierten Text anzeigt. In diesen Codebeispielen wird dazu ein benutzerdefiniertes Steuerelementobjekt erstellt. Dieses Objekt wird von einer Klasse abgeleitet, die benutzerdefiniertes Rendering unterstützt. Weitere Informationen über das Erstellen eines benutzerdefinierten Steuerelements finden Sie unter Beispiel für ein benutzerdefiniertes Steuerelement mit gegliedertem Text.

Um Geometry-Objekte im benutzerdefinierten Steuerelement anzuzeigen, stellen Sie eine Überschreibung für die OnRender-Methode bereit. Die überschriebene Methode sollte die DrawGeometry-Methode verwenden, um die Geometry-Objekte zu zeichnen.

/// <summary>
/// OnRender override draws the geometry of the text and optional highlight.
/// </summary>
/// <param name="drawingContext">Drawing context of the OutlineText control.</param>
protected override void OnRender(DrawingContext drawingContext)
{
    // Draw the outline based on the properties that are set.
    drawingContext.DrawGeometry(Fill, new System.Windows.Media.Pen(Stroke, StrokeThickness), _textGeometry);

    // Draw the text highlight based on the properties that are set.
    if (Highlight == true)
    {
        drawingContext.DrawGeometry(null, new System.Windows.Media.Pen(Stroke, StrokeThickness), _textHighLightGeometry);
    }
}

Siehe auch

Aufgaben

Beispiel für ein benutzerdefiniertes Steuerelement mit gegliedertem Text

Konzepte

Zeichnen von formatiertem Text