Formattare le forme PowerPoint in .NET

Introduzione

In PowerPoint, è possibile aggiungere forme alle diapositive. Poiché le forme sono composte da linee, è possibile formattarle modificando o applicando effetti ai loro contorni. Inoltre, è possibile formattare le forme specificando le impostazioni che controllano come vengono riempiti i loro interni.

formattazione della forma PowerPoint

Aspose.Slides per .NET fornisce interfacce e proprietà che consentono di formattare le forme utilizzando le stesse opzioni disponibili in PowerPoint.

Formattare le linee

Utilizzando Aspose.Slides, è possibile specificare uno stile di linea personalizzato per una forma. I passaggi seguenti descrivono la procedura:

  1. Crea un’istanza della classe Presentation.
  2. Ottieni un riferimento a una diapositiva tramite il suo indice.
  3. Aggiungi un IAutoShape alla diapositiva.
  4. Imposta lo stile di linea della forma.
  5. Imposta la larghezza della linea.
  6. Imposta lo stile tratteggiato della linea.
  7. Imposta il colore della linea per la forma.
  8. Salva la presentazione modificata come file PPTX.

Il seguente codice C# dimostra come formattare un AutoShape rettangolare:

// Istanzia la classe Presentation che rappresenta un file di presentazione.
using (Presentation presentation = new Presentation())
{
    // Ottieni la prima diapositiva.
    ISlide slide = presentation.Slides[0];

    // Aggiungi una forma automatica di tipo Rettangolo.
    IAutoShape shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 150, 75);

    // Imposta il colore di riempimento per la forma rettangolare.
    shape.FillFormat.FillType = FillType.NoFill;

    // Applica la formattazione alle linee del rettangolo.
    shape.LineFormat.Style = LineStyle.ThickThin;
    shape.LineFormat.Width = 7;
    shape.LineFormat.DashStyle = LineDashStyle.Dash;

    // Imposta il colore per la linea del rettangolo.
    shape.LineFormat.FillFormat.FillType = FillType.Solid;
    shape.LineFormat.FillFormat.SolidFillColor.Color = Color.Blue;

    // Salva il file PPTX su disco.
    presentation.Save("formatted_lines.pptx", SaveFormat.Pptx);
}

Il risultato:

Le linee formattate nella presentazione

Formattare gli stili di giunzione

Ecco le tre opzioni di tipo di giunzione:

  • Round
  • Miter
  • Bevel

Per impostazione predefinita, quando PowerPoint unisce due linee ad un angolo (ad esempio nell’angolo di una forma), utilizza l’impostazione Round. Tuttavia, se stai disegnando una forma con angoli acuti, potresti preferire l’opzione Miter.

Stile di giunzione nella presentazione

Il seguente codice C# dimostra come sono stati creati tre rettangoli (come mostrato nell’immagine sopra) utilizzando le impostazioni di tipo di giunzione Miter, Bevel e Round:

// Istanzia la classe Presentation che rappresenta un file di presentazione.
using (Presentation presentation = new Presentation())
{
    // Ottieni la prima diapositiva.
    // Aggiungi tre forme automatiche di tipo Rettangolo.
    IAutoShape shape1 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 20, 20, 150, 75);
    IAutoShape shape2 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 210, 20, 150, 75);
    IAutoShape shape3 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 20, 135, 150, 75);

    // Imposta il colore di riempimento per ciascuna forma rettangolare.
    shape1.FillFormat.FillType = FillType.Solid;
    shape1.FillFormat.SolidFillColor.Color = Color.Black;
    shape2.FillFormat.FillType = FillType.Solid;
    shape2.FillFormat.SolidFillColor.Color = Color.Black;
    shape3.FillFormat.FillType = FillType.Solid;
    shape3.FillFormat.SolidFillColor.Color = Color.Black;

    // Imposta la larghezza della linea.
    shape1.LineFormat.Width = 15;
    shape2.LineFormat.Width = 15;
    shape3.LineFormat.Width = 15;

    // Imposta il colore per la linea di ciascun rettangolo.
    shape1.LineFormat.FillFormat.FillType = FillType.Solid;
    shape1.LineFormat.FillFormat.SolidFillColor.Color = Color.Blue;
    shape2.LineFormat.FillFormat.FillType = FillType.Solid;
    shape2.LineFormat.FillFormat.SolidFillColor.Color = Color.Blue;
    shape3.LineFormat.FillFormat.FillType = FillType.Solid;
    shape3.LineFormat.FillFormat.SolidFillColor.Color = Color.Blue;

    // Imposta lo stile di giunzione.
    shape1.LineFormat.JoinStyle = LineJoinStyle.Miter;
    shape2.LineFormat.JoinStyle = LineJoinStyle.Bevel;
    shape3.LineFormat.JoinStyle = LineJoinStyle.Round;

    // Aggiungi testo a ciascun rettangolo.
    shape1.TextFrame.Text = "Miter Join Style";
    shape2.TextFrame.Text = "Bevel Join Style";
    shape3.TextFrame.Text = "Round Join Style";

    // Salva il file PPTX su disco.
    presentation.Save("join_styles.pptx", SaveFormat.Pptx);
}

