PowerPoint-vormen op Android formatteren

Inleiding

Formatteer vormen in PowerPoint door hun omtrek, vulling en effecten aan te passen. Aspose.Slides for Android via Java stelt u in staat deze instellingen programmatisch te regelen, inclusief transparantie, rotatie en 3D-formattering.

Shape formatting options in PowerPoint

Aspose.Slides for Android via Java biedt interfaces en methoden waarmee u vormen kunt formatteren met dezelfde opties die beschikbaar zijn in PowerPoint.

Lijnen formatteren

Gebruik IShape.getLineFormat om de omtrek van een vorm te controleren. Dit voorbeeld maakt een niet‑gevulde rechthoek met een blauwe, gestippelde omtrek. ILineFormat.setStyle kiest een dikke‑dunne samengestelde lijn, terwijl ILineFormat.setWidth de breedte op 7 punten zet en ILineFormat.setDashStyle het gestippelde patroon selecteert.

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

Het resultaat:

The formatted lines in the presentation

Aangepaste stippatronen instellen

Gebruik ILineFormat.setCustomDashPattern wanneer vooraf gedefinieerde lijnstijlen niet de gewenste dash‑lengtes en -gaten bieden, bijvoorbeeld voor merk‑omtrekken of technische diagrammen. Het toewijzen van een patroon wijzigt automatisch de lijn‑dash‑stijl naar LineDashStyle.Custom.

Array‑items alterneren tussen dash‑ en gap‑lengtes, beginnend met een dash. Elke waarde is een veelvoud van de lijndikte: { 4, 2 } bij een breedte van 3 punten levert een dash van 12 punten gevolgd door een gat van 6 punten op. Gebruik paren van eindige, niet‑negatieve waarden om volledige dash‑en‑gap‑segmenten te definiëren. Het voorbeeld gebruikt positieve waarden zodat elke dash en elk gat zichtbaar blijft.

Dit voorbeeld maakt vijf blauwe lijnen met dezelfde lengte en platte uiteinden. De eerste drie vergelijken patronen bij een breedte van 3 punten. De vierde herhaalt het eerste patroon bij dubbele breedte, waardoor zowel dash als gap verdubbelen. De vijfde schakelt van een aangepast patroon naar een doorlopende lijn.

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

    // Zet de laatste lijn terug naar een solide stijl.
    slide.getShapes().get_Item(4).getLineFormat().setDashStyle(LineDashStyle.Solid);

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

Om terug te keren naar een vooraf gedefinieerde gestippelde stijl, geeft u LineDashStyle.Dash door aan ILineFormat.setDashStyle. De geselecteerde stijl bepaalt het uiterlijk van de lijn.

Het resultaat in PowerPoint, van boven naar beneden: {4, 2}, 3 pt; {1, 2}, 3 pt; {6, 2, 1, 2}, 3 pt; {4, 2}, 6 pt; en Solid, 3 pt.

Three custom dash patterns, a wider line using the first pattern, and a solid line in PowerPoint

Lijnuiteinden (caps) instellen

Gebruik ILineFormat.setCapStyle om de uiteinden van een open lijn in te stellen. De klasse LineCapStyle biedt drie expliciete cap‑stijlen:

  • Flat: De streep stopt bij het eindpunt.
  • Round: Een halve cirkelvormige cap strekt zich half de lijndikte voorbij het eindpunt uit.
  • Square: Een vierkante cap strekt zich half de lijndikte voorbij het eindpunt uit.

De klasse bevat ook NotDefined, wat betekent dat er geen cap‑stijl expliciet is toegewezen.

Caps verschillen van pijlpuntjes, die symbolen aan de lijneinden toevoegen, en van joins, die hoeken tussen lijnsegmenten regelen. Dit voorbeeld schakelt pijlpuntjes uit via ILineFormat.setBeginArrowheadStyle en ILineFormat.setEndArrowheadStyle, zodat alleen de cap‑vormen worden vergeleken.

