Formattare le forme PowerPoint su Android

Introduzione

Formato delle forme in PowerPoint regolando i loro contorni, riempimenti ed effetti. Aspose.Slides per Android tramite Java consente di controllare queste impostazioni programmaticamente, inclusi trasparenza, rotazione e formattazione 3D.

Opzioni di formattazione delle forme in PowerPoint

Aspose.Slides per Android tramite Java fornisce interfacce e metodi che consentono di formattare le forme utilizzando le stesse opzioni disponibili in PowerPoint.

Formattare le linee

Utilizza IShape.getLineFormat per controllare il contorno di una forma. Questo esempio crea un rettangolo non riempito con un contorno blu tratteggiato. ILineFormat.setStyle seleziona una linea composta spessa‑sottile, mentre ILineFormat.setWidth imposta la sua larghezza a 7 punti e ILineFormat.setDashStyle seleziona il modello di tratteggio.

import com.aspose.slides.*;
import android.graphics.Color;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75);
    shape.getFillFormat().setFillType(FillType.NoFill);
    shape.getLineFormat().setStyle(LineStyle.ThickThin);
    shape.getLineFormat().setWidth(7);
    shape.getLineFormat().setDashStyle(LineDashStyle.Dash);
    shape.getLineFormat().getFillFormat().setFillType(FillType.Solid);
    shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE);

    presentation.save("formatted_lines.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Il risultato:

Le linee formattate nella presentazione

Imposta modelli di tratteggio personalizzati per le linee

Utilizza ILineFormat.setCustomDashPattern quando gli stili di linea predefiniti non forniscono le lunghezze dei tratti e gli spazi di cui hai bisogno, ad esempio per contorni aziendali o diagrammi tecnici. L’assegnazione di un modello cambia automaticamente lo stile di tratteggio della linea in LineDashStyle.Custom.

Le voci dell’array alternano lunghezze di tratto e di spazio, a partire da un tratto. Ogni valore è un multiplo della larghezza della linea: { 4, 2 } a una larghezza di 3 punti produce un tratto di 12 punti seguito da uno spazio di 6 punti. Usa coppie di valori finiti e non negativi per definire segmenti completi di tratto‑spazio. L’esempio utilizza valori positivi per mantenere visibili tutti i tratti e gli spazi.

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 degli spazi. La quinta passa da un modello personalizzato a una linea piena.

import com.aspose.slides.*;
import android.graphics.Color;

Presentation presentation = new Presentation();
try {
    presentation.getSlideSize().setSize(600, 300, SlideSizeScaleType.DoNotScale);
    ISlide slide = presentation.getSlides().get_Item(0);

    float[][] patterns = {
        { 4, 2 },
        { 1, 2 },
        { 6, 2, 1, 2 },
        { 4, 2 },
        { 4, 2 }
    };

    for (int i = 0; i < patterns.length; i++) {
        IAutoShape line = slide.getShapes().addAutoShape(ShapeType.Line, 50, 50 + i * 50, 500, 0);
        line.getLineFormat().setWidth(i == 3 ? 6 : 3);
        line.getLineFormat().getFillFormat().setFillType(FillType.Solid);
        line.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.rgb(0, 0, 139));
        line.getLineFormat().setCapStyle(LineCapStyle.Flat);
        line.getLineFormat().setBeginArrowheadStyle(LineArrowheadStyle.None);
        line.getLineFormat().setEndArrowheadStyle(LineArrowheadStyle.None);
        line.getLineFormat().setCustomDashPattern(patterns[i]);
    }

    // Imposta l'ultima linea su uno stile solido.
    slide.getShapes().get_Item(4).getLineFormat().setDashStyle(LineDashStyle.Solid);

    presentation.save("custom_dash_patterns.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Per tornare a uno stile tratteggiato predefinito, passa LineDashStyle.Dash a ILineFormat.setDashStyle. 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.

Tre modelli di tratto personalizzati, una linea più larga che usa il primo modello e una linea piena in PowerPoint

Imposta le estremità delle linee

Utilizza ILineFormat.setCapStyle per impostare le estremità di una linea aperta. La classe LineCapStyle fornisce tre stili di estremità espliciti:

  • Flat: Il tratto si ferma al punto finale.
  • Round: Un cappuccio semicircolare si estende oltre il punto finale per metà larghezza della linea.
  • Square: Un cappuccio quadrato si estende oltre il punto finale per metà larghezza della linea.

La classe include anche NotDefined, che indica che non è stato assegnato esplicitamente alcun stile di estremità.

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 di linea. Questo esempio disabilita le punte delle frecce tramite ILineFormat.setBeginArrowheadStyle e ILineFormat.setEndArrowheadStyle 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 per 10 punti oltre ciascuna estremità.

import com.aspose.slides.*;
import android.graphics.Color;

Presentation presentation = new Presentation();
try {
    presentation.getSlideSize().setSize(500, 240, SlideSizeScaleType.DoNotScale);
    ISlide slide = presentation.getSlides().get_Item(0);

    byte[] capStyles = new byte[] { LineCapStyle.Flat, LineCapStyle.Round, LineCapStyle.Square };

    for (int i = 0; i < capStyles.length; i++) {
        IAutoShape line = slide.getShapes().addAutoShape(ShapeType.Line, 100, 50 + i * 70, 300, 0);
        line.getLineFormat().setWidth(20);
        line.getLineFormat().getFillFormat().setFillType(FillType.Solid);
        line.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.rgb(0, 0, 139));
        line.getLineFormat().setDashStyle(LineDashStyle.Solid);
        line.getLineFormat().setCapStyle(capStyles[i]);
        line.getLineFormat().setBeginArrowheadStyle(LineArrowheadStyle.None);
        line.getLineFormat().setEndArrowheadStyle(LineArrowheadStyle.None);
    }

    presentation.save("line_caps.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Il risultato in PowerPoint, dall’alto verso il basso: Flat, Round, e Square.

Cap estremità piatte, arrotondate e quadrate su linee spesse identiche in PowerPoint

Applicare effetti di schizzo alle linee della forma

Un effetto di schizzo rende la linea di una forma simile a un disegno a mano libera. Utilizza IShape.getLineFormat per accedere alle impostazioni della linea, ILineFormat.getSketchFormat per accedere alle impostazioni dello schizzo e ISketchFormat.setSketchType per selezionare un valore dalla classe LineSketchType.

Il codice Java seguente mostra come applicare un effetto LineSketchType.Curved, leggere il valore assegnato esplicitamente e rimuovere l’effetto con LineSketchType.None:

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 200, 100);

    ISketchFormat sketchFormat = shape.getLineFormat().getSketchFormat();
    sketchFormat.setSketchType(LineSketchType.Curved);
    int explicitSketchType = sketchFormat.getSketchType();
    System.out.println("Explicit sketch type: " + explicitSketchType);
    sketchFormat.setSketchType(LineSketchType.None);
} finally {
    presentation.dispose();
}

Il valore restituito da ISketchFormat.getSketchType rappresenta l’impostazione assegnata direttamente alla forma. Se la formattazione della linea può essere ereditata da un tema, da una diapositiva master o da una diapositiva layout, utilizza ILineFormat.getEffective, accedi a ILineFormatEffectiveData.getSketchFormat e leggi ISketchFormatEffectiveData.getSketchType. Il valore effettivo riflette la formattazione realmente applicata dopo la risoluzione dell’eredità. Questo esempio richiede una presentazione esistente con almeno una forma nella prima diapositiva e stampa entrambi i valori:

import com.aspose.slides.*;

Presentation presentation = new Presentation("presentation.pptx");
try {
    IShape shape = presentation.getSlides().get_Item(0).getShapes().get_Item(0);

    ILineFormat lineFormat = shape.getLineFormat();
    int explicitSketchType = lineFormat.getSketchFormat().getSketchType();
    ILineFormatEffectiveData effectiveLineFormat = lineFormat.getEffective();
    int effectiveSketchType = effectiveLineFormat.getSketchFormat().getSketchType();

    System.out.println("Explicit sketch type: " + explicitSketchType);
    System.out.println("Effective sketch type: " + effectiveSketchType);
} finally {
    presentation.dispose();
}

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 in un angolo. Usa Round per angoli arrotondati, Miter per angoli acuti o Bevel per angoli appiattiti.

Lo stile di giunzione nella presentazione

Questo esempio crea tre rettangoli neri con contorni blu larghi 15 punti. Utilizza ILineFormat.setJoinStyle per applicare rispettivamente i valori miter, bevel e round della classe LineJoinStyle, per confrontare come vengono disegnati gli angoli.

import com.aspose.slides.*;
import android.graphics.Color;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape miterShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 20, 150, 75);
    IAutoShape bevelShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 210, 20, 150, 75);
    IAutoShape roundShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 135, 150, 75);

    miterShape.getFillFormat().setFillType(FillType.Solid);
    miterShape.getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    bevelShape.getFillFormat().setFillType(FillType.Solid);
    bevelShape.getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    roundShape.getFillFormat().setFillType(FillType.Solid);
    roundShape.getFillFormat().getSolidFillColor().setColor(Color.BLACK);

    miterShape.getLineFormat().setWidth(15);
    bevelShape.getLineFormat().setWidth(15);
    roundShape.getLineFormat().setWidth(15);

    miterShape.getLineFormat().getFillFormat().setFillType(FillType.Solid);
    miterShape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE);
    bevelShape.getLineFormat().getFillFormat().setFillType(FillType.Solid);
    bevelShape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE);
    roundShape.getLineFormat().getFillFormat().setFillType(FillType.Solid);
    roundShape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE);

    miterShape.getLineFormat().setJoinStyle(LineJoinStyle.Miter);
    bevelShape.getLineFormat().setJoinStyle(LineJoinStyle.Bevel);
    roundShape.getLineFormat().setJoinStyle(LineJoinStyle.Round);

    miterShape.getTextFrame().setText("Miter Join Style");
    bevelShape.getTextFrame().setText("Bevel Join Style");
    roundShape.getTextFrame().setText("Round Join Style");

    presentation.save("join_styles.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Limitare le giunzioni a smusso negli angoli acuti

Utilizza ILineFormat.setMiterLimit con ILineFormat.setJoinStyle impostato su LineJoinStyle.Miter per limitare quanto un angolo acuto può estendersi.

Il limite è un rapporto tra la distanza tra l’angolo interno e quello esterno della giunzione e la larghezza della linea. Per esempio, un valore di 8 consente una lunghezza di smusso fino a otto volte la larghezza della linea; non è una misura in punti. Se l’angolo supererebbe il limite, PowerPoint utilizza una giunzione smussata in quel punto. Un limite più grande permette punte più acute. L’impostazione influisce solo sulle giunzioni a smusso 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 8. Ogni triangolo è largo 80 punti e alto 160 punti, dando al suo angolo superiore un rapporto lunghezza‑smusso‑larghezza‑linea di circa 4,12. Di conseguenza, PowerPoint smussa l’apice sinistro e conserva quello destro.

import com.aspose.slides.*;
import android.graphics.Color;

Presentation presentation = new Presentation();
try {
    presentation.getSlideSize().setSize(500, 320, SlideSizeScaleType.DoNotScale);
    ISlide slide = presentation.getSlides().get_Item(0);

    float[] miterLimits = new float[] { 2f, 8f };

    for (int i = 0; i < miterLimits.length; i++) {
        IAutoShape triangle = slide.getShapes().addAutoShape(ShapeType.Triangle, 90 + i * 240, 110, 80, 160);
        triangle.getFillFormat().setFillType(FillType.NoFill);
        triangle.getLineFormat().setWidth(20);
        triangle.getLineFormat().getFillFormat().setFillType(FillType.Solid);
        triangle.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.rgb(0, 0, 139));
        triangle.getLineFormat().setJoinStyle(LineJoinStyle.Miter);
        triangle.getLineFormat().setMiterLimit(miterLimits[i]);
    }

    presentation.save("miter_limits.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Il risultato in PowerPoint: Miter limit 2 a sinistra e miter limit 8 a destra.

Un vertice smussato con limite di smusso 2 e un vertice appuntito con limite di smusso 8 in PowerPoint

Riempimento gradiente

Un riempimento gradiente mescola i colori su tutta la forma. Questo esempio riempie un’ellisse con un gradiente lineare a 45° dal rosso al viola usando IFillFormat.getGradientFormat. Il metodo IGradientStopCollection.addPresetColor posizione le fermate di colore a 0 e 1, l’inizio e la fine del gradiente. Cancellare le fermate esistenti assicura che vengano usati solo questi due colori.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Ellipse, 50, 50, 150, 75);
    shape.getFillFormat().setFillType(FillType.Gradient);
    shape.getFillFormat().getGradientFormat().setGradientShape(GradientShape.Linear);
    shape.getFillFormat().getGradientFormat().setLinearGradientAngle(45);
    shape.getFillFormat().getGradientFormat().getGradientStops().clear();
    shape.getFillFormat().getGradientFormat().getGradientStops().addPresetColor(1.0f, PresetColor.Purple);
    shape.getFillFormat().getGradientFormat().getGradientStops().addPresetColor(0.0f, PresetColor.Red);

    presentation.save("gradient_fill.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Il risultato:

L’ellisse con riempimento gradiente

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.

Impostare l’angolo del gradiente lineare

Utilizza IGradientFormat.setLinearGradientAngle 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 al basso, 180 da destra a sinistra, e 270 dal basso all’alto. Sono supportati angoli frazionari. Angoli finiti al di fuori dell’intervallo [0, 360) vengono normalizzati a una rivoluzione; ad esempio -45 diventa 315 e 360 diventa 0.

Questo esempio crea sei rettangoli con fermate rosse, verdi e blu identiche nelle posizioni 0, 0.5 e 1. La scalatura è 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.

import com.aspose.slides.*;
import android.graphics.Color;

Presentation presentation = new Presentation();
try {
    presentation.getSlideSize().setSize(720, 400, SlideSizeScaleType.DoNotScale);
    ISlide slide = presentation.getSlides().get_Item(0);

    float[] angles = new float[] { 0, 45, 90, 135, 180, 270 };

    for (int i = 0; i < angles.length; i++) {
        int x = 30 + (i % 3) * 230;
        int y = 30 + (i / 3) * 190;

        IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, x, y, 200, 150);
        shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill);
        shape.getFillFormat().setFillType(FillType.Gradient);

        IGradientFormat gradient = shape.getFillFormat().getGradientFormat();
        gradient.setGradientShape(GradientShape.Linear);
        gradient.getGradientStops().clear();
        gradient.getGradientStops().add(0f, Color.RED);
        gradient.getGradientStops().add(0.5f, Color.GREEN);
        gradient.getGradientStops().add(1f, Color.BLUE);
        gradient.setLinearGradientScaled(NullableBool.False);
        gradient.setLinearGradientAngle(angles[i]);
    }

    presentation.save("linear_gradient_angles.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Il risultato in PowerPoint:

Gradienti lineari a 0°, 45° e 90° nella riga superiore, e 135°, 180° e 270° nella riga inferiore

Scalare un gradiente lineare con la forma

IGradientFormat.setLinearGradientScaled accetta un valore NullableBool. Impostalo esplicitamente su False per mantenere l’angolo geometrico del gradiente mentre le proporzioni della forma cambiano, oppure su True per scalare il gradiente con larghezza e altezza della forma. Con la scalatura abilitata, 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 del confronto sugli angoli. La colonna sinistra usa False; la colonna destra usa True. Ogni colonna contiene un rettangolo largo sopra un rettangolo alto. Entrambe partono con le stesse dimensioni larghe; la modifica di larghezza e altezza del secondo rettangolo dimostra come il riempimento risponda al ridimensionamento senza cambiare le impostazioni del gradiente.

import com.aspose.slides.*;
import android.graphics.Color;

Presentation presentation = new Presentation();
try {
    presentation.getSlideSize().setSize(720, 460, SlideSizeScaleType.DoNotScale);
    ISlide slide = presentation.getSlides().get_Item(0);

    byte[] scalingOptions = new byte[] { NullableBool.False, NullableBool.True };

    for (int column = 0; column < scalingOptions.length; column++) {
        for (int row = 0; row < 2; row++) {
            int x = 30 + column * 360;
            int y = row == 0 ? 30 : 150;

            IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, x, y, 300, 90);
            shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill);
            shape.getFillFormat().setFillType(FillType.Gradient);

            IGradientFormat gradient = shape.getFillFormat().getGradientFormat();
            gradient.setGradientShape(GradientShape.Linear);
            gradient.getGradientStops().clear();
            gradient.getGradientStops().add(0f, Color.RED);
            gradient.getGradientStops().add(0.5f, Color.GREEN);
            gradient.getGradientStops().add(1f, Color.BLUE);
            gradient.setLinearGradientAngle(45);
            gradient.setLinearGradientScaled(scalingOptions[column]);

            if (row == 1) {
                shape.setWidth(90);
                shape.setHeight(280);
            }
        }
    }

    presentation.save("linear_gradient_scaling.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Il risultato in PowerPoint, con scalatura disabilitata a sinistra e abilitata a destra:

Rettangoli larghi e alti con un gradiente a 45°, confrontando LinearGradientScaled False a sinistra con True a destra

Con la scalatura disabilitata, le bande di colore diagonali mantengono la stessa orientazione in entrambi i rettangoli. Con la scalatura 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 dimensioni diverse. Su una forma quadrata, l’attivazione della scalatura non modifica l’aspetto di questo gradiente a 45 gradi.

Entrambi i parametri di angolo e scalatura si applicano ai gradienti lineari. Non controllano i riempimenti GradientShape.Radial o GradientShape.Rectangle.

Combinare l’angolo con la direzione del gradiente

IGradientFormat.setGradientDirection seleziona uno stile di gradiente dalla classe GradientDirection; non è un sostituto di un angolo numerico. Per un gradiente lineare, gli stili di angolo possono cambiare l’area su cui i colori sono distribuiti senza modificare l’angolo assegnato tramite setLinearGradientAngle. Mantieni la direzione invariata quando confronti angoli o scala.

L’esempio seguente applica le stesse impostazioni in ordine opposto. I due rettangoli hanno lo stesso aspetto: assegnare la direzione prima o dopo l’angolo non cambia il risultato.

import com.aspose.slides.*;
import android.graphics.Color;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    for (int i = 0; i < 2; i++) {
        IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 30, 30 + i * 140, 320, 100);
        shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill);
        shape.getFillFormat().setFillType(FillType.Gradient);

        IGradientFormat gradient = shape.getFillFormat().getGradientFormat();
        gradient.setGradientShape(GradientShape.Linear);
        gradient.getGradientStops().clear();
        gradient.getGradientStops().add(0f, Color.RED);
        gradient.getGradientStops().add(0.5f, Color.GREEN);
        gradient.getGradientStops().add(1f, Color.BLUE);
        gradient.setLinearGradientScaled(NullableBool.True);

        if (i == 0) {
            gradient.setGradientDirection(GradientDirection.FromCorner1);
            gradient.setLinearGradientAngle(30);
        } else {
            gradient.setLinearGradientAngle(30);
            gradient.setGradientDirection(GradientDirection.FromCorner1);
        }
    }

    presentation.save("linear_gradient_direction.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Riempimento a trama

Un riempimento a trama applica un disegno bicolore, ad esempio punti, strisce o quadretti. Questo esempio utilizza IPatternFormat.setPatternStyle per selezionare un motivo a graticcio. IPatternFormat.getBackColor fornisce lo sfondo grigio chiaro, e IPatternFormat.getForeColor fornisce il colore giallo del motivo.

import com.aspose.slides.*;
import android.graphics.Color;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75);
    shape.getFillFormat().setFillType(FillType.Pattern);
    shape.getFillFormat().getPatternFormat().setPatternStyle(PatternStyle.Trellis);
    shape.getFillFormat().getPatternFormat().getBackColor().setColor(Color.rgb(192, 192, 192));
    shape.getFillFormat().getPatternFormat().getForeColor().setColor(Color.YELLOW);

    presentation.save("pattern_fill.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Il risultato:

Il rettangolo con riempimento a trama

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 raccolta di immagini della presentazione. Impostare IPictureFillFormat.setPictureFillMode sulla modalità a mosaico ripete l’immagine all’interno del rettangolo. L’immagine di origine usata qui è mostrata sotto:

L’immagine del loto

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 255, 130);
    shape.getFillFormat().setFillType(FillType.Picture);
    shape.getFillFormat().getPictureFillFormat().setPictureFillMode(PictureFillMode.Tile);

    IImage image = Images.fromFile("lotus.png");
    IPPImage picture;
    try {
        picture = presentation.getImages().addImage(image);
    } finally {
        image.dispose();
    }
    shape.getFillFormat().getPictureFillFormat().getPicture().setImage(picture);

    presentation.save("picture_fill.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Il risultato:

La forma con riempimento immagine

Affiancare l’immagine come trama

Se desideri impostare un’immagine a mosaico come trama e personalizzare il comportamento del mosaico, puoi usare i seguenti metodi dell’interfaccia IPictureFillFormat e della classe PictureFillFormat:

  • setPictureFillMode: Imposta la modalità di riempimento immagine — Tile o Stretch.
  • setTileAlignment: Specifica l’allineamento delle tessere all’interno della forma.
  • setTileFlip: Controlla se la tessera è capovolta orizzontalmente, verticalmente o in entrambi i sensi.
  • setTileOffsetX: Imposta lo spostamento orizzontale della tessera (in punti) dall’origine della forma.
  • setTileOffsetY: Imposta lo spostamento verticale della tessera (in punti) dall’origine della forma.
  • setTileScaleX: Definisce la scala orizzontale della tessera come percentuale.
  • setTileScaleY: Definisce la scala verticale della tessera come percentuale.

Questo esempio richiede un’immagine locale e configura IPictureFillFormat per ripeterla al 50 % della sua dimensione originale. Spostamenti 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 trama ripetuta è disposta.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide firstSlide = presentation.getSlides().get_Item(0);

    IAutoShape shape = firstSlide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 190, 95);
    shape.getFillFormat().setFillType(FillType.Picture);

    IImage sourceImage = Images.fromFile("lotus.png");
    IPPImage presentationImage;
    try {
        presentationImage = presentation.getImages().addImage(sourceImage);
    } finally {
        sourceImage.dispose();
    }

    IPictureFillFormat pictureFillFormat = shape.getFillFormat().getPictureFillFormat();
    pictureFillFormat.getPicture().setImage(presentationImage);
    pictureFillFormat.setPictureFillMode(PictureFillMode.Tile);
    pictureFillFormat.setTileOffsetX(-32);
    pictureFillFormat.setTileOffsetY(-32);
    pictureFillFormat.setTileScaleX(50);
    pictureFillFormat.setTileScaleY(50);
    pictureFillFormat.setTileAlignment(RectangleAlignment.BottomRight);
    pictureFillFormat.setTileFlip(TileFlip.FlipBoth);

    presentation.save("tile.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Il risultato:

Le opzioni di tessellazione

Riempimento a colore solido

Un riempimento a colore solido conferisce alla forma un unico colore uniforme. Questo esempio utilizza IFillFormat.setFillType per selezionare la modalità di riempimento solido e assegna il giallo tramite IFillFormat.getSolidFillColor, quindi salva il rettangolo in una presentazione.

import com.aspose.slides.*;
import android.graphics.Color;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75);
    shape.getFillFormat().setFillType(FillType.Solid);
    shape.getFillFormat().getSolidFillColor().setColor(Color.YELLOW);

    presentation.save("solid_color_fill.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Il risultato:

La forma con riempimento a colore solido

Copiare i colori mantenendo i riferimenti del tema

Utilizza IColorFormat.copyFrom per copiare una definizione di colore, includendo il tipo di colore, il riferimento al tema e le 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 tipo di riempimento della destinazione con IFillFormat.setFillType.

Questo esempio crea tre rettangoli, da sinistra a destra: la sorgente, una copia sensibile al tema e una copia RGB fissa. La sorgente utilizza IColorFormat.setSchemeColor per fare riferimento al primo colore di accentazione e aggiunge una tinta tramite IColorOperationCollection.add. La copia RGB utilizza il colore di riempimento effettivo della sorgente, così tutte e tre inizialmente appaiono identiche. Chiamare IColorFormat.setColor imposta un valore RGB fisso e cancella eventuali trasformazioni di colore esistenti.

import com.aspose.slides.*;
import android.graphics.Color;

Presentation presentation = new Presentation();
try {
    presentation.getSlideSize().setSize(660, 220, SlideSizeScaleType.DoNotScale);
    ISlide slide = presentation.getSlides().get_Item(0);

    presentation.getMasterTheme().getColorScheme().getAccent1().setColor(Color.rgb(65, 105, 225));

    IAutoShape source = slide.getShapes().addAutoShape(ShapeType.Rectangle, 30, 40, 180, 140);
    IAutoShape themeCopy = slide.getShapes().addAutoShape(ShapeType.Rectangle, 240, 40, 180, 140);
    IAutoShape rgbCopy = slide.getShapes().addAutoShape(ShapeType.Rectangle, 450, 40, 180, 140);

    for (IAutoShape shape : new IAutoShape[] { source, themeCopy, rgbCopy }) {
        shape.getFillFormat().setFillType(FillType.Solid);
        shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill);
    }

    IColorFormat sourceColor = source.getFillFormat().getSolidFillColor();
    sourceColor.setSchemeColor(SchemeColor.Accent1);
    sourceColor.getColorTransform().add(ColorTransformOperation.Tint, 0.75f);

    themeCopy.getFillFormat().getSolidFillColor().copyFrom(sourceColor);
    rgbCopy.getFillFormat().getSolidFillColor().setColor(source.getFillFormat().getEffective().getSolidFillColor());

    IImage before = slide.getImage(1f, 1f);
    try {
        before.save("color-copy-before.png", ImageFormat.Png);
    } finally {
        before.dispose();
    }

    // I riferimenti del tema seguono il nuovo colore di accento; il valore RGB fisso no.
    presentation.getMasterTheme().getColorScheme().getAccent1().setColor(Color.rgb(255, 69, 0));

    IImage after = slide.getImage(1f, 1f);
    try {
        after.save("color-copy-after.png", ImageFormat.Png);
    } finally {
        after.dispose();
    }
    presentation.save("copied_colors.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Prima del cambiamento del tema, tutti e tre i riempimenti corrispondono:

Sorgente, destinazione copyFrom e destinazione RGB fissa con riempimenti blu identici

Dopo il cambiamento del tema, la sorgente e la copia sensibile al tema seguono il nuovo colore di accentazione e mantengono la loro tinta. La copia RGB fissa rimane blu:

Sorgente e destinazione copyFrom con riempimenti arancioni, mentre la destinazione RGB fissa rimane blu

La definizione copiata è indipendente dalla sorgente. Modificare successivamente il riferimento al tema della sorgente, assegnare un altro colore o aggiungere/rimuovere le sue trasformazioni non cambia la destinazione. Un cambiamento del tema influisce comunque su entrambe le forme perché ciascuna fa riferimento in modo indipendente allo stesso colore del tema.

Il salvataggio e la riapertura del PPTX conservano il tipo di colore copiato, il riferimento al tema e la collezione di trasformazioni, come restituito da IColorFormat.getColorType e IColorFormat.getColorTransform; non appiattiscono la definizione in RGB.

Quando si copia tra contesti tematici diversi, ad esempio presentazioni con palette di accentazione differenti, il riferimento copiato viene risolto rispetto al tema di destinazione. Lo stesso riferimento e le stesse trasformazioni possono quindi produrre un colore visibile diverso. Vedi Presentation Theme per ulteriori informazioni sulla configurazione dei colori del tema.

Utilizzare lo sfondo della diapositiva come riempimento della forma

Utilizza IAutoShape.setUseBackgroundFill quando una forma deve corrispondere allo sfondo della diapositiva, ad esempio in un modello di presentazione. Imposta il tipo di riempimento con IFillFormat.setFillType su FillType.NotDefined prima per rimuovere qualsiasi riempimento esplicito. Con questa combinazione, la forma utilizza lo sfondo della diapositiva anziché il suo riempimento di stile. Attivare il flag da solo non rimuove un riempimento esplicito esistente.

Ciò è diverso da FillType.NoFill: il riempimento di sfondo copre gli oggetti dietro la forma con l’area corrispondente dello sfondo della diapositiva, mentre nessun riempimento lascia quei oggetti visibili. Un gradiente rimane allineato con la diapositiva anziché ripartire 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 dal riempimento di sfondo a un riempimento arancione esplicito.

import com.aspose.slides.*;
import android.graphics.Color;

Presentation presentation = new Presentation();
try {
    presentation.getSlideSize().setSize(720, 400, SlideSizeScaleType.DoNotScale);
    ISlide slide = presentation.getSlides().get_Item(0);

    // Eredita il gradiente dal master.
    slide.getBackground().setType(BackgroundType.NotDefined);
    slide.getLayoutSlide().getBackground().setType(BackgroundType.NotDefined);
    IBackground background = slide.getLayoutSlide().getMasterSlide().getBackground();
    background.setType(BackgroundType.OwnBackground);
    background.getFillFormat().setFillType(FillType.Gradient);
    IGradientFormat gradient = background.getFillFormat().getGradientFormat();
    gradient.setGradientShape(GradientShape.Linear);
    gradient.setLinearGradientAngle(0);
    gradient.getGradientStops().clear();
    gradient.getGradientStops().add(0, Color.rgb(0, 0, 139));
    gradient.getGradientStops().add(1, Color.rgb(135, 206, 250));

    // Aggiungi questo oggetto per primo in modo che appaia dietro i rettangoli.
    IAutoShape band = slide.getShapes().addAutoShape(ShapeType.Rectangle, 25, 150, 670, 100);
    band.getFillFormat().setFillType(FillType.Solid);
    band.getFillFormat().getSolidFillColor().setColor(Color.MAGENTA);
    band.getLineFormat().getFillFormat().setFillType(FillType.NoFill);

    IAutoShape backgroundShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 100, 160, 200);
    backgroundShape.getFillFormat().setFillType(FillType.NotDefined);
    backgroundShape.setUseBackgroundFill(true);

    IAutoShape noFillShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 280, 100, 160, 200);
    noFillShape.getFillFormat().setFillType(FillType.NoFill);

    IAutoShape explicitShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 510, 100, 160, 200);
    explicitShape.getFillFormat().setFillType(FillType.NotDefined);
    explicitShape.setUseBackgroundFill(true);

    // Disabilita il riempimento di sfondo prima di applicare un riempimento esplicito.
    explicitShape.setUseBackgroundFill(false);
    explicitShape.getFillFormat().setFillType(FillType.Solid);
    explicitShape.getFillFormat().getSolidFillColor().setColor(Color.rgb(255, 165, 0));

    presentation.save("background_fill.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Il risultato, da sinistra a destra: background fill, no fill, e explicit fill. La banda magenta è nascosta dai rettangoli sinistro e destro ma rimane visibile attraverso il rettangolo centrale.

Riempimento di sfondo, nessun riempimento e riempimento arancione esplicito sopra una banda magenta

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ì che il master lo fornisca.

Impostare la trasparenza

Per un riempimento solido, il componente alfa del colore controlla l’opacità: 0 è completamente trasparente e 255 è completamente opaco. Questo esempio utilizza un valore alfa di 128 per un rettangolo giallo, rendendolo approssimativamente 50 % trasparente in modo che il rettangolo sottostante rimanga visibile. Il colore è assegnato tramite IFillFormat.getSolidFillColor.

import com.aspose.slides.*;
import android.graphics.Color;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape solidShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75);

    IAutoShape transparentShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 80, 80, 150, 75);
    transparentShape.getFillFormat().setFillType(FillType.Solid);
    transparentShape.getFillFormat().getSolidFillColor().setColor(Color.argb(128, 255, 255, 0));

    presentation.save("shape_transparency.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Il risultato:

La forma trasparente

Ruotare le forme

Utilizza IShape.setRotation 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.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75);
    shape.setRotation(5);

    presentation.save("shape_rotation.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Il risultato:

La rotazione della forma

Aggiungere effetti di smusso 3D

Utilizza IShape.getThreeDFormat per dare a una forma profondità e bordi smussati. Questo esempio crea un’ellisse verde con un contorno arancione, utilizza IThreeDFormat.setDepth per impostare la profondità a 4 punti e applica uno smusso superiore circolare con larghezza e altezza di 6 punti tramite IThreeDFormat.getBevelTop. Una telecamera ortografica frontale e un’illuminazione a tre punti rendono visibile lo smusso.

import com.aspose.slides.*;
import android.graphics.Color;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Ellipse, 50, 50, 100, 100);
    shape.getFillFormat().setFillType(FillType.Solid);
    shape.getFillFormat().getSolidFillColor().setColor(Color.rgb(0, 128, 0));
    shape.getLineFormat().getFillFormat().setFillType(FillType.Solid);
    shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.rgb(255, 165, 0));
    shape.getLineFormat().setWidth(2.0);
    shape.getThreeDFormat().setDepth(4);
    shape.getThreeDFormat().getBevelTop().setBevelType(BevelPresetType.Circle);
    shape.getThreeDFormat().getBevelTop().setHeight(6);
    shape.getThreeDFormat().getBevelTop().setWidth(6);
    shape.getThreeDFormat().getCamera().setCameraType(CameraPresetType.OrthographicFront);
    shape.getThreeDFormat().getLightRig().setLightType(LightRigPresetType.ThreePt);
    shape.getThreeDFormat().getLightRig().setDirection(LightingDirection.Top);

    presentation.save("3D_bevel_effect.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Il risultato:

L’effetto di smusso 3D

Aggiungere effetti di rotazione 3D

La vista 3D di una forma è controllata dalle impostazioni della telecamera. Questo esempio utilizza ICamera.setRotation con angoli di latitudine, longitudine e rivoluzione di 40°, 35° e 20° rispettivamente. Seleziona una telecamera isometrica tramite ICamera.setCameraType e un’illuminazione bilanciata tramite ILightRig.setLightType, quindi salva il rettangolo formattato.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape autoShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75);
    autoShape.getTextFrame().setText("Hello, Aspose!");
    autoShape.getThreeDFormat().getCamera().setCameraType(CameraPresetType.IsometricLeftUp);
    autoShape.getThreeDFormat().getCamera().setRotation(40, 35, 20);
    autoShape.getThreeDFormat().getLightRig().setLightType(LightRigPresetType.Balanced);

    presentation.save("3D_rotation_effect.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Il risultato:

L’effetto di rotazione 3D

Controllare la resa in bianco e nero per le forme

Il metodo IShape.setBlackWhiteMode specifica come una singola forma è renderizzata quando una presentazione è visualizzata o elaborata in modalità bianco‑nero. Non attiva da solo la visualizzazione in bianco‑nero e non modifica il riempimento, il contorno o altre formattazioni della forma in modalità a colori normale.

Usa un valore della classe BlackWhiteMode per selezionare il comportamento desiderato. Per esempio, Automatic consente all’applicazione di rendering di scegliere la conversione, Gray e LightGray usano la colorazione grigia, BlackWhite usa solo nero e bianco, Black e White forzano un colore unico, Color preserva la colorazione normale, e Hidden omette la forma in modalità bianco‑nero. NotDefined significa che non è stato assegnato alcun modo a livello di forma.

Questo esempio crea un rettangolo arancione e utilizza IShape.setBlackWhiteMode per selezionare la colorazione grigia. La forma salvata conserva il riempimento arancione per la visualizzazione a colori normale e richiede la colorazione grigia alle applicazioni che rispettano le impostazioni di visualizzazione bianco‑nero:

import com.aspose.slides.*;
import android.graphics.Color;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 200, 100);
    shape.getFillFormat().setFillType(FillType.Solid);
    shape.getFillFormat().getSolidFillColor().setColor(Color.rgb(255, 165, 0));
    shape.setBlackWhiteMode(BlackWhiteMode.Gray);

    presentation.save("shape_black_white_mode.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

In modalità a colori normale, il rettangolo conserva il suo riempimento arancione. In un flusso di lavoro a visualizzazione bianco‑nero, utilizza la colorazione grigia perché il suo modo è impostato su Gray. Questo consente di preservare una diapositiva a colori completi definendo un aspetto distinto per la stampa, l’anteprima o altri flussi di lavoro che rispettano le impostazioni di visualizzazione bianco‑nero della presentazione.

Ripristinare la formattazione

Utilizza ISlide.reset per ripristinare la posizione, le dimensioni e la formattazione dei segnaposto delle diapositive dalle corrispondenti diapositive layout. Questo esempio richiede una presentazione esistente con segnaposto collegati al layout e ripristina ogni diapositiva prima di salvare. Le forme senza segnaposto corrispondente nel layout non vengono ripristinate.

import com.aspose.slides.*;

Presentation presentation = new Presentation("sample.pptx");
try {
    for (ISlide slide : presentation.getSlides()) {
        slide.reset();
    }

    presentation.save("reset_formatting.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

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 incorporate. I riempimenti immagine possono aumentare la dimensione del file perché le loro immagini sono memorizzate nella presentazione.

Come posso individuare le forme su una diapositiva che condividono la stessa formattazione per raggrupparle?

Confronta le proprietà chiave di formattazione di ogni forma—riempimento, linea e impostazioni di effetto. Se tutti i valori corrispondenti coincidono, trattali come stili 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 riutilizzarlo in altre presentazioni?

Sì. Salva le forme di esempio con gli stili desiderati in un modello di diapositiva o in un file .POTX. Quando crei una nuova presentazione, apri il modello, clona le forme stilizzate di cui hai bisogno e riapplica la loro formattazione dove necessario.