Formatera PowerPoint-former på Android

Introduktion

Formatera former i PowerPoint genom att justera deras konturer, fyllningar och effekter. Aspose.Slides för Android via Java låter dig styra dessa inställningar programmässigt, inklusive transparens, rotation och 3D-formatering.

Formateringsalternativ för former i PowerPoint

Aspose.Slides för Android via Java tillhandahåller gränssnitt och metoder som låter dig formatera former med samma alternativ som finns i PowerPoint.

Formatera linjer

Använd IShape.getLineFormat för att kontrollera en formes kontur. Detta exempel skapar en ofylld rektangel med en blå, streckad kontur. ILineFormat.setStyle väljer en tjock‑tunn sammansatt linje, medan ILineFormat.setWidth sätter dess bredd till 7 punkter och ILineFormat.setDashStyle väljer dash‑mönstret.

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();
}

Resultatet:

De formaterade linjerna i presentationen

Ange anpassade dashmönster för linjer

Använd ILineFormat.setCustomDashPattern när fördefinierade linjestilar inte ger de dash‑längder och -gap du behöver, till exempel för varumärkta konturer eller tekniska diagram. Att tilldela ett mönster ändrar automatiskt linjedash‑stilen till LineDashStyle.Custom.

Array‑elementen alternerar mellan dash‑ och gap‑längder, med en dash först. Varje värde är en multipel av linjebredden: { 4, 2 } vid en bredd på 3 punkter ger en 12‑punkts dash följd av ett 6‑punkts gap. Använd par av ändliga, icke‑negativa värden för att definiera kompletta dash‑och‑gap‑segment. Exemplet använder positiva värden för att hålla varje dash och gap synliga.

Detta exempel skapar fem blå linjer med samma längd och platta ändar. De första tre jämför mönster vid en bredd på 3 punkter. Den fjärde upprepar det första mönstret vid dubbel bredd, vilket fördubblar både dash‑ och gap‑längderna. Den femte byter från ett anpassat mönster till en solid linje.

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]);
    }

    // Återställ den sista linjen till en solid stil.
    slide.getShapes().get_Item(4).getLineFormat().setDashStyle(LineDashStyle.Solid);

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

För att återgå till en fördefinierad streckad stil istället, skicka LineDashStyle.Dash till ILineFormat.setDashStyle. Den valda stilen styr linjens utseende.

Resultatet i PowerPoint, från topp till botten: {4, 2}, 3 pt; {1, 2}, 3 pt; {6, 2, 1, 2}, 3 pt; {4, 2}, 6 pt; och Solid, 3 pt.

Tre anpassade dash‑mönster, en bredare linje som använder det första mönstret och en solid linje i PowerPoint

Ställ in linjeändar

Använd ILineFormat.setCapStyle för att ange ändarna på en öppen linje. Klassen LineCapStyle ger tre explicita cap‑stilar:

  • Flat: Styrkan slutar vid slutpunkten.
  • Round: En halvcirkelkap sträcker sig förbi slutpunkten med halva linjebredden.
  • Square: En fyrkantig kap sträcker sig förbi slutpunkten med halva linjebredden.

Klassen innehåller också NotDefined, vilket betyder att ingen cap‑stil har tilldelats explicit.

Caps är olika från pilspetsar, som lägger till symboler i linjeändarna, och joins, som styr hörn mellan linjesegment. Detta exempel inaktiverar pilspetsar via ILineFormat.setBeginArrowheadStyle och ILineFormat.setEndArrowheadStyle så att endast cap‑formerna jämförs.

Följande exempel skapar tre i övrigt identiska horisontella linjer, 20 punkter breda. Från topp till botten använder de platta, runda och fyrkantiga caps. Deras slutpunkter har samma horisontella koordinater; de runda och fyrkantiga caps sträcker sig 10 punkter förbi varje slutpunkt.

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();
}

Resultatet i PowerPoint, från topp till botten: Flat, Round och Square.