Het volgende voorbeeld maakt drie verder identieke horizontale lijnen, 20 punten breed. Van boven naar beneden gebruiken ze platte, ronde en vierkante caps. Hun eindpunten hebben dezelfde horizontale coördinaten; de ronde en vierkante caps strekken zich 10 punten buiten elk eindpunt uit.

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

Het resultaat in PowerPoint, van boven naar beneden: Flat, Round, en Square.

Flat, round, and square caps on identical thick lines in PowerPoint

Schets‑effecten toepassen op vormlijnen

Een schets‑effect geeft een vormlijn een handgetekende uitstraling. Gebruik IShape.getLineFormat om de lijninstellingen te benaderen, ILineFormat.getSketchFormat om de schetstinstellingen te benaderen, en ISketchFormat.setSketchType om een waarde uit de klasse LineSketchType te selecteren.

De volgende Java‑code laat zien hoe u een LineSketchType.Curved effect toepast, de expliciet toegewezen waarde uitleest, en het effect verwijdert met 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();
}

De waarde die wordt geretourneerd door ISketchFormat.getSketchType vertegenwoordigt de instelling die direct aan de vorm is toegewezen. Als de lijnformattering kan worden geërfd van een thema, masterslide of layout‑slide, gebruik dan ILineFormat.getEffective, benader ILineFormatEffectiveData.getSketchFormat, en lees ISketchFormatEffectiveData.getSketchType. De effectieve waarde weerspiegelt de formattering die daadwerkelijk wordt toegepast na het oplossen van de erfenis. Dit voorbeeld vereist een bestaande presentatie met minstens één vorm op de eerste dia en geeft beide waarden weer:

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

Join‑stijlen formatteren

Hier zijn de drie opties voor join‑type:

  • Round
  • Miter
  • Bevel

De join‑stijl bepaalt hoe twee omtreksegmenten elkaar op een hoek ontmoeten. Gebruik Round voor ronde hoeken, Miter voor scherpe hoeken, of Bevel voor afgevlakte hoeken.

The join style in the presentation

Dit voorbeeld maakt drie zwarte rechthoeken met blauwe omtrekken van 15 punten breed. Het gebruikt ILineFormat.setJoinStyle om respectievelijk de miter, bevel en round waarden van LineJoinStyle toe te passen, om te vergelijken hoe de hoeken worden getekend.

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

Miter‑joins beperken bij scherpe hoeken

Gebruik ILineFormat.setMiterLimit samen met ILineFormat.setJoinStyle ingesteld op LineJoinStyle.Miter om te beperken hoe ver een scherpe hoek mag uitsteken.

De limiet is een verhouding tussen de afstand van de binnen‑ naar buitenhoek van de join en de lijndikte. Bijvoorbeeld, een waarde van 8 staat een miter‑lengte toe tot acht keer de lijndikte; het is geen meting in punten. Als de hoek de limiet zou overschrijden, gebruikt PowerPoint een bevel‑join op die hoek. Een grotere limiet maakt scherpere punten mogelijk. Deze instelling beïnvloedt alleen miter‑joins, en heeft geen zichtbaar effect wanneer de hoek binnen beide limieten blijft.

Dit voorbeeld maakt twee identieke, niet‑gevulde driehoeken met omtrekken van 20 punten breed. De linkse driehoek gebruikt een limiet van 2, de rechtse 8. Elke driehoek is 80 punten breed en 160 punten hoog, waardoor de verhouding miter‑lengte‑tot‑lijndikte van de bovenste hoek ongeveer 4.12 is. Hierdoor bevelt PowerPoint de linkse top en behoudt de rechter top.

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

Het resultaat in PowerPoint: Miter limit 2 links en miter limit 8 rechts.

A beveled apex with miter limit 2 and a pointed apex with miter limit 8 in PowerPoint

Verloop‑vulling

Een verloop‑vulling mengt kleuren over een vorm. Dit voorbeeld vult een ellips met een lineair verloop onder een hoek van 45 graad van rood naar paars via IFillFormat.getGradientFormat. De methode IGradientStopCollection.addPresetColor plaatst de kleurstops op 0 en 1, het begin en einde van het verloop. Het wissen van de bestaande stops zorgt ervoor dat alleen deze twee kleuren worden gebruikt.

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

