Formattare le forme PowerPoint in .NET
Introduzione
Formatta le forme in PowerPoint regolando i contorni, i riempimenti e gli effetti. Aspose.Slides per .NET consente di controllare queste impostazioni programmaticamente, inclusi trasparenza, rotazione e formattazione 3D.

Aspose.Slides per .NET fornisce interfacce e proprietà che consentono di formattare le forme utilizzando le stesse opzioni disponibili in PowerPoint.
Formattare le linee
Usa IShape.LineFormat per controllare il contorno di una forma. Questo esempio crea un rettangolo non riempito con un contorno blu a tratteggio. ILineFormat.Style seleziona una linea composta spessa-sottile, mentre ILineFormat.Width imposta la larghezza a 7 punti e ILineFormat.DashStyle sceglie il modello di tratto.
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 150, 75);
shape.FillFormat.FillType = FillType.NoFill;
shape.LineFormat.Style = LineStyle.ThickThin;
shape.LineFormat.Width = 7;
shape.LineFormat.DashStyle = LineDashStyle.Dash;
shape.LineFormat.FillFormat.FillType = FillType.Solid;
shape.LineFormat.FillFormat.SolidFillColor.Color = Color.Blue;
presentation.Save("formatted_lines.pptx", SaveFormat.Pptx);
Il risultato:

Imposta modelli di tratto personalizzati
Usa ILineFormat.CustomDashPattern quando gli stili di linea predefiniti non forniscono le lunghezze di tratto e i vuoti di cui hai bisogno, ad esempio per contorni aziendali o diagrammi tecnici. L’assegnazione di un modello imposta automaticamente ILineFormat.DashStyle su LineDashStyle.Custom.
Le voci dell’array alternano lunghezze di tratto e di vuoto, iniziando con un tratto. Ogni valore è un multiplo della larghezza della linea: { 4, 2 } con larghezza di 3 punti genera un tratto di 12 punti seguito da un vuoto di 6 punti. Usa coppie di valori finiti e non negativi per definire segmenti completi di tratto‑vuoto. L’esempio utilizza valori positivi per mantenere visibili tutti i tratti e i vuoti.
Questo esempio crea cinque linee blu della stessa lunghezza e con estremità piatte. Le prime tre confrontano i modelli a una larghezza di 3 punti. La quarta ripete il primo modello a doppia larghezza, raddoppiando sia le lunghezze dei tratti sia dei vuoti. La quinta passa da un modello personalizzato a una linea continua.
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation();
presentation.SlideSize.SetSize(600, 300, SlideSizeScaleType.DoNotScale);
var slide = presentation.Slides[0];
var patterns = new[]
{
new float[] { 4, 2 },
new float[] { 1, 2 },
new float[] { 6, 2, 1, 2 },
new float[] { 4, 2 },
new float[] { 4, 2 }
};
for (var i = 0; i < patterns.Length; i++)
{
var line = slide.Shapes.AddAutoShape(ShapeType.Line, 50, 50 + i * 50, 500, 0);
line.LineFormat.Width = i == 3 ? 6 : 3;
line.LineFormat.FillFormat.FillType = FillType.Solid;
line.LineFormat.FillFormat.SolidFillColor.Color = Color.DarkBlue;
line.LineFormat.CapStyle = LineCapStyle.Flat;
line.LineFormat.BeginArrowheadStyle = LineArrowheadStyle.None;
line.LineFormat.EndArrowheadStyle = LineArrowheadStyle.None;
line.LineFormat.CustomDashPattern = patterns[i];
}
// Return the last line to a solid style.
slide.Shapes[4].LineFormat.DashStyle = LineDashStyle.Solid;
presentation.Save("custom_dash_patterns.pptx", SaveFormat.Pptx);
Per tornare a uno stile di tratto predefinito, assegna LineDashStyle.Dash a ILineFormat.DashStyle. Lo stile selezionato controlla l’aspetto della linea.
Il risultato in PowerPoint, dall’alto verso il basso: {4, 2}, 3 pt; {1, 2}, 3 pt; {6, 2, 1, 2}, 3 pt; {4, 2}, 6 pt; e Solid, 3 pt.

