FormattedText.BuildGeometry(Point) Método

Definición

Devuelve un objeto Geometry que representa el texto con formato, incluidos todos los glifos y decoraciones del texto.

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

Parámetros

origin
Point

Origen superior izquierdo de la geometría resultante.

Devoluciones

Representación del objeto Geometry del texto con formato.

Ejemplos

En el ejemplo siguiente se muestra cómo crear un FormattedText objeto y recuperar las geometrías del texto con formato y su cuadro de límite.

/// <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) fontWeight = FontWeights.Bold;
    if (Italic) 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)
    {
        _textHighLightGeometry = formattedText.BuildHighlightGeometry(new System.Windows.Point(0, 0));
    }
}

Comentarios

Cuando el texto se convierte en un Geometry objeto , ya no es una colección de caracteres, no se pueden modificar los caracteres de la cadena de texto. Sin embargo, puede afectar a la apariencia del texto convertido modificando sus propiedades de trazo y relleno.

En los ejemplos siguientes se muestran varias maneras de crear efectos visuales modificando el trazo y el relleno del texto convertido.

Texto con diferentes colores para relleno y trazo Ejemplo de establecimiento de trazo y relleno en diferentes colores

Texto con pincel de imagen aplicado al trazo Ejemplo de pincel de imagen aplicado al trazo

El texto que se convierte en y se representa como un Geometry objeto puede no tener el mismo aspecto que el texto representado directamente:

  • El texto convertido en un Geometry objeto no se representa mediante ClearType. Además, la línea base del convertido no se ajusta a un píxel de pantalla completo.

  • Las fuentes pequeñas, como las que se usan normalmente en el texto del cuerpo, pueden perder legibilidad, aparecer borrosas y variar en apariencia.

Se aplica a

Producto Versiones
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9