Riempimento a gradiente

In PowerPoint, il Riempimento a gradiente è un’opzione di formattazione che consente di applicare una fusione continua di colori a una forma. Ad esempio, è possibile applicare due o più colori in modo che uno sfumi gradualmente nell’altro.

Ecco come applicare un riempimento a gradiente a una forma utilizzando Aspose.Slides:

  1. Crea un’istanza della classe Presentation.
  2. Ottieni un riferimento a una diapositiva tramite il suo indice.
  3. Aggiungi un IAutoShape alla diapositiva.
  4. Imposta il FillType della forma su Gradient.
  5. Aggiungi i due colori preferiti con posizioni definite utilizzando i metodi Add della collezione di gradient stop esposta dall’interfaccia IGradientFormat.
  6. Salva la presentazione modificata come file PPTX.
// Istanzia la classe Presentation che rappresenta un file di presentazione.
using (Presentation presentation = new Presentation())
{
    // Ottieni la prima diapositiva.
    ISlide slide = presentation.Slides[0];

    // Aggiungi una forma automatica di tipo Ellipse.
    IAutoShape shape = slide.Shapes.AddAutoShape(ShapeType.Ellipse, 50, 50, 150, 75);

    // Applica la formattazione gradiente all'ellisse.
    shape.FillFormat.FillType = FillType.Gradient;
    shape.FillFormat.GradientFormat.GradientShape = GradientShape.Linear;

    // Imposta la direzione del gradiente.
    shape.FillFormat.GradientFormat.GradientDirection = GradientDirection.FromCorner2;

    // Aggiungi due fermate del gradiente.
    shape.FillFormat.GradientFormat.GradientStops.Add(1.0f, PresetColor.Purple);
    shape.FillFormat.GradientFormat.GradientStops.Add(0.0f, PresetColor.Red);

    // Salva il file PPTX su disco.
    presentation.Save("gradient_fill.pptx", SaveFormat.Pptx);
}

Il risultato:

L’ellisse con riempimento a gradiente

Riempimento a motivo

In PowerPoint, il Riempimento a motivo è un’opzione di formattazione che consente di applicare un design a due colori — come punti, righe, tratteggi incrociati o quadretti — a una forma. È possibile scegliere colori personalizzati per il primo piano e lo sfondo del motivo.

Aspose.Slides offre più di 45 stili di motivo predefiniti che è possibile applicare alle forme per migliorare l’aspetto visivo delle presentazioni. Anche dopo aver selezionato un motivo predefinito, è ancora possibile specificare i colori esatti da utilizzare.

Ecco come applicare un riempimento a motivo a una forma utilizzando Aspose.Slides:

  1. Crea un’istanza della classe Presentation.
  2. Ottieni un riferimento a una diapositiva tramite il suo indice.
  3. Aggiungi un IAutoShape alla diapositiva.
  4. Imposta il FillType della forma su Pattern.
  5. Scegli uno stile di motivo tra le opzioni predefinite.
  6. Imposta il Background Color del motivo.
  7. Imposta il Foreground Color del motivo.
  8. Salva la presentazione modificata come file PPTX.
// Istanzia la classe Presentation che rappresenta un file di presentazione.
using (Presentation presentation = new Presentation())
{
    // Ottieni la prima diapositiva.
    ISlide slide = presentation.Slides[0];

    // Aggiungi una forma automatica di tipo Rectangle.
    IAutoShape shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 150, 75);

    // Imposta il tipo di riempimento su Pattern.
    shape.FillFormat.FillType = FillType.Pattern;

    // Imposta lo stile del motivo.
    shape.FillFormat.PatternFormat.PatternStyle = PatternStyle.Trellis;

    // Imposta i colori di sfondo e primo piano del motivo.
    shape.FillFormat.PatternFormat.BackColor.Color = Color.LightGray;
    shape.FillFormat.PatternFormat.ForeColor.Color = Color.Yellow;

    // Salva il file PPTX su disco.
    presentation.Save("pattern_fill.pptx", SaveFormat.Pptx);
}