Het resultaat:

The ellipse with gradient fill

Als een verloop er anders uitziet in een geëxporteerde afbeelding dan in PowerPoint, zie dan Choose a Gradient Rendering Style. U kunt een render‑stijl kiezen zonder de verloop‑vulling die in de presentatie is opgeslagen te wijzigen.

Lineair verloop‑hoek instellen

Gebruik IGradientFormat.setLinearGradientAngle om de oriëntatie van een GradientShape.Linear vulling te beheersen. De hoek wordt gemeten in graden en neemt met de klok mee toe: 0 loopt van links naar rechts, 90 van boven naar beneden, 180 van rechts naar links, en 270 van onder naar boven. Brachiale hoeken worden ondersteund. Eindige hoeken buiten [0, 360) worden genormaliseerd tot één omwenteling; bijvoorbeeld -45 wordt 315 en 360 wordt 0.

Dit voorbeeld maakt zes rechthoeken met identieke rode, groene en blauwe stops op posities 0, 0.5 en 1. Schalen is uitgeschakeld zodat de hoek onafhankelijk van de verhoudingen van de rechthoeken kan worden vergeleken. De hoeken, van links naar rechts, zijn 0, 45 en 90 in de eerste rij, en 135, 180 en 270 in de tweede rij.

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

Het resultaat in PowerPoint:

Linear gradients at 0, 45, and 90 degrees in the top row, and 135, 180, and 270 degrees in the bottom row

Lineair verloop schalen met de vorm

IGradientFormat.setLinearGradientScaled accepteert een NullableBool waarde. Stel deze expliciet in op False om de geometrische verloop‑hoek te behouden wanneer de verhoudingen van de vorm veranderen, of op True om het verloop te schalen met de breedte en hoogte van de vorm. Met schalen ingeschakeld kan de zichtbare hoek afwijken van de toegewezen hoek bij een niet‑vierkante vorm.

Het volgende voorbeeld gebruikt een hoek van 45 graden en dezelfde kleurstops als bij de hoek‑vergelijking. De linkerkolom gebruikt False; de rechterkolom gebruikt True. Elke kolom bevat een brede rechthoek boven een hoge rechthoek. Beide beginnen met dezelfde brede afmetingen; het wijzigen van breedte en hoogte van de tweede rechthoek toont hoe de vulling reageert op het aanpassen van de grootte zonder de verloop‑instellingen te veranderen.

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

Het resultaat in PowerPoint, met schalen uitgeschakeld links en ingeschakeld rechts:

Wide and tall rectangles with a 45-degree gradient, comparing LinearGradientScaled False on the left with True on the right

Met schalen uitgeschakeld behouden de diagonale kleurbanden dezelfde oriëntatie in beide rechthoeken. Met schalen ingeschakeld worden de banden uitgerekt met de vormverhoudingen. Dit helpt om een sjabloon‑verloop te reproduceren bij het aanpassen van een vorm naar een andere grootte. Op een vierkante vorm verandert het inschakelen van schalen de weergave van dit 45‑graden verloop niet.

Zowel de hoek‑ als de schaalinstellingen gelden voor lineaire verlopen. Ze regelen geen GradientShape.Radial of GradientShape.Rectangle vullingen.

Hoek combineren met verloop‑richting

IGradientFormat.setGradientDirection selecteert een verloop‑stijl uit de klasse GradientDirection; het is geen vervanging voor een numerieke hoek. Voor een lineair verloop kunnen de hoek‑stijlen het gebied waarin kleuren worden verdeeld wijzigen zonder de via setLinearGradientAngle toegewezen hoek te veranderen. Houd de richting ongewijzigd bij het vergelijken van hoeken of schalen.

Het volgende voorbeeld past dezelfde instellingen toe in omgekeerde volgorde. De twee rechthoeken zien er identiek uit: de richting vóór of na de hoek instellen verandert het resultaat niet.

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

Patroon‑vulling

