TextPath

TextPath class

Définit le texte et le formatage du chemin du texte (d’un objet WordArt).

Pour en savoir plus, visitez leTravailler avec des formes article documentaire.

public class TextPath

Propriétés

NomLa description
Bold { get; set; }True si la police est formatée en gras.
FitPath { get; set; }Définit si le texte correspond au chemin d’une forme.
FitShape { get; set; }Définit si le texte s’adapte au cadre de délimitation d’une forme.
FontFamily { get; set; }Définit la famille de la police Textpath.
Italic { get; set; }True si la police est au format italique.
Kerning { get; set; }Détermine si le crénage est activé.
On { get; set; }Définit si le texte est affiché.
ReverseRows { get; set; }Détermine si l’ordre de disposition des lignes est inversé.
RotateLetters { get; set; }Détermine si les lettres du texte sont pivotées.
SameLetterHeights { get; set; }Détermine si toutes les lettres auront la même hauteur quelle que soit la casse initiale.
Shadow { get; set; }Définit si une ombre est appliquée au texte sur un chemin de texte.
Size { get; set; }Définit la taille de la police en points.
SmallCaps { get; set; }Vrai si la police est formatée en petites majuscules.
Spacing { get; set; }Définit la quantité d’espacement pour le texte. 1 signifie 100%.
StrikeThrough { get; set; }Vrai si la police est formatée en texte barré.
Text { get; set; }Définit le texte du chemin de texte.
TextPathAlignment { get; set; }Définit l’alignement du texte.
Trim { get; set; }Détermine si l’espace supplémentaire est supprimé au-dessus et en dessous du texte.
Underline { get; set; }Vrai si la police est soulignée.
XScale { get; set; }Détermine si un chemin de texte droit sera utilisé à la place du chemin de forme.

Remarques

Utilisez leTextPath propriété pour accéder aux propriétés WordArt d’une forme. Vous ne créez pas d’instances de laTextPath classe directement.

Exemples

Montre comment travailler avec WordArt.