Imposta le estremità della linea
Usa ILineFormat.CapStyle per impostare le estremità di una linea aperta. L’enumerazione LineCapStyle fornisce tre stili di estremità espliciti:
Flat: il tratto termina al punto finale.Round: un’estremità semicircolare si estende oltre il punto finale per metà della larghezza della linea.Square: un’estremità quadrata si estende oltre il punto finale per metà della larghezza della linea.
L’enumerazione include anche NotDefined, che indica che nessuno stile di estremità è stato assegnato esplicitamente.
Le estremità sono diverse dalle punte delle frecce, che aggiungono simboli alle estremità della linea, e dalle giunzioni, che controllano gli angoli tra i segmenti della linea. Questo esempio disabilita le punte delle frecce tramite ILineFormat.BeginArrowheadStyle e ILineFormat.EndArrowheadStyle in modo che vengano confrontate solo le forme delle estremità.
L’esempio seguente crea tre linee orizzontali altrimenti identiche, larghe 20 punti. Dall’alto verso il basso, usano estremità piatte, arrotondate e quadrate. Le loro estremità hanno le stesse coordinate orizzontali; le estremità arrotondate e quadrate si estendono di 10 punti oltre ciascuna estremità.
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation();
presentation.SlideSize.SetSize(500, 240, SlideSizeScaleType.DoNotScale);
var slide = presentation.Slides[0];
var capStyles = new[] { LineCapStyle.Flat, LineCapStyle.Round, LineCapStyle.Square };
for (var i = 0; i < capStyles.Length; i++)
{
var line = slide.Shapes.AddAutoShape(ShapeType.Line, 100, 50 + i * 70, 300, 0);
line.LineFormat.Width = 20;
line.LineFormat.FillFormat.FillType = FillType.Solid;
line.LineFormat.FillFormat.SolidFillColor.Color = Color.DarkBlue;
line.LineFormat.DashStyle = LineDashStyle.Solid;
line.LineFormat.CapStyle = capStyles[i];
line.LineFormat.BeginArrowheadStyle = LineArrowheadStyle.None;
line.LineFormat.EndArrowheadStyle = LineArrowheadStyle.None;
}
presentation.Save("line_caps.pptx", SaveFormat.Pptx);
Il risultato in PowerPoint, dall’alto verso il basso: Flat, Round, e Square.

Applicare effetti di schizzi alle linee della forma
Un effetto di schizzo rende una linea della forma simile a un tratto a mano libera. Usa IShape.LineFormat per accedere alle impostazioni della linea, ILineFormat.SketchFormat per le impostazioni dello schizzo e ISketchFormat.SketchType per selezionare un valore dall’enumerazione LineSketchType.
Il codice C# seguente mostra come applicare un effetto LineSketchType.Curved, leggere il valore assegnato esplicitamente e rimuovere l’effetto con LineSketchType.None:
using System;
using Aspose.Slides;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 200, 100);
var sketchFormat = shape.LineFormat.SketchFormat;
sketchFormat.SketchType = LineSketchType.Curved;
var explicitSketchType = sketchFormat.SketchType;
Console.WriteLine($"Explicit sketch type: {explicitSketchType}");
sketchFormat.SketchType = LineSketchType.None;
Il valore restituito da ISketchFormat.SketchType rappresenta l’impostazione assegnata direttamente alla forma. Se la formattazione della linea può essere ereditata da un tema, dal master slide o dal layout slide, usa ILineFormat.GetEffective, accedi a ILineFormatEffectiveData.SketchFormat e leggi ISketchFormatEffectiveData.SketchType. Il valore effettivo riflette la formattazione effettivamente applicata dopo la risoluzione dell’ereditarietà. Questo esempio richiede una presentazione esistente con almeno una forma nella prima diapositiva e stampa entrambi i valori:
using System;
using Aspose.Slides;
using var presentation = new Presentation("presentation.pptx");
var shape = presentation.Slides[0].Shapes[0];
var lineFormat = shape.LineFormat;
var explicitSketchType = lineFormat.SketchFormat.SketchType;
var effectiveLineFormat = lineFormat.GetEffective();
var effectiveSketchType = effectiveLineFormat.SketchFormat.SketchType;
Console.WriteLine($"Explicit sketch type: {explicitSketchType}");
Console.WriteLine($"Effective sketch type: {effectiveSketchType}");
Formattare gli stili di giunzione
Ecco le tre opzioni di tipo di giunzione:
- Round
- Miter
- Bevel
Lo stile di giunzione controlla come due segmenti di contorno si incontrano a un angolo. Usa Round per angoli arrotondati, Miter per angoli affilati o Bevel per angoli smussati.