Een patroon‑vulling past een tweekleurig ontwerp toe, zoals stippen, strepen of geruite patronen. Dit voorbeeld gebruikt IPatternFormat.setPatternStyle om een trellis‑patroon te selecteren. IPatternFormat.getBackColor levert de lichtgrijze achtergrond, en IPatternFormat.getForeColor levert de gele patroonkleur.

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

Het resultaat:

The rectangle with pattern fill

Afbeeldings‑vulling

Een afbeelding‑vulling gebruikt een afbeelding binnen een vorm. Dit voorbeeld vereist een lokale afbeelding en laadt deze via Images.fromFile in de afbeeldingscollectie van de presentatie. Het instellen van IPictureFillFormat.setPictureFillMode op de tegel‑modus herhaalt de afbeelding binnen de rechthoek. De gebruikte bronafbeelding wordt hieronder getoond:

The lotus picture

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

Het resultaat:

The shape with picture fill

Afbeelding als tegel‑textuur

Wilt u een getegelde afbeelding als textuur instellen en het tegelen aanpassen, dan kunt u de volgende methoden van de interface IPictureFillFormat en de klasse PictureFillFormat gebruiken:

  • setPictureFillMode: Stelt de afbeelding‑vullingsmodus in — Tile of Stretch.
  • setTileAlignment: Bepaalt de uitlijning van de tegels binnen de vorm.
  • setTileFlip: Regelt of de tegel horizontaal, verticaal of beide keren wordt gespiegeld.
  • setTileOffsetX: Stelt de horizontale offset van de tegel (in punten) ten opzichte van de oorsprong van de vorm in.
  • setTileOffsetY: Stelt de verticale offset van de tegel (in punten) ten opzichte van de oorsprong van de vorm in.
  • setTileScaleX: Definieert de horizontale schaal van de tegel als percentage.
  • setTileScaleY: Definieert de verticale schaal van de tegel als percentage.

Dit voorbeeld vereist een lokale afbeelding en configureert IPictureFillFormat om deze op 50 % van de oorspronkelijke grootte te herhalen. Offsets van −32 punten verschuiven de tegels horizontaal en verticaal; onder‑recht‑uitlijning en dubbels spiegelen bepalen hoe de herhaalde textuur wordt gerangschikt.

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

Het resultaat:

The tile options

Éénkleurige vulling

Een éénkleurige vulling geeft een vorm een enkele, uniforme kleur. Dit voorbeeld gebruikt IFillFormat.setFillType om de éénkleurige vullingsmodus te selecteren en kent geel toe via IFillFormat.getSolidFillColor, waarna de rechthoek in een presentatie wordt opgeslagen.

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

Het resultaat:

The shape with solid color fill

Kleuren kopiëren met behoud van themareferenties

Gebruik IColorFormat.copyFrom om een kleurobject te kopiëren, inclusief het kleurtype, themareferentie en transformaties. Dit is handig wanneer een vulkleur tussen vormen moet worden overgedragen en toch het thema van de presentatie moet blijven volgen. De methode kopieert alleen de kleur; hij kopieert niet het vultype, de omtrek of andere vormformattering. Stel het doel‑vultype expliciet in met IFillFormat.setFillType.

Dit voorbeeld maakt drie rechthoeken, van links naar rechts: de bron, een thema‑bewuste kopie, en een vaste RGB‑kopie. De bron gebruikt IColorFormat.setSchemeColor om te verwijzen naar de eerste accentkleur en voegt een tint toe via IColorOperationCollection.add. De RGB‑kopie gebruikt de effectieve vulkleur van de bron zodat alle drie aanvankelijk identiek lijken. Het aanroepen van IColorFormat.setColor stelt een vaste RGB‑waarde in en wist eventuele bestaande kleurtransformaties.

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

    // Themaverwijzingen volgen de nieuwe accentkleur; de vaste RGB‑waarde niet.
    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();
}

Voor de themawijziging kwamen alle drie de vullingen overeen:

Source, copyFrom destination, and fixed RGB destination with identical blue fills

Na de themawijziging blijven de bron en de thema‑bewuste kopie de nieuwe accentkleur volgen en hun tint behouden. De vaste RGB‑kopie blijft blauw:

Source and copyFrom destination with orange fills, while the fixed RGB destination remains blue