Platta, runda och fyrkantiga ändar på identiska tjocka linjer i PowerPoint

Applicera skiss‑effekter på formelinjer

En skiss‑effekt får en formelinje att se handritad ut. Använd IShape.getLineFormat för att komma åt linjeinställningarna, ILineFormat.getSketchFormat för att komma åt skissinställningarna, och ISketchFormat.setSketchType för att välja ett värde från klassen LineSketchType.

Följande Java‑kod visar hur man applicerar en LineSketchType.Curved‑effekt, läser det explicit tilldelade värdet och tar bort effekten med 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();
}

Värdet som returneras av ISketchFormat.getSketchType representerar inställningen som tilldelats direkt till formen. Om linjeformatering kan ärvas från ett tema, en master‑slide eller en layout‑slide, använd ILineFormat.getEffective, åtkomst ILineFormatEffectiveData.getSketchFormat, och läs ISketchFormatEffectiveData.getSketchType. Det effektiva värdet speglar den formatering som faktiskt tillämpas efter att arv har lösts. Detta exempel kräver en befintlig presentation med minst en form på första sliden och skriver ut båda värdena:

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();
}

Formatera anslutningsstilar

Här är de tre alternativen för join‑typ:

  • Rund
  • Sned
  • Avfasad

Join‑stilen styr hur två kontursegment möts i ett hörn. Använd Rund för runda hörn, Sned för skarpa hörn, eller Avfasad för platta hörn.

Join‑stilen i presentationen

Detta exempel skapar tre svarta rektanglar med blå konturer 15 punkter breda. Det använder ILineFormat.setJoinStyle för att tillämpa sned‑, avfasad‑ och rund‑värdena från LineJoinStyle, respektive, för att jämföra hur hörnen ritas.

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();
}

Begränsa Sned‑anslutningar vid skarpa hörn

Använd ILineFormat.setMiterLimit tillsammans med ILineFormat.setJoinStyle satt till LineJoinStyle.Miter för att begränsa hur långt ett skarpt hörn får sträcka sig.

Gränsen är ett förhållande mellan avståndet mellan det inre och yttre hörnet i joinen och linjebredden. Till exempel tillåter ett värde på 8 en sned‑längd på upp till åtta gånger linjebredden; det är ingen mätning i punkter. Om hörnet skulle överskrida gränsen använder PowerPoint en avfasad join i det hörnet. En större gräns tillåter skarpare punkter. Inställningen påverkar endast sned‑joins, och ändring har ingen synlig effekt när hörnet förblir inom båda gränserna.

Detta exempel skapar två identiska, ofyllda trianglar med konturer 20 punkter breda. Vänstra triangeln använder en gräns på 2, och den högra använder 8. Varje triangel är 80 punkter bred och 160 punkter hög, vilket ger dess övre hörn ett sned‑längd‑till‑linjebredd‑förhållande på ungefär 4.12. Följaktligen avfasar PowerPoint vänstra spetsen och bevarar den högra spetsen.

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();
}

Resultatet i PowerPoint: Miter‑gräns 2 till vänster och miter‑gräns 8 till höger.

En avfasad topp med miter‑gräns 2 och en spetsig topp med miter‑gräns 8 i PowerPoint

Gradientfyllning

En gradientfyllning blandar färger över en form. Detta exempel fyller en ellips med en linjär gradient i 45‑graders vinkel från rött till lila med hjälp av IFillFormat.getGradientFormat. Metoden IGradientStopCollection.addPresetColor placerar färgstopp vid 0 och 1, början och slutet av gradienten. Att rensa befintliga stopp säkerställer att endast dessa två färger används.

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();
}

Resultatet:

Ellipsen med gradientfyllning

Om en gradient ser annorlunda ut i en exporterad bild än i PowerPoint, se Choose a Gradient Rendering Style. Du kan välja en renderingsstil utan att ändra gradientfyllningen som lagras i presentationen.

