TextPath
Contenuti
[
Nascondere
]TextPath class
Definisce il testo e la formattazione del percorso del testo (di un oggetto WordArt).
Per saperne di più, visita ilLavorare con le forme articolo di documentazione.
public class TextPath
Proprietà
Nome | Descrizione |
---|---|
Bold { get; set; } | Vero se il carattere è formattato in grassetto. |
FitPath { get; set; } | Definisce se il testo si adatta al percorso di una forma. |
FitShape { get; set; } | Definisce se il testo si adatta al riquadro di delimitazione di una forma. |
FontFamily { get; set; } | Definisce la famiglia del carattere textpath. |
Italic { get; set; } | Vero se il carattere è formattato come corsivo. |
Kerning { get; set; } | Determina se la crenatura è attivata. |
On { get; set; } | Definisce se il testo viene visualizzato. |
ReverseRows { get; set; } | Determina se l’ordine di layout delle righe è invertito. |
RotateLetters { get; set; } | Determina se le lettere del testo vengono ruotate. |
SameLetterHeights { get; set; } | Determina se tutte le lettere avranno la stessa altezza indipendentemente dal maiuscolo/minuscolo iniziale. |
Shadow { get; set; } | Definisce se viene applicata un’ombra al testo su un percorso di testo. |
Size { get; set; } | Definisce la dimensione del carattere in punti. |
SmallCaps { get; set; } | Vero se il carattere è formattato come lettere maiuscole. |
Spacing { get; set; } | Definisce la quantità di spaziatura per il testo. 1 significa 100%. |
StrikeThrough { get; set; } | Vero se il carattere è formattato come testo barrato. |
Text { get; set; } | Definisce il testo del percorso testo. |
TextPathAlignment { get; set; } | Definisce l’allineamento del testo. |
Trim { get; set; } | Determina se lo spazio extra viene rimosso sopra e sotto il testo. |
Underline { get; set; } | Vero se il carattere è sottolineato. |
XScale { get; set; } | Determina se verrà utilizzato un percorso di testo lineare al posto del percorso della forma. |
Osservazioni
Usa ilTextPath
property per accedere alle proprietà WordArt di una forma. Non si creano istanze diTextPath
classe direttamente.
Esempi
Mostra come lavorare con WordArt.
public void InsertTextPaths()
{
Document doc = new Document();
// Inserisci un oggetto WordArt per visualizzare il testo in una forma che possiamo ridimensionare e spostare utilizzando il mouse in Microsoft Word.
// Fornire un "ShapeType" come argomento per impostare una forma per WordArt.
Shape shape = AppendWordArt(doc, "Hello World! This text is bold, and italic.",
"Arial", 480, 24, Color.White, Color.Black, ShapeType.TextPlainText);
// Applica le impostazioni di formattazione "Grassetto" e "Corsivo" al testo utilizzando le rispettive proprietà.
shape.TextPath.Bold = true;
shape.TextPath.Italic = true;
// Di seguito sono riportate varie altre proprietà relative alla formattazione del testo.
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);
// Utilizza la proprietà "On" per mostrare/nascondere il testo.
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;
// Utilizza la proprietà "Cernatura" per abilitare/disabilitare la spaziatura della crenatura tra determinati caratteri.
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;
// Utilizza la proprietà "Spaziatura" per impostare la spaziatura personalizzata tra i caratteri su una scala da 0,0 (nessuna) a 1,0 (predefinita).
shape = AppendWordArt(doc, "Spacing set to 0.1", "Calibri", 120, 24, Color.BlueViolet, Color.Blue, ShapeType.TextCascadeDown);
shape.TextPath.Spacing = 0.1;
// Imposta la proprietà "RotateLetters" su "true" per ruotare ciascun carattere di 90 gradi in senso antiorario.
shape = AppendWordArt(doc, "RotateLetters", "Calibri", 200, 36, Color.GreenYellow, Color.Green, ShapeType.TextWave);
shape.TextPath.RotateLetters = true;
// Imposta la proprietà "SameLetterHeights" su "true" per far sì che l'altezza x di ogni carattere sia uguale all'altezza del cappuccio.
shape = AppendWordArt(doc, "Same character height for lower and UPPER case", "Calibri", 300, 24, Color.DeepSkyBlue, Color.DodgerBlue, ShapeType.TextSlantUp);
shape.TextPath.SameLetterHeights = true;
// Per impostazione predefinita, la dimensione del testo verrà sempre ridimensionata per adattarsi alla dimensione della forma che lo contiene, sovrascrivendo l'impostazione della dimensione del testo.
shape = AppendWordArt(doc, "FitShape on", "Calibri", 160, 24, Color.LightBlue, Color.Blue, ShapeType.TextPlainText);
Assert.True(shape.TextPath.FitShape);
shape.TextPath.Size = 24.0;
// Se impostiamo la proprietà "FitShape: su "false", il testo manterrà la dimensione
// che la proprietà "Size" specifica indipendentemente dalla dimensione della forma.
// Utilizza la proprietà "TextPathAlignment" anche per allineare il testo a un lato della forma.
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>
/// Inserisci un nuovo paragrafo con una forma WordArt al suo interno.
/// </summary>
private static Shape AppendWordArt(Document doc, string text, string textFontFamily, double shapeWidth, double shapeHeight, Color wordArtFill, Color line, ShapeType wordArtShapeType)
{
// Crea una forma in linea, che servirà da contenitore per la nostra WordArt.
// La forma può essere una forma WordArt valida solo se le assegniamo uno ShapeType designato da WordArt.
// Questi tipi avranno "Oggetto WordArt" nella descrizione,
// e i nomi delle costanti dell'enumeratore inizieranno tutti con "Testo".
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;
}
Guarda anche
- spazio dei nomi Aspose.Words.Drawing
- assemblea Aspose.Words