De gekopieerde definitie is onafhankelijk van de bron. Een latere wijziging van de themareferentie van de bron, het toewijzen van een andere kleur, of het toevoegen of verwijderen van transformaties verandert het doel niet. Een themawijziging heeft nog steeds invloed op beide vormen omdat elke vorm apart naar dezelfde themakleur verwijst.

Opslaan en opnieuw openen van de PPTX behoudt het kleurtype dat wordt geretourneerd door IColorFormat.getColorType, de themareferentie en de transformatie‑collectie die wordt geretourneerd door IColorFormat.getColorTransform; het wordt niet naar RGB afgevlakt.

Bij het kopiëren tussen verschillende themacontexten, zoals presentaties met verschillende accentpaletten, wordt de gekopieerde referentie geëvalueerd ten opzichte van het themabestand van het doel. Dezelfde referentie en transformaties kunnen daardoor een andere zichtbare kleur opleveren. Zie Presentation Theme voor meer informatie over het configureren van themakleuren.

Achtergrond van de dia gebruiken als vormvulling

Gebruik IAutoShape.setUseBackgroundFill wanneer een vorm moet overeenkomen met de dia‑achtergrond, bijvoorbeeld in een presentatie‑sjabloon. Stel het vultype eerst in op FillType.NotDefined via IFillFormat.setFillType om eventuele expliciete vulling te verwijderen. Met deze combinatie gebruikt de vorm de dia‑achtergrond in plaats van de eigen stijl‑vulling. Alleen de vlag inschakelen verwijdert geen bestaande expliciete vulling.

Dit verschilt van FillType.NoFill: een achtergrondvulling bedekt objecten achter de vorm met het overeenkomstige gebied van de dia‑achtergrond, terwijl geen vulling die objecten zichtbaar laat. Een verloop blijft uitgelijnd met de dia in plaats van opnieuw te starten binnen elke vorm.

Het volgende voorbeeld maakt een master‑achtergrond die door de dia wordt geërfd en plaatst een magenta‑band achter drie rechthoeken. De linkse rechthoek gebruikt de achtergrond, de middelste heeft geen vulling, en de rechtse wisselt van achtergrondvulling naar een expliciete oranje vulling.

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

    // De gradient erven van de 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));

    // Voeg dit object eerst toe zodat het achter de rechthoeken verschijnt.
    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);

    // Schakel achtergrondvulling uit voordat een expliciete vulling wordt toegepast.
    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();
}

Het resultaat, van links naar rechts: background fill, no fill, en explicit fill. De magenta‑band wordt verborgen door de linkse en rechtse rechthoek, maar blijft zichtbaar door de middelste rechthoek.

Background fill, no fill, and explicit orange fill over a magenta band

Hetzelfde gedrag geldt voor een achtergrond die direct op de dia is gedefinieerd of van een lay‑out wordt geërfd. De vorm gebruikt de door de dia opgeloste achtergrond; het voorbeeld laat zowel de dia‑ als de lay‑out‑achtergronden ongedefinieerd zodat de master ze levert.

Transparantie instellen

Voor een éénkleurige vulling bepaalt de alfacomponent van de kleur de dekking: 0 is volledig transparant en 255 volledig ondoorzichtig. Dit voorbeeld gebruikt een alfa‑waarde van 128 voor een gele rechthoek, waardoor deze ongeveer 50 % transparant is zodat de onderliggende rechthoek zichtbaar blijft. De kleur wordt toegewezen 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();
}

Het resultaat:

The transparent shape

Vormen roteren

Gebruik IShape.setRotation om een vorm in het dia‑vlak te roteren. De hoek wordt gemeten in graden; dit voorbeeld roteert een rechthoek 5 graden met de klok mee en slaat de presentatie op.

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

Het resultaat:

The shape rotation

3D‑bevel‑effecten toevoegen

Gebruik IShape.getThreeDFormat om een vorm diepte en gefaseerde randen te geven. Dit voorbeeld maakt een groene ellips met een oranje omtrek, stelt de diepte in op 4 punten via IThreeDFormat.setDepth, en past een ronde bovenste bevel toe met een breedte en hoogte van 6 punten via IThreeDFormat.getBevelTop. Een front‑georiënteerde orthografische camera en drie‑punt verlichting maken het bevel zichtbaar.

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