Ange vinkeln för linjär gradient

Använd IGradientFormat.setLinearGradientAngle för att kontrollera orienteringen av en GradientShape.Linear‑fyllning. Vinkeln mäts i grader och ökar medurs: 0 går från vänster till höger, 90 från topp till botten, 180 från höger till vänster och 270 från botten till topp. Bråkdelar av grader stöds. Vinklar utanför [0, 360) normaliseras till en hel varv; exempelvis blir -45 till 315 och 360 till 0.

Detta exempel skapar sex rektanglar med identiska röd‑, grön‑ och blå‑stopp vid positionerna 0, 0.5 och 1. Skalning är inaktiverad så att vinkeln kan jämföras oberoende av rektanglarnas proportioner. Vinklarna, från vänster till höger, är 0, 45 och 90 i första raden samt 135, 180 och 270 i den andra raden.

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();
}

Resultatet i PowerPoint:

Linjär gradient vid 0, 45 och 90 grader i den övre raden, och 135, 180 och 270 grader i den nedre raden

Skala en linjär gradient med formen

IGradientFormat.setLinearGradientScaled accepterar ett NullableBool-värde. Ställ in det explicit till False för att behålla den geometriska gradientvinkeln när formens proportioner förändras, eller till True för att skala gradienten med formens bredd och höjd. Med skalning aktiverad kan den synliga vinkeln skilja sig från den tilldelade vinkeln på en icke‑fyrkantig form.

Följande exempel använder en 45‑graders vinkel och samma färgstopp som i vinkeljämförelsen. Den vänstra kolumnen använder False; den högra kolumnen använder True. Varje kolumn innehåller en bred rektangel ovanför en hög rektangel. Båda startar med samma bredd; genom att ändra den andra rektangelns bredd och höjd demonstreras hur fyllningen svarar på storleksändring utan att ändra gradientinställningarna.

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();
}

Resultatet i PowerPoint, med skalning inaktiverad till vänster och aktiverad till höger:

Breda och höga rektanglar med en 45‑graders gradient, jämför LinearGradientScaled False till vänster med True till höger

Med skalning inaktiverad behåller de diagonala färgbanden samma orientering i båda rektanglarna. Med skalning aktiverad sträcks banden med formens proportioner. Detta underlättar att reproducera en mall‑gradient när en form anpassas till en annan storlek. På en fyrkant förändras inte utseendet för denna 45‑graders gradient när skalning är aktiverad.

Både vinkel‑ och skalningsinställningarna gäller för linjära gradienter. De styr inte GradientShape.Radial eller GradientShape.Rectangle‑fyllningar.

Kombinera vinkeln med gradientens riktning

IGradientFormat.setGradientDirection väljer en gradientstil från klassen GradientDirection; den ersätter inte en numerisk vinkel. För en linjär gradient kan hörn‑stilarna ändra området där färgerna fördelas utan att ändra vinkeln som tilldelats via setLinearGradientAngle. Behåll riktningen oförändrad när du jämför vinklar eller skalning.

Följande exempel applicerar samma inställningar i omvänd ordning. De två rektanglarna ser likadana ut: att tilldela riktningen före eller efter vinkeln ändrar inte resultatet.

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();
}

Mönsterfyllning

En mönsterfyllning applicerar en två‑färgsdesign, såsom prickar, ränder eller rutnät. Detta exempel använder IPatternFormat.setPatternStyle för att välja ett spaltningsmönster. IPatternFormat.getBackColor tillhandahåller den ljusgrå bakgrunden, och IPatternFormat.getForeColor tillhandahåller den gula mönsterfärgen.

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();
}

Resultatet:

Rektangeln med mönsterfyllning

Bildfyllning

En bildfyllning använder en bild inuti en form. Detta exempel kräver en lokal bild och använder Images.fromFile för att ladda den i presentationens bildsamling. Att sätta IPictureFillFormat.setPictureFillMode till mosaikläget upprepar bilden inom rektangeln. Källbilden som används visas nedan:

Lotus‑bilden

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();
}

Resultatet:

Formen med bildfyllning

Tile bild som textur

Om du vill ställa in en mosaik‑bild som textur och anpassa mosaikbeteendet kan du använda följande metoder i gränssnittet IPictureFillFormat och klassen PictureFillFormat:

  • setPictureFillMode: Ställer in bildfyllningsläget — antingen Tile eller Stretch.
  • setTileAlignment: Anger justeringen av mosaikerna inom formen.
  • setTileFlip: Styr om mosaiken speglas horisontellt, vertikalt eller båda.
  • setTileOffsetX: Ställer in den horisontella förskjutningen av mosaiken (i punkter) från formens ursprung.
  • setTileOffsetY: Ställer in den vertikala förskjutningen av mosaiken (i punkter) från formens ursprung.
  • setTileScaleX: Definierar mosaikens horisontella skala som procent.
  • setTileScaleY: Definierar mosaikens vertikala skala som procent.

Detta exempel kräver en lokal bild och konfigurerar IPictureFillFormat för att upprepa den på 50 % av sin originalstorlek. Förskjutningar på –32 punkter flyttar mosaikerna horisontellt och vertikalt; justering längst ner till höger och spegling i båda riktningarna bestämmer hur den upprepade texturen placeras.

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();
}

Resultatet:

Mosaikalternativen

Solid färgfyllning

En solid fyllning ger en form en enda, enhetlig färg. Detta exempel använder IFillFormat.setFillType för att välja solid‑fyllningsläge och tilldelar gul via IFillFormat.getSolidFillColor, därefter sparas rektangeln i en presentation.

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();
}

Resultatet:

Formen med solid färgfyllning

Använd bildbakgrunden som formfyllning

Använd IAutoShape.setUseBackgroundFill när en form ska matcha bildbakgrunden, till exempel i en presentationsmall. Använd IFillFormat.setFillType med FillType.NotDefined först för att ta bort eventuell explicit fyllning. Med denna kombination använder formen bildbakgrunden istället för sin stil‑fyllning. Att enbart sätta flaggan tar inte bort en existerande explicit fyllning.

Detta skiljer sig från FillType.NoFill: bakgrundsfyllning täcker objekt bakom formen med motsvarande område av bildbakgrunden, medan ingen fyllning låter dessa objekt vara synliga. En gradient förblir anpassad till bilden istället för att starta om i varje form.

Följande exempel skapar en masterbakgrund som ärvs av sliden och placerar ett magentaband bakom tre rektanglar. Vänstra rektangeln använder bakgrunden, den mellersta har ingen fyllning, och den högra byter från bakgrundsfyllning till en explicit orange fyllning.

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);

    // Ärv gradienten från 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));

    // Lägg till detta objekt först så att det visas bakom rektanglarna.
    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);

    // Inaktivera bakgrundsfyllning innan en explicit fyllning appliceras.
    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();
}

Resultatet, från vänster till höger: bakgrundsfyllning, ingen fyllning, och explicit fyllning. Magentabandet döljs av vänstra och högra rektanglarna men förblir synligt genom den mellersta.

Bakgrundsfyllning, ingen fyllning och explicit orange fyllning över ett magentaband

Samma beteende gäller för en bakgrund som definieras direkt på sliden eller som ärvs från en layout. Formen använder slidens lösta bakgrund; exemplet lämnar både slide‑ och layout‑bakgrunder odefinierade så att master‑bakgrunden levereras.

Ställ in transparens

För en solid fyllning styr färgens alfa‑komponent opaciteten: 0 är helt transparent och 255 är helt ogenomskinligt. Detta exempel använder ett alfa‑värde på 128 för en gul rektangel, vilket gör den ungefär 50 % transparent så att rektangeln under förblir synlig. Färgen tilldelas via 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();
}

Resultatet:

Den transparenta formen

Rotera former