Il risultato:

Il rettangolo con riempimento a motivo

Riempimento immagine

In PowerPoint, il Riempimento immagine è un’opzione di formattazione che consente di inserire un’immagine all’interno di una forma — utilizzando effettivamente l’immagine come sfondo della forma.

Ecco come utilizzare Aspose.Slides per applicare un riempimento immagine a una forma:

  1. Crea un’istanza della classe Presentation.
  2. Ottieni un riferimento a una diapositiva tramite il suo indice.
  3. Aggiungi un IAutoShape alla diapositiva.
  4. Imposta il FillType della forma su Picture.
  5. Imposta la modalità di riempimento immagine su Tile (o un’altra modalità preferita).
  6. Crea un oggetto IPPImage dall’immagine che desideri utilizzare.
  7. Assegna questa immagine alla proprietà Picture.Image del PictureFillFormat della forma.
  8. Salva la presentazione modificata come file PPTX.

Supponiamo di avere un file “lotus.png” con l’immagine seguente:

L’immagine del lotus

// Istanzia la classe Presentation che rappresenta un file di presentazione.
using (Presentation presentation = new Presentation())
{
    // Ottieni la prima diapositiva.
    ISlide slide = presentation.Slides[0];

    // Aggiungi una forma automatica di tipo Rectangle.
    IAutoShape shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 255, 130);

    // Imposta il tipo di riempimento su Picture.
    shape.FillFormat.FillType = FillType.Picture;

    // Imposta la modalità di riempimento immagine.
    shape.FillFormat.PictureFillFormat.PictureFillMode = PictureFillMode.Tile;

    // Carica un'immagine e aggiungila alle risorse della presentazione.
    IImage image = Images.FromFile("lotus.png");
    IPPImage presentationImage = presentation.Images.AddImage(image);
    image.Dispose();

    // Imposta l'immagine.
    shape.FillFormat.PictureFillFormat.Picture.Image = presentationImage;

    // Salva il file PPTX su disco.
    presentation.Save("picture_fill.pptx", SaveFormat.Pptx);
}

Il risultato:

La forma con riempimento immagine

Immagine a tasselli come trama

Se vuoi impostare un’immagine a tasselli come trama e personalizzare il comportamento del tassellamento, puoi utilizzare le seguenti proprietà dell’interfaccia IPictureFillFormat e della classe PictureFillFormat:

  • PictureFillMode: Imposta la modalità di riempimento immagine — Tile o Stretch.
  • TileAlignment: Specifica l’allineamento dei tasselli all’interno della forma.
  • TileFlip: Controlla se il tassello è capovolto orizzontalmente, verticalmente o entrambi.
  • TileOffsetX: Imposta lo spostamento orizzontale del tassello (in punti) dall’origine della forma.
  • TileOffsetY: Imposta lo spostamento verticale del tassello (in punti) dall’origine della forma.
  • TileScaleX: Definisce la scala orizzontale del tassello come percentuale.
  • TileScaleY: Definisce la scala verticale del tassello come percentuale.

Il seguente esempio di codice mostra come aggiungere una forma rettangolare con riempimento immagine a tasselli e configurare le opzioni del tassello:

// Istanzia la classe Presentation che rappresenta un file di presentazione.
using (Presentation presentation = new Presentation())
{
    // Ottieni la prima diapositiva.
    ISlide firstSlide = presentation.Slides[0];

    // Aggiungi una forma automatica rettangolare.
    IAutoShape shape = firstSlide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 190, 95);

    // Imposta il tipo di riempimento della forma su Picture.
    shape.FillFormat.FillType = FillType.Picture;

    // Carica l'immagine e aggiungila alle risorse della presentazione.
    IPPImage presentationImage;
    using (IImage sourceImage = Images.FromFile("lotus.png"))
        presentationImage = presentation.Images.AddImage(sourceImage);

    // Assegna l'immagine alla forma.
    IPictureFillFormat pictureFillFormat = shape.FillFormat.PictureFillFormat;
    pictureFillFormat.Picture.Image = presentationImage;

    // Configura la modalità di riempimento immagine e le proprietà di tassellamento.
    pictureFillFormat.PictureFillMode = PictureFillMode.Tile;
    pictureFillFormat.TileOffsetX = -32;
    pictureFillFormat.TileOffsetY = -32;
    pictureFillFormat.TileScaleX = 50;
    pictureFillFormat.TileScaleY = 50;
    pictureFillFormat.TileAlignment = RectangleAlignment.BottomRight;
    pictureFillFormat.TileFlip = TileFlip.FlipBoth;

    // Salva il file PPTX su disco.
    presentation.Save("tile.pptx", SaveFormat.Pptx);
}