Het resultaat:

The 3D bevel effect

3D‑rotatie‑effecten toevoegen

De 3D‑weergave van een vorm wordt gecontroleerd door de cameraparameters. Dit voorbeeld gebruikt ICamera.setRotation met breedte‑, lengte‑ en rotatiehoeken van respectievelijk 40, 35 en 20 graden. Het selecteert een isometrische camera via ICamera.setCameraType en gebalanceerde verlichting via ILightRig.setLightType, waarna de geformatteerde rechthoek wordt opgeslagen.

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

Het resultaat:

The 3D rotation effect

Zwart‑wit‑weergave voor vormen regelen

De methode IShape.setBlackWhiteMode geeft aan hoe een individuele vorm wordt weergegeven wanneer een presentatie in zwart‑wit‑modus wordt bekeken of verwerkt. De methode activeert niet zelf zwart‑wit‑weergave en verandert de vulling, omtrek of andere opmaak van de vorm niet in de normale kleurmodus.

Gebruik een waarde uit de klasse BlackWhiteMode om het gewenste gedrag te kiezen. Bijvoorbeeld, Automatic laat de weergave‑applicatie de conversie bepalen, Gray en LightGray gebruiken grijstinten, BlackWhite gebruikt alleen zwart en wit, Black en White dwingen een enkele kleur, Color behoudt normale kleuren, en Hidden sluit de vorm uit in zwart‑wit‑modus. NotDefined betekent dat er geen vorm‑specifieke modus is toegewezen.

Dit voorbeeld maakt een oranje rechthoek en gebruikt IShape.setBlackWhiteMode om grijze kleur te selecteren. De opgeslagen vorm behoudt zijn oranje vulling voor normale kleurweergave en vraagt grijze kleur aan applicaties die zwart‑wit‑instellingen respecteren:

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 de normale kleurmodus behoudt de rechthoek zijn oranje vulling. In een zwart‑wit‑workflow wordt grijze kleur toegepast omdat de modus op Gray staat. Zo kunt u een volledige‑kleur dia behouden en tegelijk een aparte weergave definiëren voor afdrukken, voorbeeldweergave of andere workflows die zwart‑wit‑instellingen honoreren.

Opmaak resetten

Gebruik ISlide.reset om de positie, grootte en opmaak van dia‑plaatsaanduidingen te herstellen vanuit de overeenkomstige lay‑out‑plaatsaanduidingen. Dit voorbeeld vereist een bestaande presentatie met lay‑out‑gekoppelde plaatsaanduidingen en reset elke dia vóór het opslaan. Vormen zonder overeenkomstige lay‑out‑plaatsaanduidingen worden niet gereset.

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

Beïnvloedt vormopmaak de uiteindelijke bestandsgrootte van de presentatie?

Kleuren, lijnstijlen en effectinstellingen voegen over het algemeen weinig data toe vergeleken met ingesloten afbeeldingen en media. Afbeeldings‑vullingen kunnen de bestandsgrootte vergroten omdat hun afbeeldingen in de presentatie worden opgeslagen.

Hoe kan ik vormen op een dia detecteren die identieke opmaak hebben, zodat ik ze kan groeperen?

Vergelijk de belangrijkste opmaak‑eigenschappen van elke vorm — vulling, lijn en effectinstellingen. Als alle overeenkomstige waarden overeenkomen, beschouw dan hun stijlen als identiek en groepeer die vormen logisch, wat later beheer van stijlen vereenvoudigt.

Kan ik een set aangepaste vormstijlen opslaan in een apart bestand voor hergebruik in andere presentaties?

Ja. Sla voorbeeldvormen met de gewenste stijlen op in een sjabloon‑presentatie of een .POTX‑sjabloonbestand. Bij het maken van een nieuwe presentatie opent u het sjabloon, kloont u de benodigde stijlvormen, en past u hun opmaak toe waar nodig.