FormattedText.BuildGeometry(Point) 方法

定义

命名空间:

System.Windows.Media

程序集:

PresentationCore.dll

返回一个 Geometry 对象，该对象表示格式化文本，包括所有标志符号和文本修饰。

public:
 System::Windows::Media::Geometry ^ BuildGeometry(System::Windows::Point origin);

public System.Windows.Media.Geometry BuildGeometry (System.Windows.Point origin);

member this.BuildGeometry : System.Windows.Point -> System.Windows.Media.Geometry

Public Function BuildGeometry (origin As Point) As Geometry

参数

origin

Point

所生成的几何图形的左上原点。

返回

Geometry

格式化文本的 Geometry 对象表示形式。

示例

以下示例演示如何创建对象 FormattedText 并检索格式化文本及其边界框的几何图形。

/// <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 highlight.
    if (Highlight == true)
    {
        _textHighLightGeometry = formattedText.BuildHighlightGeometry(new System.Windows.Point(0, 0));
    }
}

''' <summary>
''' Create the outline geometry based on the formatted text.
''' </summary>
Public Sub CreateText()
    Dim fontStyle As FontStyle = FontStyles.Normal
    Dim fontWeight As FontWeight = FontWeights.Medium

    If Bold = True Then
        fontWeight = FontWeights.Bold
    End If
    If Italic = True Then
        fontStyle = FontStyles.Italic
    End If

    ' Create the formatted text based on the properties set.
    Dim formattedText As New FormattedText(Text, CultureInfo.GetCultureInfo("en-us"), FlowDirection.LeftToRight, New Typeface(Font, fontStyle, fontWeight, FontStretches.Normal), FontSize, 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 Point(0, 0))

    ' Build the geometry object that represents the text highlight.
    If Highlight = True Then
        _textHighLightGeometry = formattedText.BuildHighlightGeometry(New Point(0, 0))
    End If
End Sub

注解

当文本转换为 Geometry 对象时，它不再是字符集合 - 不能修改文本字符串中的字符。 但是，可修改已转换文本的笔划和填充属性，以此来影响该文本的外观。

以下示例演示了通过修改转换文本的笔划和填充来创建视觉效果的几种方法。

将笔划和填充设置为不同颜色的示例

应用于笔划的图像画笔示例

转换为对象并呈现为 Geometry 对象的文本可能与直接呈现的文本看起来不同：

• 未使用 ClearType 呈现转换为 Geometry 对象的文本。 此外，转换后的基线不会贴靠到整个显示像素。

• 小字体（如在正文文本中常用的字体）可能会丢失易读性、显得模糊和外观变化。