Il risultato:

Le opzioni di tassello

Riempimento a colore solido

In PowerPoint, il Riempimento a colore solido è un’opzione di formattazione che riempie una forma con un unico colore uniforme. Questo colore di sfondo semplice viene applicato senza gradienti, trame o motivi.

Per applicare un riempimento a colore solido a una forma utilizzando Aspose.Slides, segui questi passaggi:

  1. Crea un’istanza della classe Presentation.
  2. Ottieni un riferimento a una diapositiva tramite il suo indice.
  3. Aggiungi un IAutoShape alla diapositiva.
  4. Imposta il FillType della forma su Solid.
  5. Assegna il colore di riempimento preferito alla forma.
  6. Salva la presentazione modificata come file PPTX.
// Istanzia la classe Presentation che rappresenta un file di presentazione.
using (Presentation presentation = new Presentation())
{
    // Ottieni la prima diapositiva.
    ISlide slide = presentation.Slides[0];

    // Aggiungi una forma automatica di tipo Rectangle.
    IAutoShape shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 150, 75);

    // Imposta il tipo di riempimento su Solid.
    shape.FillFormat.FillType = FillType.Solid;

    // Imposta il colore di riempimento.
    shape.FillFormat.SolidFillColor.Color = Color.Yellow;

    // Salva il file PPTX su disco.
    presentation.Save("solid_color_fill.pptx", SaveFormat.Pptx);
}

Il risultato:

La forma con riempimento a colore solido

Impostare la trasparenza

In PowerPoint, quando applichi un riempimento di colore solido, a gradiente, immagine o trama a delle forme, puoi anche impostare un livello di trasparenza per controllare l’opacità del riempimento. Un valore di trasparenza più elevato rende la forma più trasparente, consentendo allo sfondo o agli oggetti sottostanti di essere parzialmente visibili.

Aspose.Slides consente di impostare il livello di trasparenza regolando il valore alfa nel colore usato per il riempimento. Ecco come fare:

  1. Crea un’istanza della classe Presentation.
  2. Ottieni un riferimento a una diapositiva tramite il suo indice.
  3. Aggiungi un IAutoShape alla diapositiva.
  4. Imposta il FillType su Solid.
  5. Usa Color.FromArgb(alpha, baseColor) per definire un colore con trasparenza (il componente alpha controlla la trasparenza).
  6. Salva la presentazione.
const int alpha = 128;

// Istanzia la classe Presentation che rappresenta un file di presentazione.
using (Presentation presentation = new Presentation())
{
    // Ottieni la prima diapositiva.
    ISlide slide = presentation.Slides[0];

    // Aggiungi una forma automatica rettangolare solida.
    IAutoShape solidShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 150, 75);

    // Aggiungi una forma automatica rettangolare trasparente sopra la forma solida.
    IAutoShape transparentShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 80, 80, 150, 75);
    transparentShape.FillFormat.FillType = FillType.Solid;
    transparentShape.FillFormat.SolidFillColor.Color = Color.FromArgb(alpha, Color.Yellow);

    // Salva il file PPTX su disco.
    presentation.Save("shape_transparency.pptx", SaveFormat.Pptx);
}

Il risultato:

La forma trasparente

Ruotare le forme

Aspose.Slides consente di ruotare le forme nelle presentazioni PowerPoint. Questo può essere utile quando si posizionano elementi visivi con esigenze specifiche di allineamento o design.

Per ruotare una forma su una diapositiva, segui questi passaggi:

  1. Crea un’istanza della classe Presentation.
  2. Ottieni un riferimento a una diapositiva tramite il suo indice.
  3. Aggiungi un IAutoShape alla diapositiva.
  4. Imposta la proprietà Rotation della forma sull’angolo desiderato.
  5. Salva la presentazione.