Använd IShape.setRotation för att rotera en form i slidens plan. Vinkeln mäts i grader; detta exempel roterar en rektangel 5 grader medurs och sparar presentationen.

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();
}

Resultatet:

Formens rotation

Lägg till 3D‑avfasningseffekter

Använd IShape.getThreeDFormat för att ge en form djup och avfasade kanter. Detta exempel skapar en grön ellips med en orange kontur, använder IThreeDFormat.setDepth för att sätta djupet till 4 punkter, och applicerar en cirkulär top‑bevel med bredd och höjd på 6 punkter via IThreeDFormat.getBevelTop. En front‑facing ortografisk kamera och tre‑punkts belysning gör avfasningen synlig.

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();
}

Resultatet:

3D‑avfasningseffekten

Lägg till 3D‑roterings‑effekter

En forms 3D‑vy styrs av dess kamerainställningar. Detta exempel använder ICamera.setRotation med latitud, longitud och revolutionsvinklar på 40, 35 respektive 20 grader. Det väljer en isometrisk kamera via ICamera.setCameraType och balanserad belysning via ILightRig.setLightType, och sparar den formaterade rektangeln.

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();
}

Resultatet:

3D‑roterings‑effekten

Styr svart‑vitt‑rendering för former

Metoden IShape.setBlackWhiteMode anger hur en enskild form renderas när en presentation visas eller bearbetas i svart‑vitt‑läge. Den aktiverar inte svart‑vitt‑visning i sig, och den ändrar inte formens fyllning, linje eller annan formatering i normalt färgläge.

Använd ett värde från klassen BlackWhiteMode för att välja önskat beteende. Till exempel låter Automatic renderingsprogrammet välja konverteringen, Gray och LightGray använder grå färgning, BlackWhite använder endast svart och vitt, Black och White tvingar en enda färg, Color bevarar normal färgning, och Hidden utesluter formen i svart‑vitt‑läge. NotDefined betyder att ingen form‑specifik modus är tilldelad.

Detta exempel skapar en orange rektangel och använder IShape.setBlackWhiteMode för att välja grå färgning. Den sparade formen behåller sin orange fyllning för normalt färgvisning och begär grå färgning från program som hedrar svart‑vitt‑visningsinställningar:

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();
}

I normalt färgläge behåller rektangeln sin orange fyllning. I ett arbetsflöde med svart‑vitt‑visning använder den grå färgning eftersom dess läge är satt till Gray. Detta låter dig bevara en full‑färgs‑slide samtidigt som du definierar ett distinkt utseende för utskrift, förhandsvisning eller andra arbetsflöden som hedrar presentationens svart‑vitt‑visningsinställningar.

Återställ formatering

Använd ISlide.reset för att återställa position, storlek och formatering av platshållare på sliden från motsvarande platshållare i layouten. Detta exempel kräver en befintlig presentation med layout‑länkade platshållare och återställer varje slide innan den sparas. Former utan motsvarande layout‑platshållare återställs inte.

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

Påverkar formatet av former den slutgiltiga filstorleken på presentationen?

Färger, linjestilar och effektinställningar lägger generellt till mycket lite data jämfört med inbäddade bilder och media. Bildfyllningar kan öka filstorleken eftersom deras bilder lagras i presentationen.

Hur kan jag identifiera former på en slide som har identisk formatering så att jag kan gruppera dem?

Jämför varje forms nyckelformaterings‑egenskaper – fyllning, linje och effektinställningar. Om alla motsvarande värden matchar, behandla deras stilar som identiska och gruppera logiskt dessa former, vilket förenklar senare stilhantering.

Kan jag spara en uppsättning anpassade formstilar i en separat fil för återanvändning i andra presentationer?

Ja. Spara exempelformer med önskade stilar i en mall‑presentationsfil eller en .POTX‑mall. När du skapar en ny presentation, öppna mallen, klona de stylade former du behöver och återapplicera deras formatering där det krävs.