public void InsertTextPaths()
{
    Document doc = new Document();

    // Insère un objet WordArt pour afficher le texte sous une forme que nous pouvons redimensionner et déplacer à l'aide de la souris dans Microsoft Word.
    // Fournissez un "ShapeType" comme argument pour définir une forme pour le WordArt.
    Shape shape = AppendWordArt(doc, "Hello World! This text is bold, and italic.", 
        "Arial", 480, 24, Color.White, Color.Black, ShapeType.TextPlainText);

    // Applique les paramètres de formatage "Gras" et "Italique" au texte en utilisant les propriétés respectives.
    shape.TextPath.Bold = true;
    shape.TextPath.Italic = true;

    // Vous trouverez ci-dessous diverses autres propriétés liées au formatage du texte.
    Assert.False(shape.TextPath.Underline);
    Assert.False(shape.TextPath.Shadow);
    Assert.False(shape.TextPath.StrikeThrough);
    Assert.False(shape.TextPath.ReverseRows);
    Assert.False(shape.TextPath.XScale);
    Assert.False(shape.TextPath.Trim);
    Assert.False(shape.TextPath.SmallCaps);

    Assert.AreEqual(36.0, shape.TextPath.Size);
    Assert.AreEqual("Hello World! This text is bold, and italic.", shape.TextPath.Text);
    Assert.AreEqual(ShapeType.TextPlainText, shape.ShapeType);

    // Utilisez la propriété "On" pour afficher/masquer le texte.
    shape = AppendWordArt(doc, "On set to \"true\"", "Calibri", 150, 24, Color.Yellow, Color.Red, ShapeType.TextPlainText);
    shape.TextPath.On = true;

    shape = AppendWordArt(doc, "On set to \"false\"", "Calibri", 150, 24, Color.Yellow, Color.Purple, ShapeType.TextPlainText);
    shape.TextPath.On = false;

    // Utilisez la propriété "Kerning" pour activer/désactiver l'espacement de crénage entre certains caractères.
    shape = AppendWordArt(doc, "Kerning: VAV", "Times New Roman", 90, 24, Color.Orange, Color.Red, ShapeType.TextPlainText);
    shape.TextPath.Kerning = true;

    shape = AppendWordArt(doc, "No kerning: VAV", "Times New Roman", 100, 24, Color.Orange, Color.Red, ShapeType.TextPlainText);
    shape.TextPath.Kerning = false;

    // Utilisez la propriété "Espacement" pour définir l'espacement personnalisé entre les caractères sur une échelle de 0,0 (aucun) à 1,0 (par défaut).
    shape = AppendWordArt(doc, "Spacing set to 0.1", "Calibri", 120, 24, Color.BlueViolet, Color.Blue, ShapeType.TextCascadeDown);
    shape.TextPath.Spacing = 0.1;

    // Définissez la propriété "RotateLetters" sur "true" pour faire pivoter chaque caractère de 90 degrés dans le sens inverse des aiguilles d'une montre.
    shape = AppendWordArt(doc, "RotateLetters", "Calibri", 200, 36, Color.GreenYellow, Color.Green, ShapeType.TextWave);
    shape.TextPath.RotateLetters = true;

    // Définissez la propriété "SameLetterHeights" sur "true" pour que la hauteur x de chaque caractère soit égale à la hauteur des majuscules.
    shape = AppendWordArt(doc, "Same character height for lower and UPPER case", "Calibri", 300, 24, Color.DeepSkyBlue, Color.DodgerBlue, ShapeType.TextSlantUp);
    shape.TextPath.SameLetterHeights = true;

    // Par défaut, la taille du texte sera toujours adaptée à la taille de la forme contenant, remplaçant le paramètre de taille du texte.
    shape = AppendWordArt(doc, "FitShape on", "Calibri", 160, 24, Color.LightBlue, Color.Blue, ShapeType.TextPlainText);
    Assert.True(shape.TextPath.FitShape);
    shape.TextPath.Size = 24.0;

    // Si on met la propriété "FitShape: à "false", le texte gardera la taille
    // que la propriété "Size" spécifie quelle que soit la taille de la forme.
    // Utilisez également la propriété "TextPathAlignment" pour aligner le texte sur un côté de la forme.
    shape = AppendWordArt(doc, "FitShape off", "Calibri", 160, 24, Color.LightBlue, Color.Blue, ShapeType.TextPlainText);
    shape.TextPath.FitShape = false;
    shape.TextPath.Size = 24.0;
    shape.TextPath.TextPathAlignment = TextPathAlignment.Right;

    doc.Save(ArtifactsDir + "Shape.InsertTextPaths.docx");
}

/// <summary>
/// Insère un nouveau paragraphe contenant une forme WordArt.
/// </summary>
private static Shape AppendWordArt(Document doc, string text, string textFontFamily, double shapeWidth, double shapeHeight, Color wordArtFill, Color line, ShapeType wordArtShapeType)
{
    // Créez une forme en ligne, qui servira de conteneur pour notre WordArt.
    // La forme ne peut être une forme WordArt valide que si nous lui attribuons un ShapeType désigné par WordArt.
    // Ces types auront "Objet WordArt" dans la description,
    // et leurs noms de constantes d'énumérateur commenceront tous par "Texte".
    Shape shape = new Shape(doc, wordArtShapeType)
    {
        WrapType = WrapType.Inline,
        Width = shapeWidth,
        Height = shapeHeight,
        FillColor = wordArtFill,
        StrokeColor = line
    };

    shape.TextPath.Text = text;
    shape.TextPath.FontFamily = textFontFamily;

    Paragraph para = (Paragraph)doc.FirstSection.Body.AppendChild(new Paragraph(doc));
    para.AppendChild(shape);
    return shape;
}

Voir également

TextBoxWrapMode Enum TextPathAlignment Enum