// Istanzia la classe Presentation che rappresenta un file di presentazione.
using (Presentation presentation = new Presentation())
{
    // Ottieni la prima diapositiva.
    ISlide slide = presentation.Slides[0];

    // Aggiungi una forma automatica di tipo Rectangle.
    IAutoShape shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 150, 75);

    // Ruota la forma di 5 gradi.
    shape.Rotation = 5;

    // Salva il file PPTX su disco.
    presentation.Save("shape_rotation.pptx", SaveFormat.Pptx);
}

Il risultato:

La rotazione della forma

Aggiungere effetti di smusso 3D

Aspose.Slides consente di applicare effetti di smusso 3D alle forme configurando le loro proprietà ThreeDFormat.

Per aggiungere effetti di smusso 3D a una forma, segui questi passaggi:

  1. Istanzia la classe Presentation.
  2. Ottieni un riferimento a una diapositiva tramite il suo indice.
  3. Aggiungi un IAutoShape alla diapositiva.
  4. Configura il ThreeDFormat della forma per definire le impostazioni di smusso.
  5. Salva la presentazione.
// Crea un'istanza della classe Presentation.
using (Presentation presentation = new Presentation())
{
    ISlide slide = presentation.Slides[0];

    // Aggiungi una forma alla diapositiva.
    IAutoShape 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;

    // Imposta le proprietà ThreeDFormat della forma.
    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;

    // Salva la presentazione come file PPTX.
    presentation.Save("3D_bevel_effect.pptx", SaveFormat.Pptx);
}

Il risultato:

L’effetto di smusso 3D

Aggiungere effetti di rotazione 3D

Aspose.Slides consente di applicare effetti di rotazione 3D alle forme configurando le loro proprietà ThreeDFormat.

Per applicare una rotazione 3D a una forma:

  1. Crea un’istanza della classe Presentation.
  2. Ottieni un riferimento a una diapositiva tramite il suo indice.
  3. Aggiungi un IAutoShape alla diapositiva.
  4. Imposta il CameraType e il LightType della forma per definire la rotazione 3D.
  5. Salva la presentazione.
// Crea un'istanza della classe Presentation.
using (Presentation presentation = new Presentation())
{
    ISlide slide = presentation.Slides[0];

    IAutoShape autoShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 150, 75);
    autoShape.TextFrame.Text = "Hello, Aspose!";

    autoShape.ThreeDFormat.Depth = 6;
    autoShape.ThreeDFormat.Camera.SetRotation(40, 35, 20);
    autoShape.ThreeDFormat.Camera.CameraType = CameraPresetType.IsometricLeftUp;
    autoShape.ThreeDFormat.LightRig.LightType = LightRigPresetType.Balanced;

    // Salva la presentazione come file PPTX.
    presentation.Save("3D_rotation_effect.pptx", SaveFormat.Pptx);
}

Il risultato:

L’effetto di rotazione 3D

Ripristinare la formattazione

Il seguente codice C# mostra come ripristinare la formattazione di una diapositiva e riportare la posizione, le dimensioni e la formattazione di tutte le forme con segnaposto sul LayoutSlide alle impostazioni predefinite:

using (Presentation presentation = new Presentation("sample.pptx"))
{
    foreach (ISlide slide in presentation.Slides)
    {
        // Ripristina ogni forma sulla diapositiva che ha un segnaposto nel layout.
        slide.Reset();
    }

    presentation.Save("reset_formatting.pptx", SaveFormat.Pptx);
}

FAQ

La formattazione delle forme influisce sulla dimensione finale del file della presentazione?

Solo in minima parte. Le immagini e i media incorporati occupano la maggior parte dello spazio del file, mentre i parametri delle forme come colori, effetti e gradienti sono memorizzati come metadati e aggiungono praticamente nessuna dimensione extra.

Come posso rilevare le forme su una diapositiva che condividono la stessa formattazione per poterle raggruppare?

Confronta le proprietà chiave di formattazione di ciascuna forma — impostazioni di riempimento, linea ed effetto. Se tutti i valori corrispondenti coincidono, considera i loro stili identici e raggruppa logicamente tali 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ì. Salva le forme di esempio con gli stili desiderati in un set di diapositive modello o in un file modello .POTX. Quando crei una nuova presentazione, apri il modello, clona le forme formattate di cui hai bisogno e riapplica la loro formattazione dove necessario.