Questo esempio crea tre rettangoli neri con contorni blu larghi 15 punti. Imposta ILineFormat.JoinStyle sui valori miter, bevel e round dell’enumerazione LineJoinStyle, rispettivamente, per confrontare come vengono disegnati gli angoli.
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var miterShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 20, 20, 150, 75);
var bevelShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 210, 20, 150, 75);
var roundShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 20, 135, 150, 75);
miterShape.FillFormat.FillType = FillType.Solid;
miterShape.FillFormat.SolidFillColor.Color = Color.Black;
bevelShape.FillFormat.FillType = FillType.Solid;
bevelShape.FillFormat.SolidFillColor.Color = Color.Black;
roundShape.FillFormat.FillType = FillType.Solid;
roundShape.FillFormat.SolidFillColor.Color = Color.Black;
miterShape.LineFormat.Width = 15;
bevelShape.LineFormat.Width = 15;
roundShape.LineFormat.Width = 15;
miterShape.LineFormat.FillFormat.FillType = FillType.Solid;
miterShape.LineFormat.FillFormat.SolidFillColor.Color = Color.Blue;
bevelShape.LineFormat.FillFormat.FillType = FillType.Solid;
bevelShape.LineFormat.FillFormat.SolidFillColor.Color = Color.Blue;
roundShape.LineFormat.FillFormat.FillType = FillType.Solid;
roundShape.LineFormat.FillFormat.SolidFillColor.Color = Color.Blue;
miterShape.LineFormat.JoinStyle = LineJoinStyle.Miter;
bevelShape.LineFormat.JoinStyle = LineJoinStyle.Bevel;
roundShape.LineFormat.JoinStyle = LineJoinStyle.Round;
miterShape.TextFrame.Text = "Miter Join Style";
bevelShape.TextFrame.Text = "Bevel Join Style";
roundShape.TextFrame.Text = "Round Join Style";
presentation.Save("join_styles.pptx", SaveFormat.Pptx);
Limitare le giunzioni miter in angoli affilati
Usa ILineFormat.MiterLimit con ILineFormat.JoinStyle impostato su LineJoinStyle.Miter per limitare quanto può estendersi un angolo affilato.
Il limite è un rapporto tra la distanza tra gli angoli interno ed esterno della giunzione e la larghezza della linea. Ad esempio, un valore di 8 consente una lunghezza di miter fino a otto volte la larghezza della linea; non è una misura in punti. Se l’angolo supera il limite, PowerPoint utilizza una giunzione smussata in quel punto. Un limite più grande permette punte più affilate. L’impostazione influenza solo le giunzioni miter e non ha effetto visibile quando l’angolo rimane entro entrambi i limiti.
Questo esempio crea due triangoli identici non riempiti con contorni larghi 20 punti. Il triangolo sinistro usa un limite di 2, quello destro di 8. Ogni triangolo è largo 80 punti e alto 160 punti, così l’angolo superiore ha un rapporto lunghezza‑miter‑a‑larghezza della linea di circa 4.12. Di conseguenza, PowerPoint smussa il vertice sinistro e mantiene quello destro.
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation();
presentation.SlideSize.SetSize(500, 320, SlideSizeScaleType.DoNotScale);
var slide = presentation.Slides[0];
var miterLimits = new[] { 2f, 8f };
for (var i = 0; i < miterLimits.Length; i++)
{
var triangle = slide.Shapes.AddAutoShape(ShapeType.Triangle, 90 + i * 240, 110, 80, 160);
triangle.FillFormat.FillType = FillType.NoFill;
triangle.LineFormat.Width = 20;
triangle.LineFormat.FillFormat.FillType = FillType.Solid;
triangle.LineFormat.FillFormat.SolidFillColor.Color = Color.DarkBlue;
triangle.LineFormat.JoinStyle = LineJoinStyle.Miter;
triangle.LineFormat.MiterLimit = miterLimits[i];
}
presentation.Save("miter_limits.pptx", SaveFormat.Pptx);
Il risultato in PowerPoint: Miter limit 2 a sinistra e miter limit 8 a destra.

Riempimento gradiente
Un riempimento gradiente sfuma i colori lungo una forma. Questo esempio riempie un’ellisse con un gradiente lineare a 45° dal rosso al viola usando IFillFormat.GradientFormat. Il metodo IGradientStopCollection.Add posiziona le fermate di colore a 0 e 1, all’inizio e alla fine del gradiente. Cancellare le fermate esistenti garantisce che vengano usati solo questi due colori.
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var shape = slide.Shapes.AddAutoShape(ShapeType.Ellipse, 50, 50, 150, 75);
shape.FillFormat.FillType = FillType.Gradient;
shape.FillFormat.GradientFormat.GradientShape = GradientShape.Linear;
shape.FillFormat.GradientFormat.LinearGradientAngle = 45;
shape.FillFormat.GradientFormat.GradientStops.Clear();
shape.FillFormat.GradientFormat.GradientStops.Add(1.0f, PresetColor.Purple);
shape.FillFormat.GradientFormat.GradientStops.Add(0.0f, PresetColor.Red);
presentation.Save("gradient_fill.pptx", SaveFormat.Pptx);
Il risultato:

Se un gradiente appare diverso in un’immagine esportata rispetto a PowerPoint, consulta Choose a Gradient Rendering Style. Puoi selezionare uno stile di rendering senza modificare il gradiente memorizzato nella presentazione.
Imposta l’angolo del gradiente lineare
Usa IGradientFormat.LinearGradientAngle per controllare l’orientamento di un riempimento GradientShape.Linear. L’angolo è misurato in gradi e aumenta in senso orario: 0 va da sinistra a destra, 90 dall’alto verso il basso, 180 da destra a sinistra e 270 dal basso verso l’alto. Sono supportati angoli frazionari. Angoli finiti al di fuori di [0, 360) sono normalizzati a una rotazione completa; ad esempio, -45 diventa 315 e 360 diventa 0.
Questo esempio crea sei rettangoli con fermate rosse, verdi e blu identiche alle posizioni 0, 0.5 e 1. La scala è disabilitata così l’angolo può essere confrontato indipendentemente dalle proporzioni dei rettangoli. Gli angoli, da sinistra a destra, sono 0, 45 e 90 nella prima riga, e 135, 180 e 270 nella seconda riga.
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation();
presentation.SlideSize.SetSize(720, 400, SlideSizeScaleType.DoNotScale);
var slide = presentation.Slides[0];
var angles = new float[] { 0, 45, 90, 135, 180, 270 };
for (var i = 0; i < angles.Length; i++)
{
var x = 30 + (i % 3) * 230;
var y = 30 + (i / 3) * 190;
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, x, y, 200, 150);
shape.LineFormat.FillFormat.FillType = FillType.NoFill;
shape.FillFormat.FillType = FillType.Gradient;
var gradient = shape.FillFormat.GradientFormat;
gradient.GradientShape = GradientShape.Linear;
gradient.GradientStops.Clear();
gradient.GradientStops.Add(0f, Color.Red);
gradient.GradientStops.Add(0.5f, Color.Lime);
gradient.GradientStops.Add(1f, Color.Blue);
gradient.LinearGradientScaled = NullableBool.False;
gradient.LinearGradientAngle = angles[i];
}
presentation.Save("linear_gradient_angles.pptx", SaveFormat.Pptx);
Il risultato in PowerPoint:

Scala un gradiente lineare con la forma
IGradientFormat.LinearGradientScaled accetta un valore NullableBool. Impostalo esplicitamente su False per mantenere l’angolo geometrico del gradiente quando le proporzioni della forma cambiano, o su True per scalare il gradiente con larghezza e altezza della forma. Con la scala attiva, l’angolo visibile può differire dall’angolo assegnato su una forma non quadrata.
L’esempio seguente usa un angolo di 45 gradi e le stesse fermate di colore dell’esempio di confronto degli angoli. La colonna sinistra usa False; la colonna destra usa True. Ogni colonna contiene un rettangolo largo sopra un rettangolo alto. Entrambi partono dalle stesse dimensioni larghe; la modifica di larghezza e altezza del secondo rettangolo dimostra come il riempimento risponde al ridimensionamento senza cambiare le impostazioni del gradiente.
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation();
presentation.SlideSize.SetSize(720, 460, SlideSizeScaleType.DoNotScale);
var slide = presentation.Slides[0];
var scalingOptions = new[] { NullableBool.False, NullableBool.True };
for (var column = 0; column < scalingOptions.Length; column++)
{
for (var row = 0; row < 2; row++)
{
var x = 30 + column * 360;
var y = row == 0 ? 30 : 150;
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, x, y, 300, 90);
shape.LineFormat.FillFormat.FillType = FillType.NoFill;
shape.FillFormat.FillType = FillType.Gradient;
var gradient = shape.FillFormat.GradientFormat;
gradient.GradientShape = GradientShape.Linear;
gradient.GradientStops.Clear();
gradient.GradientStops.Add(0f, Color.Red);
gradient.GradientStops.Add(0.5f, Color.Lime);
gradient.GradientStops.Add(1f, Color.Blue);
gradient.LinearGradientAngle = 45;
gradient.LinearGradientScaled = scalingOptions[column];
if (row == 1)
{
shape.Width = 90;
shape.Height = 280;
}
}
}
presentation.Save("linear_gradient_scaling.pptx", SaveFormat.Pptx);
Il risultato in PowerPoint, con la scala disabilitata a sinistra e abilitata a destra:

Con la scala disabilitata, le bande di colore diagonali mantengono la stessa orientazione in entrambi i rettangoli. Con la scala abilitata, le bande si allungano con le proporzioni della forma. Questo aiuta a riprodurre il gradiente di un modello quando la forma viene adattata a una dimensione diversa. Su un quadrato, abilitare la scala non modifica l’aspetto di questo gradiente a 45 gradi.
Sia l’angolo sia le impostazioni di scala si applicano ai gradienti lineari. Non controllano i riempimenti GradientShape.Radial o GradientShape.Rectangle.
Combina l’angolo con la direzione del gradiente
IGradientFormat.GradientDirection seleziona uno stile di gradiente dall’enumerazione GradientDirection; non è un sostituto di un angolo numerico. Per un gradiente lineare, gli stili d’angolo possono modificare l’area su cui i colori sono distribuiti senza cambiare LinearGradientAngle. Mantieni la direzione invariata quando confronti angoli o scale.
L’esempio seguente applica le stesse impostazioni in ordine inverso. I due rettangoli hanno lo stesso aspetto: assegnare la direzione prima o dopo l’angolo non cambia il risultato.
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
for (var i = 0; i < 2; i++)
{
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 30, 30 + i * 140, 320, 100);
shape.LineFormat.FillFormat.FillType = FillType.NoFill;
shape.FillFormat.FillType = FillType.Gradient;
var gradient = shape.FillFormat.GradientFormat;
gradient.GradientShape = GradientShape.Linear;
gradient.GradientStops.Clear();
gradient.GradientStops.Add(0f, Color.Red);
gradient.GradientStops.Add(0.5f, Color.Lime);
gradient.GradientStops.Add(1f, Color.Blue);
gradient.LinearGradientScaled = NullableBool.True;
if (i == 0)
{
gradient.GradientDirection = GradientDirection.FromCorner1;
gradient.LinearGradientAngle = 30;
}
else
{
gradient.LinearGradientAngle = 30;
gradient.GradientDirection = GradientDirection.FromCorner1;
}
}
presentation.Save("linear_gradient_direction.pptx", SaveFormat.Pptx);
Riempimento pattern
Un riempimento pattern applica un disegno a due colori, ad esempio punti, strisce o quadrati. Questo esempio usa IPatternFormat.PatternStyle per selezionare un pattern a reticolo. IPatternFormat.BackColor fornisce lo sfondo grigio chiaro, e IPatternFormat.ForeColor fornisce il colore giallo del pattern.
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 150, 75);
shape.FillFormat.FillType = FillType.Pattern;
shape.FillFormat.PatternFormat.PatternStyle = PatternStyle.Trellis;
shape.FillFormat.PatternFormat.BackColor.Color = Color.LightGray;
shape.FillFormat.PatternFormat.ForeColor.Color = Color.Yellow;
presentation.Save("pattern_fill.pptx", SaveFormat.Pptx);
Il risultato:

Riempimento immagine
Un riempimento immagine utilizza un’immagine all’interno di una forma. Questo esempio richiede un’immagine locale e utilizza Images.FromFile per caricarla nella collezione di immagini della presentazione. Impostando IPictureFillFormat.PictureFillMode sulla modalità a tasselli l’immagine viene ripetuta all’interno del rettangolo. L’immagine di origine utilizzata qui è mostrata di seguito:

using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 255, 130);
shape.FillFormat.FillType = FillType.Picture;
shape.FillFormat.PictureFillFormat.PictureFillMode = PictureFillMode.Tile;
using var image = Images.FromFile("lotus.png");
var presentationImage = presentation.Images.AddImage(image);
shape.FillFormat.PictureFillFormat.Picture.Image = presentationImage;
presentation.Save("picture_fill.pptx", SaveFormat.Pptx);
Il risultato:

Tassella immagine come texture
Se desideri impostare un’immagine a tasselli come texture e personalizzare il comportamento della tassellatura, puoi usare le seguenti proprietà dell’interfaccia IPictureFillFormat e della classe PictureFillFormat:
- PictureFillMode: Imposta la modalità di riempimento immagine —
TileoStretch. - TileAlignment: Specifica l’allineamento delle tessere all’interno della forma.
- TileFlip: Controlla se la tessera è capovolta orizzontalmente, verticalmente o in entrambe le direzioni.
- TileOffsetX: Imposta lo spostamento orizzontale della tessera (in punti) dall’origine della forma.
- TileOffsetY: Imposta lo spostamento verticale della tessera (in punti) dall’origine della forma.
- TileScaleX: Definisce la scala orizzontale della tessera come percentuale.
- TileScaleY: Definisce la scala verticale della tessera come percentuale.
Questo esempio richiede un’immagine locale e la configura in IPictureFillFormat per ripeterla al 50 % della sua dimensione originale. Gli offset di −32 punti spostano le tessere orizzontalmente e verticalmente; l’allineamento in basso a destra e il capovolgimento in entrambe le direzioni determinano come la texture ripetuta è disposta.
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var firstSlide = presentation.Slides[0];
var shape = firstSlide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 190, 95);
shape.FillFormat.FillType = FillType.Picture;
using var sourceImage = Images.FromFile("lotus.png");
var presentationImage = presentation.Images.AddImage(sourceImage);
var pictureFillFormat = shape.FillFormat.PictureFillFormat;
pictureFillFormat.Picture.Image = presentationImage;
pictureFillFormat.PictureFillMode = PictureFillMode.Tile;
pictureFillFormat.TileOffsetX = -32;
pictureFillFormat.TileOffsetY = -32;
pictureFillFormat.TileScaleX = 50;
pictureFillFormat.TileScaleY = 50;
pictureFillFormat.TileAlignment = RectangleAlignment.BottomRight;
pictureFillFormat.TileFlip = TileFlip.FlipBoth;
presentation.Save("tile.pptx", SaveFormat.Pptx);
Il risultato:

Riempimento colore solido
Un riempimento solido conferisce a una forma un unico colore uniforme. Questo esempio imposta IFillFormat.FillType sul tipo di riempimento solido e assegna il giallo tramite IFillFormat.SolidFillColor, quindi salva il rettangolo nella presentazione.
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 150, 75);
shape.FillFormat.FillType = FillType.Solid;
shape.FillFormat.SolidFillColor.Color = Color.Yellow;
presentation.Save("solid_color_fill.pptx", SaveFormat.Pptx);
Il risultato:

Copia i colori mantenendo i riferimenti al tema
Usa IColorFormat.CopyFrom per copiare una definizione di colore, inclusi tipo di colore, riferimento al tema e trasformazioni. È utile quando si trasferisce il colore di riempimento tra forme che devono continuare a seguire il tema della presentazione. Il metodo copia solo il colore: non copia il tipo di riempimento, il contorno o altre formattazioni della forma. Imposta esplicitamente il IFillFormat.FillType della destinazione.
Questo esempio crea tre rettangoli, da sinistra a destra: la sorgente, una copia consapevole del tema e una copia RGB fissa. La sorgente usa IColorFormat.SchemeColor per riferirsi al primo colore di accento e aggiunge una tinta tramite IColorOperationCollection.Add. La copia RGB usa il colore di riempimento effettivo della sorgente, così tutti e tre appaiono inizialmente identici. Assegnare IColorFormat.Color imposta un valore RGB fisso e cancella eventuali trasformazioni di colore esistenti.
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation();
presentation.SlideSize.SetSize(660, 220, SlideSizeScaleType.DoNotScale);
var slide = presentation.Slides[0];
presentation.MasterTheme.ColorScheme.Accent1.Color = Color.RoyalBlue;
var source = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 30, 40, 180, 140);
var themeCopy = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 240, 40, 180, 140);
var rgbCopy = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 450, 40, 180, 140);
foreach (var shape in new[] { source, themeCopy, rgbCopy })
{
shape.FillFormat.FillType = FillType.Solid;
shape.LineFormat.FillFormat.FillType = FillType.NoFill;
}
var sourceColor = source.FillFormat.SolidFillColor;
sourceColor.SchemeColor = SchemeColor.Accent1;
sourceColor.ColorTransform.Add(ColorTransformOperation.Tint, 0.75f);
themeCopy.FillFormat.SolidFillColor.CopyFrom(sourceColor);
rgbCopy.FillFormat.SolidFillColor.Color = source.FillFormat.GetEffective().SolidFillColor;
using var before = slide.GetImage(1f, 1f);
before.Save("color-copy-before.png", ImageFormat.Png);
// Theme references follow the new accent color; the fixed RGB value does not.
presentation.MasterTheme.ColorScheme.Accent1.Color = Color.OrangeRed;
using var after = slide.GetImage(1f, 1f);
after.Save("color-copy-after.png", ImageFormat.Png);
presentation.Save("copied_colors.pptx", SaveFormat.Pptx);
Prima della modifica del tema, tutti e tre i riempimenti corrispondono:

Dopo la modifica del tema, la sorgente e la copia consapevole del tema seguono il nuovo colore di accento e mantengono la loro tinta. La copia RGB fissa rimane blu:

La definizione copiata è indipendente dalla sorgente. Modificare successivamente il riferimento al tema della sorgente, assegnare un altro colore o aggiungere o rimuovere le sue trasformazioni non cambia la destinazione. Una modifica del tema influisce comunque su entrambe le forme perché ciascuna riferisce indipendentemente allo stesso colore del tema.
Il salvataggio e la riapertura del PPTX preservano il IColorFormat.ColorType, il riferimento al tema e la raccolta IColorFormat.ColorTransform della definizione copiata; non convertono la definizione in RGB.
Quando si copia tra contesti tematici diversi, come presentazioni con palette di accento diverse, il riferimento copiato viene risolto rispetto al tema della destinazione. Lo stesso riferimento e le stesse trasformazioni possono quindi produrre un colore visibile diverso. Consulta Presentation Theme per ulteriori dettagli sulla configurazione dei colori del tema.
Usare lo sfondo della diapositiva come riempimento della forma
Usa IAutoShape.UseBackgroundFill quando una forma deve corrispondere allo sfondo della diapositiva, ad esempio in un modello di presentazione. Imposta prima IFillFormat.FillType su FillType.NotDefined per rimuovere qualsiasi riempimento esplicito. Con questa combinazione, la forma utilizza lo sfondo della diapositiva anziché il riempimento di stile. L’attivazione del flag da sola non rimuove un riempimento esplicito esistente.
Questo differisce da FillType.NoFill: lo sfondo riempito copre gli oggetti dietro la forma con l’area corrispondente dello sfondo della diapositiva, mentre nessun riempimento lascia visibili quegli oggetti. Un gradiente resta allineato alla diapositiva anziché ricominciare all’interno di ogni forma.
L’esempio seguente crea uno sfondo master ereditato dalla diapositiva e posiziona una banda magenta dietro tre rettangoli. Il rettangolo sinistro usa lo sfondo, il rettangolo centrale non ha riempimento e il rettangolo destro passa dallo sfondo riempito a un riempimento arancione esplicito.
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation();
presentation.SlideSize.SetSize(720, 400, SlideSizeScaleType.DoNotScale);
var slide = presentation.Slides[0];
// Eredita il gradiente dal master.
slide.Background.Type = BackgroundType.NotDefined;
slide.LayoutSlide.Background.Type = BackgroundType.NotDefined;
var background = slide.LayoutSlide.MasterSlide.Background;
background.Type = BackgroundType.OwnBackground;
background.FillFormat.FillType = FillType.Gradient;
var gradient = background.FillFormat.GradientFormat;
gradient.GradientShape = GradientShape.Linear;
gradient.LinearGradientAngle = 0;
gradient.GradientStops.Clear();
gradient.GradientStops.Add(0, Color.DarkBlue);
gradient.GradientStops.Add(1, Color.LightSkyBlue);
// Aggiungi questo oggetto per primo così appare dietro i rettangoli.
var band = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 25, 150, 670, 100);
band.FillFormat.FillType = FillType.Solid;
band.FillFormat.SolidFillColor.Color = Color.Magenta;
band.LineFormat.FillFormat.FillType = FillType.NoFill;
var backgroundShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 100, 160, 200);
backgroundShape.FillFormat.FillType = FillType.NotDefined;
backgroundShape.UseBackgroundFill = true;
var noFillShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 280, 100, 160, 200);
noFillShape.FillFormat.FillType = FillType.NoFill;
var explicitShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 510, 100, 160, 200);
explicitShape.FillFormat.FillType = FillType.NotDefined;
explicitShape.UseBackgroundFill = true;
// Disattiva il riempimento di sfondo prima di applicare un riempimento esplicito.
explicitShape.UseBackgroundFill = false;
explicitShape.FillFormat.FillType = FillType.Solid;
explicitShape.FillFormat.SolidFillColor.Color = Color.Orange;
presentation.Save("background_fill.pptx", SaveFormat.Pptx);
Il risultato, da sinistra a destra: riempimento di sfondo, nessun riempimento e riempimento esplicito. La banda magenta è nascosta dai rettangoli sinistro e destro ma rimane visibile attraverso il rettangolo centrale.

Lo stesso comportamento si applica a uno sfondo definito direttamente sulla diapositiva o ereditato da un layout. La forma utilizza lo sfondo risolto della diapositiva; l’esempio lascia sia lo sfondo della diapositiva sia quello del layout non definiti così il master fornisce lo sfondo.
Impostare la trasparenza
Per un riempimento solido, il componente alfa del colore controlla l’opacità: 0 è completamente trasparente e 255 è completamente opaco. Questo esempio usa un valore alfa di 128 per un rettangolo giallo, rendendolo circa 50 % trasparente così il rettangolo sottostante rimane visibile. Il colore è assegnato tramite IFillFormat.SolidFillColor.
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;
const int alpha = 128;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var solidShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 150, 75);
var transparentShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 80, 80, 150, 75);
transparentShape.FillFormat.FillType = FillType.Solid;
transparentShape.FillFormat.SolidFillColor.Color = Color.FromArgb(alpha, Color.Yellow);
presentation.Save("shape_transparency.pptx", SaveFormat.Pptx);
Il risultato:

Ruotare le forme
Usa IShape.Rotation per ruotare una forma nel piano della diapositiva. L’angolo è misurato in gradi; questo esempio ruota un rettangolo di 5 gradi in senso orario e salva la presentazione.
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 150, 75);
shape.Rotation = 5;
presentation.Save("shape_rotation.pptx", SaveFormat.Pptx);
Il risultato:

Aggiungere effetti di smusso 3D
Usa IShape.ThreeDFormat per dare profondità a una forma e bordi smussati. Questo esempio crea un’ellisse verde con contorno arancione, imposta IThreeDFormat.Depth a 4 punti e applica uno smusso superiore circolare con larghezza e altezza di 6 punti tramite IThreeDFormat.BevelTop. Una telecamera ortografica frontale e un’illuminazione a tre punti rendono visibile lo smusso.
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var shape = slide.Shapes.AddAutoShape(ShapeType.Ellipse, 50, 50, 100, 100);
shape.FillFormat.FillType = FillType.Solid;
shape.FillFormat.SolidFillColor.Color = Color.Green;
shape.LineFormat.FillFormat.FillType = FillType.Solid;
shape.LineFormat.FillFormat.SolidFillColor.Color = Color.Orange;
shape.LineFormat.Width = 2.0;
shape.ThreeDFormat.Depth = 4;
shape.ThreeDFormat.BevelTop.BevelType = BevelPresetType.Circle;
shape.ThreeDFormat.BevelTop.Height = 6;
shape.ThreeDFormat.BevelTop.Width = 6;
shape.ThreeDFormat.Camera.CameraType = CameraPresetType.OrthographicFront;
shape.ThreeDFormat.LightRig.LightType = LightRigPresetType.ThreePt;
shape.ThreeDFormat.LightRig.Direction = LightingDirection.Top;
presentation.Save("3D_bevel_effect.pptx", SaveFormat.Pptx);
Il risultato:

Aggiungere effetti di rotazione 3D
La vista 3D di una forma è controllata dalle impostazioni della telecamera. Questo esempio usa ICamera.SetRotation con angoli di latitudine, longitudine e rivoluzione di 40, 35 e 20 gradi, rispettivamente. Seleziona una telecamera isometrica tramite ICamera.CameraType e un’illuminazione bilanciata tramite ILightRig.LightType, quindi salva il rettangolo formattato.
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var autoShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 150, 75);
autoShape.TextFrame.Text = "Hello, Aspose!";
autoShape.ThreeDFormat.Camera.CameraType = CameraPresetType.IsometricLeftUp;
autoShape.ThreeDFormat.Camera.SetRotation(40, 35, 20);
autoShape.ThreeDFormat.LightRig.LightType = LightRigPresetType.Balanced;
presentation.Save("3D_rotation_effect.pptx", SaveFormat.Pptx);
Il risultato:

Controllare la resa in bianco e nero per le forme
La proprietà IShape.BlackWhiteMode specifica come una singola forma viene resa quando una presentazione è visualizzata o elaborata in modalità bianco e nero. Non abilita la visualizzazione in bianco e nero da sola e non cambia il riempimento, il contorno o altre formattazioni della forma in modalità colore normale.
Usa un valore dell’enumerazione BlackWhiteMode per selezionare il comportamento desiderato. Ad esempio, Automatic lascia all’applicazione di rendering scegliere la conversione, Gray e LightGray usano la colorazione grigia, BlackWhite usa solo nero e bianco, Black e White forzano un colore unico, Color conserva la colorazione normale, e Hidden omette la forma in modalità bianco e nero. NotDefined significa che non è stato assegnato alcun livello di forma.
Questo esempio crea un rettangolo arancione e imposta IShape.BlackWhiteMode su grigio. La forma salvata mantiene il riempimento arancione per la visualizzazione a colori normali e richiede la colorazione grigia dalle applicazioni che rispettano le impostazioni di visualizzazione in bianco e nero:
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 200, 100);
shape.FillFormat.FillType = FillType.Solid;
shape.FillFormat.SolidFillColor.Color = Color.Orange;
shape.BlackWhiteMode = BlackWhiteMode.Gray;
presentation.Save("shape_black_white_mode.pptx", SaveFormat.Pptx);
In modalità colore normale, il rettangolo mantiene il riempimento arancione. In un flusso di lavoro di visualizzazione in bianco e nero, utilizza la colorazione grigia perché il suo modo è impostato su Gray. Questo consente di preservare una diapositiva a colori completi definendo al contempo un aspetto distinto per la stampa, l’anteprima o altri flussi di lavoro che rispettano le impostazioni di visualizzazione in bianco e nero della presentazione.
Ripristinare la formattazione
Usa ISlide.Reset per ripristinare posizione, dimensione e formattazione dei segnaposto della diapositiva dai corrispondenti segnaposto del layout. Questo esempio richiede una presentazione esistente con segnaposto collegati al layout e ripristina ogni diapositiva prima del salvataggio. Le forme senza segnaposto corrispondente nel layout non vengono ripristinate.
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation("sample.pptx");
foreach (var slide in presentation.Slides)
{
slide.Reset();
}
presentation.Save("reset_formatting.pptx", SaveFormat.Pptx);
FAQ
La formattazione delle forme influisce sulla dimensione finale del file della presentazione?
I colori, gli stili di linea e le impostazioni degli effetti aggiungono generalmente pochi dati rispetto a immagini e media incorporati. I riempimenti immagine possono aumentare la dimensione del file perché le loro immagini sono memorizzate nella presentazione.
Come posso individuare forme su una diapositiva che condividono la stessa formattazione per raggrupparle?
Confronta le proprietà chiave di formattazione di ciascuna forma — riempimento, linea e impostazioni degli effetti. Se tutti i valori corrispondono, tratta i loro stili come identici e raggruppa logicamente quelle forme, semplificando la gestione successiva degli stili.
Posso salvare un insieme di stili di forma personalizzati in un file separato per riutilizzarli in altre presentazioni?
Sì. Memorizza forme di esempio con gli stili desiderati in una presentazione modello o in un file modello .POTX. Quando crei una nuova presentazione, apri il modello, clona le forme con lo stile necessario e riapplica la loro formattazione dove richiesto.