Formatowanie kształtów PowerPoint na Androidzie
Wprowadzenie
Formatuj kształty w programie PowerPoint, dostosowując ich kontury, wypełnienia i efekty. Aspose.Slides for Android via Java umożliwia programowe sterowanie tymi ustawieniami, w tym przezroczystością, obrotem i formatowaniem 3D.

Aspose.Slides for Android via Java udostępnia interfejsy i metody, które pozwalają formatować kształty przy użyciu tych samych opcji, które są dostępne w programie PowerPoint.
Formatowanie linii
Użyj IShape.getLineFormat do kontrolowania konturu kształtu. Ten przykład tworzy nie wypełniony prostokąt z niebieskim, przerywanym konturem. ILineFormat.setStyle wybiera linię złożoną gruba-cienka, podczas gdy ILineFormat.setWidth ustawia jej szerokość na 7 punktów, a ILineFormat.setDashStyle wybiera wzór kreski.
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();
}
Wynik:

Ustawianie własnych wzorów przerywanych linii
Użyj ILineFormat.setCustomDashPattern w sytuacjach, gdy predefiniowane style linii nie zapewniają potrzebnych długości kresek i przerw, na przykład dla znaków firmowych lub diagramów technicznych. Przypisanie wzoru automatycznie zmienia styl przerywania linii na LineDashStyle.Custom.
Wpisy w tablicy naprzemiennie określają długość kreski i przerwy, zaczynając od kreski. Każda wartość jest wielokrotnością szerokości linii: { 4, 2 } przy szerokości 3 punktów daje kreskę o długości 12 punktów i przerwę 6 punktów. Używaj par wartości skończonych i nieujemnych, aby zdefiniować pełne segmenty kreska‑przerwa. Przykład używa wartości dodatnich, aby każda kreska i przerwa były widoczne.
Ten przykład tworzy pięć niebieskich linii o tej samej długości i płaskich zakończeniach. Pierwsze trzy porównują wzorce przy szerokości 3 punktów. Czwarta powtarza pierwszy wzorzec przy dwukrotnie większej szerokości, podwajając zarówno długość kreski, jak i przerwy. Piąta przełącza się z własnego wzoru na linię ciągłą.
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]);
}
// Przywróć ostatnią linię do stylu ciągłego.
slide.getShapes().get_Item(4).getLineFormat().setDashStyle(LineDashStyle.Solid);
presentation.save("custom_dash_patterns.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Aby wrócić do predefiniowanego stylu przerywanego, przekaż LineDashStyle.Dash do ILineFormat.setDashStyle. Wybrany styl kontroluje wygląd linii.
Wynik w programie PowerPoint, od góry do dołu: {4, 2}, 3 pt; {1, 2}, 3 pt; {6, 2, 1, 2}, 3 pt; {4, 2}, 6 pt; oraz Solid, 3 pt.

Ustawianie zakończeń linii
Użyj ILineFormat.setCapStyle aby ustawić końcówki otwartej linii. Klasa LineCapStyle udostępnia trzy wyraźne style zakończeń:
Flat: Pędzel zatrzymuje się na końcowym punkcie.Round: Półokrągłe zakończenie wystaje poza punkt końcowy o połowę szerokości linii.Square: Kwadratowe zakończenie wystaje poza punkt końcowy o połowę szerokości linii.
Klasa zawiera również NotDefined, co oznacza, że nie przypisano wyraźnego stylu zakończenia.
Zakończenia różnią się od grotów, które dodają symbole do końcówek linii, oraz połączeń, które kontrolują rogi pomiędzy odcinkami linii. Ten przykład wyłącza groty za pomocą ILineFormat.setBeginArrowheadStyle i ILineFormat.setEndArrowheadStyle, aby porównać jedynie kształty zakończeń.
Poniższy przykład tworzy trzy identyczne poziome linie, szerokie na 20 punktów. Od góry do dołu używają zakończeń płaskiego, okrągłego i kwadratowego. Ich końcowe punkty mają te same współrzędne poziome; zakończenia okrągłe i kwadratowe wystają o 10 punktów poza każdy koniec.
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();
}
Wynik w programie PowerPoint, od góry do dołu: Flat, Round i Square.

Zastosowanie efektu szkicu do linii kształtu
Efekt szkicu sprawia, że linia kształtu wygląda na ręcznie rysowaną. Użyj IShape.getLineFormat aby uzyskać dostęp do ustawień linii, ILineFormat.getSketchFormat aby uzyskać dostęp do ustawień szkicu oraz ISketchFormat.setSketchType aby wybrać wartość z klasy LineSketchType.
Poniższy kod Java pokazuje, jak zastosować efekt LineSketchType.Curved, odczytać przypisaną wartość i usunąć efekt za pomocą 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();
}
Wartość zwracana przez ISketchFormat.getSketchType reprezentuje ustawienie przypisane bezpośrednio do kształtu. Jeśli formatowanie linii może być dziedziczone z motywu, slajdu‑mistrza lub slajdu‑układu, użyj ILineFormat.getEffective, uzyskaj dostęp do ILineFormatEffectiveData.getSketchFormat, a następnie odczytaj ISketchFormatEffectiveData.getSketchType. Wartość efektywna odzwierciedla formatowanie rzeczywiście zastosowane po rozwiązaniu dziedziczenia. Ten przykład wymaga istniejącej prezentacji z przynajmniej jednym kształtem na pierwszym slajdzie i wypisuje obie wartości:
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();
}
Formatowanie stylów połączeń
Oto trzy dostępne opcje typu połączenia:
- Round
- Miter
- Bevel
Styl połączenia kontroluje, w jaki sposób dwa odcinki konturu łączą się w rogu. Użyj Round dla zaokrąglonych rogów, Miter dla ostrych rogów lub Bevel dla spłaszczonych rogów.

Ten przykład tworzy trzy czarne prostokąty z niebieskimi konturami o szerokości 15 punktów. Używa ILineFormat.setJoinStyle aby zastosować kolejno wartości miter, bevel i round z klasy LineJoinStyle, aby porównać, jak rysowane są rogi.
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();
}
Ograniczanie połączeń miter przy ostrych rogach
Użyj ILineFormat.setMiterLimit razem z ILineFormat.setJoinStyle ustawionym na LineJoinStyle.Miter, aby ograniczyć, jak daleko ostry róg może wystawać.
Limit jest stosunkiem odległości między wewnętrznym a zewnętrznym rogiem połączenia do szerokości linii. Na przykład wartość 8 pozwala na długość miteru do ośmiokrotności szerokości linii; nie jest to miara w punktach. Jeśli róg przekroczyłby limit, PowerPoint użyje połączenia spłaszczonego w tym miejscu. Większy limit umożliwia ostrzejsze punkty. Ustawienie wpływa tylko na połączenia miter; zmiana go nie daje widocznego efektu, gdy róg pozostaje w granicach obu limitów.
Ten przykład tworzy dwa identyczne, nie wypełnione trójkąty o konturach szerokich na 20 punktów. Lewy trójkąt używa limitu 2, a prawy 8. Każdy trójkąt ma szerokość 80 punktów i wysokość 160 punktów, co daje stosunek długości miteru do szerokości linii w górnym rogu w przybliżeniu 4,12. W konsekwencji PowerPoint spłaszcza lewy wierzchołek i zachowuje prawy.
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();
}
Wynik w programie PowerPoint: Miter limit 2 po lewej i miter limit 8 po prawej.

Wypełnienie gradientowe
Wypełnienie gradientowe miesza kolory w obrębie kształtu. Ten przykład wypełnia elipsę gradientem liniowym pod kątem 45 stopni od czerwieni do fioletu przy użyciu IFillFormat.getGradientFormat. Metoda IGradientStopCollection.addPresetColor umieszcza przystanki koloru na pozycjach 0 i 1, czyli na początku i końcu gradientu. Usunięcie istniejących przystanków zapewnia, że użyte zostaną tylko te dwa kolory.
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();
}
Wynik:

Jeśli gradient wygląda inaczej w wyeksportowanym obrazie niż w programie PowerPoint, zobacz Choose a Gradient Rendering Style. Możesz wybrać styl renderowania bez zmiany gradientu przechowywanego w prezentacji.
Ustaw kąt gradientu liniowego
Użyj IGradientFormat.setLinearGradientAngle aby kontrolować orientację wypełnienia GradientShape.Linear. Kąt mierzony jest w stopniach i rośnie zgodnie z ruchem wskazówek zegara: 0 biegnie od lewej do prawej, 90 od góry do dołu, 180 od prawej do lewej, a 270 od dołu do góry. Obsługiwane są kąty ułamkowe. Kąty spoza zakresu [0, 360) są normalizowane do jednej pełnej rotacji; na przykład -45 staje się 315, a 360 staje się 0.
Ten przykład tworzy sześć prostokątów z identycznymi przystankami koloru czerwonego, zielonego i niebieskiego w pozycjach 0, 0,5 i 1. Skalowanie jest wyłączone, aby kąt mógł być porównywany niezależnie od proporcji prostokątów. Kąty, od lewej do prawej, to 0, 45 i 90 w pierwszym rzędzie oraz 135, 180 i 270 w drugim rzędzie.
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();
}
Wynik w programie PowerPoint:

Skalowanie gradientu liniowego wraz z kształtem
IGradientFormat.setLinearGradientScaled przyjmuje wartość NullableBool. Ustaw ją explicite na False, aby zachować geometryczny kąt gradientu przy zmianie proporcji kształtu, lub na True, aby skalować gradient wraz z szerokością i wysokością kształtu. Przy włączonej skali widoczny kąt może różnić się od przypisanego kąta w przypadku nie‑kwadratowego kształtu.
Poniższy przykład używa kąta 45 stopni oraz tych samych przystanków koloru co porównanie kątów. Lewa kolumna używa False; prawa True. Każda kolumna zawiera szeroki prostokąt nad wysokim prostokątem. Oba zaczynają się od tych samych szerokich wymiarów; zmiana szerokości i wysokości drugiego prostokąta demonstruje, jak wypełnienie reaguje na zmianę rozmiaru bez zmiany ustawień gradientu.
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();
}
Wynik w programie PowerPoint, przy wyłączonej skali po lewej i włączonej po prawej:

Przy wyłączonej skali przekątne pasma kolorów zachowują tę samą orientację w obu prostokątach. Przy włączonej skali pasma rozciągają się wraz z proporcjami kształtu. Pomaga to odtworzyć gradient szablonu podczas dostosowywania kształtu do innego rozmiaru. Na kwadracie włączenie skalowania nie zmienia wyglądu tego gradientu pod kątem 45 stopni.
Zarówno kąt, jak i ustawienie skalowania mają zastosowanie do gradientów liniowych. Nie kontrolują one wypełnień GradientShape.Radial or GradientShape.Rectangle.
Połączenie kąta ze stroną gradientu
IGradientFormat.setGradientDirection wybiera styl gradientu z klasy GradientDirection; nie jest to zamiennik kąta numerycznego. Dla gradientu liniowego style stron mogą zmienić obszar, na którym kolory są rozmieszczone, bez zmiany kąta przypisanego poprzez setLinearGradientAngle. Zachowaj niezmienioną stronę przy porównywaniu kątów lub skalowaniu.
Poniższy przykład stosuje te same ustawienia w odwrotnej kolejności. Dwa prostokąty mają ten sam wygląd: ustawienie strony przed lub po kącie nie zmienia wyniku.
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();
}
Wypełnienie wzorcem
Wypełnienie wzorcem nakłada dwukolorowy wzór, taki jak kropki, paski lub szachownica. Ten przykład używa IPatternFormat.setPatternStyle aby wybrać wzór kratowy. IPatternFormat.getBackColor dostarcza jasnoszare tło, a IPatternFormat.getForeColor dostarcza żółty kolor wzoru.
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();
}
Wynik:

Wypełnienie obrazem
Wypełnienie obrazem używa obrazu wewnątrz kształtu. Ten przykład wymaga lokalnego obrazu i używa Images.fromFile aby załadować go do kolekcji obrazów prezentacji. Ustawienie IPictureFillFormat.setPictureFillMode na tryb kafelkowy powiela obraz w obrębie prostokąta. Poniżej pokazano używany obraz źródłowy:

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

Kafelkowanie obrazu jako tekstury
Jeśli chcesz ustawić obraz kafelkowany jako teksturę i dostosować zachowanie kafelkowania, możesz użyć następujących metod interfejsu IPictureFillFormat oraz klasy PictureFillFormat:
- setPictureFillMode: Ustawia tryb wypełnienia obrazu —
TilelubStretch. - setTileAlignment: Określa wyrównanie kafelków wewnątrz kształtu.
- setTileFlip: Kontroluje, czy kafelek jest odbity poziomo, pionowo, czy w obu kierunkach.
- setTileOffsetX: Ustawia poziomy offset kafelka (w punktach) od początku kształtu.
- setTileOffsetY: Ustawia pionowy offset kafelka (w punktach) od początku kształtu.
- setTileScaleX: Definiuje poziomą skalę kafelka jako procent.
- setTileScaleY: Definiuje pionową skalę kafelka jako procent.
Ten przykład wymaga lokalnego obrazu i konfiguruje IPictureFillFormat aby powielał go w 50 % pierwotnego rozmiaru. Offsety –32 punkty przesuwają kafelki poziomo i pionowo; wyrównanie w prawym dolnym rogu oraz odbicie w obu kierunkach określają, jak powtarzana tekstura jest rozmieszczona.
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();
}
Wynik:

Wypełnienie kolorem stałym
Wypełnienie stałe nadaje kształtowi jednorodny kolor. Ten przykład używa IFillFormat.setFillType aby wybrać tryb wypełnienia stałego i przypisuje żółty kolor poprzez IFillFormat.getSolidFillColor, a następnie zapisuje prostokąt w prezentacji.
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();
}
Wynik:

Kopiowanie kolorów przy zachowaniu odwołań do motywu
Użyj IColorFormat.copyFrom aby skopiować definicję koloru, w tym jego typ, odwołanie do motywu i transformacje. Jest to przydatne przy przenoszeniu koloru wypełnienia pomiędzy kształtami, które powinny nadal podążać za motywem prezentacji. Metoda kopiuje jedynie kolor: nie kopiuje typu wypełnienia, konturu ani innych formatowań kształtu. Ustaw typ wypełnienia docelowego wyraźnie przy pomocy IFillFormat.setFillType.
Ten przykład tworzy trzy prostokąty, od lewej do prawej: źródło, kopię uwzględniającą motyw oraz stałą kopię RGB. Źródło używa IColorFormat.setSchemeColor aby odwołać się do pierwszego koloru akcentu i dodaje odcień przy pomocy IColorOperationCollection.add. Kopia RGB używa efektywnego koloru wypełnienia źródła, więc wszystkie trzy początkowo wyglądają identycznie. Wywołanie IColorFormat.setColor ustawia stałą wartość RGB i usuwa istniejące transformacje koloru.
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();
}
// Odwołania do motywu podążają za nowym kolorem akcentu; stała wartość RGB nie podąża.
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();
}
Przed zmianą motywu wszystkie trzy wypełnienia są takie same:

Po zmianie motywu źródło i kopia uwzględniająca motyw podążają za nowym kolorem akcentu i zachowują odcień. Stała kopia RGB pozostaje niebieska:

Skopiowana definicja jest niezależna od źródła. Kolejna zmiana odwołania do motywu w źródle, przypisanie innego koloru lub dodanie/usunięcie jego transformacji nie wpływa na docelowy kształt. Zmiana motywu nadal wpływa na oba kształty, ponieważ każdy z nich niezależnie odwołuje się do tego samego koloru motywu.
Zapis i ponowne otwarcie pliku PPTX zachowuje typ skopiowanego koloru zwracany przez IColorFormat.getColorType, odwołanie do motywu oraz kolekcję transformacji zwracanych przez IColorFormat.getColorTransform; nie spłaszcza definicji do RGB.
Podczas kopiowania między różnymi kontekstami motywu, takimi jak prezentacje z innymi paletami akcentów, skopiowane odwołanie jest rozwiązywane względem motywu docelowego. To samo odwołanie i transformacje mogą więc dawać inny widoczny kolor. Zobacz Presentation Theme po więcej informacji o konfigurowaniu kolorów motywu.
Użycie tła slajdu jako wypełnienia kształtu
Użyj IAutoShape.setUseBackgroundFill gdy kształt ma dopasować się do tła slajdu, na przykład w szablonie prezentacji. Najpierw ustaw typ wypełnienia przy pomocy IFillFormat.setFillType na FillType.NotDefined, aby usunąć jakiekolwiek wyraźne wypełnienie. Dzięki tej kombinacji kształt używa tła slajdu zamiast swojego własnego wypełnienia. Samo włączenie flagi nie usuwa istniejącego wyraźnego wypełnienia.
Różni się to od FillType.NoFill: wypełnienie tła zasłania obiekty znajdujące się za kształtem, wypełniając odpowiedni obszar tłem slajdu, natomiast brak wypełnienia pozostawia te obiekty widoczne. Gradient pozostaje wyrównany do slajdu, zamiast rozpoczynać się wewnątrz każdego kształtu.
Poniższy przykład tworzy tło mistrza dziedziczone przez slajd i umieszcza magentowy pasek za trzema prostokątami. Lewy prostokąt używa tła, środkowy nie ma wypełnienia, a prawy przełącza się z wypełnienia tła na wyraźne pomarańczowe wypełnienie.
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);
// Dziedzicz gradient z mastera.
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));
// Dodaj ten obiekt najpierw, aby pojawił się za prostokątami.
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);
// Wyłącz wypełnienie tłem przed zastosowaniem wyraźnego wypełnienia.
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();
}
Wynik, od lewej do prawej: wypełnienie tłem, brak wypełnienia i wyraźne wypełnienie. Magentowy pasek jest ukryty przez lewy i prawy prostokąt, ale pozostaje widoczny przez środkowy prostokąt.

To samo zachowanie dotyczy tła zdefiniowanego bezpośrednio na slajdzie lub dziedziczonego z układu. Kształt używa rozwiązanego tła slajdu; w przykładzie zarówno tło slajdu, jak i układu pozostawiono niezdefiniowane, aby dostarczyć je z mistrza.
Ustawianie przezroczystości
W przypadku wypełnienia stałego przezroczystość kontroluje składnik alfa koloru: 0 oznacza pełną przezroczystość, a 255 pełną nieprzezroczystość. Ten przykład używa wartości alfa 128 dla żółtego prostokąta, co czyni go w przybliżeniu w 50 % przezroczystym, tak aby prostokąt pod spodem pozostał widoczny. Kolor jest przypisany za pomocą 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();
}
Wynik:

Obrót kształtów
Użyj IShape.setRotation aby obrócić kształt w płaszczyźnie slajdu. Kąt mierzony jest w stopniach; ten przykład obraca prostokąt o 5 stopni zgodnie z ruchem wskazówek zegara i zapisuje prezentację.
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();
}
Wynik:

Dodawanie efektów 3D bevel
Użyj IShape.getThreeDFormat aby nadać kształtowi głębię i wyraźne krawędzie. Ten przykład tworzy zieloną elipsę z pomarańczowym konturem, używa IThreeDFormat.setDepth aby ustawić głębokość na 4 punkty oraz stosuje górny bevel o szerokości i wysokości 6 punktów poprzez IThreeDFormat.getBevelTop. Front‑facing orthographic camera i oświetlenie trójpunktowe uwidaczniają bevel.
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();
}
Wynik:

Dodawanie efektów obrotu 3D
Widok 3D kształtu kontrolowany jest przez ustawienia kamery. Ten przykład używa ICamera.setRotation z kątami szerokości geograficznej, długości geograficznej i obrotu równymi odpowiednio 40°, 35° i 20°. Wybiera kamerę izometryczną przy pomocy ICamera.setCameraType oraz zrównoważone oświetlenie przy pomocy ILightRig.setLightType, a następnie zapisuje sformatowany prostokąt.
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();
}
Wynik:

Kontrola renderowania czarno‑białego dla kształtów
Metoda IShape.setBlackWhiteMode określa, jak pojedynczy kształt jest renderowany, gdy prezentacja jest wyświetlana lub przetwarzana w trybie czarno‑białym. Nie włącza ona samego trybu czarno‑białego i nie zmienia wypełnienia, linii ani innych formatowań kształtu w normalnym trybie kolorowym.
Użyj wartości z klasy BlackWhiteMode aby wybrać pożądane zachowanie. Na przykład Automatic pozwala aplikacji renderującej wybrać konwersję, Gray i LightGray używają odcieni szarości, BlackWhite używa wyłącznie czerni i bieli, Black i White wymuszają jednolity kolor, Color zachowuje normalne kolorowanie, a Hidden pomija kształt w trybie czarno‑białym. NotDefined oznacza, że nie przypisano trybu na poziomie kształtu.
Ten przykład tworzy pomarańczowy prostokąt i używa IShape.setBlackWhiteMode aby wybrać szare kolorowanie. Zapisany kształt zachowuje pomarańczowe wypełnienie w normalnym trybie kolorowym i żąda szarego kolorowania od aplikacji, które honorują ustawienia wyświetlania czarno‑białego:
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();
}
W normalnym trybie kolorowym prostokąt zachowuje pomarańczowe wypełnienie. W przepływie pracy czarno‑białego używa szarego kolorowania, ponieważ jego tryb jest ustawiony na Gray. Pozwala to zachować pełnokolorowy slajd, definiując jednocześnie odrębny wygląd dla druku, podglądu lub innych przepływów pracy respektujących ustawienia czarno‑białego wyświetlania prezentacji.
Resetowanie formatowania
Użyj ISlide.reset aby przywrócić pozycję, rozmiar i formatowanie symboli slajdu z ich odpowiadających symboli układu. Ten przykład wymaga istniejącej prezentacji z symbolami połączonymi z układem i resetuje każdy slajd przed zapisem. Kształty bez odpowiadających symboli układu nie są resetowane.
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
Czy formatowanie kształtu wpływa na ostateczny rozmiar pliku prezentacji?
Kolory, style linii i ustawienia efektów zazwyczaj dodają niewiele danych w porównaniu z osadzonymi obrazami i multimediami. Wypełnienia obrazem mogą zwiększyć rozmiar pliku, ponieważ ich obrazy są przechowywane w prezentacji.
Jak mogę wykryć kształty na slajdzie, które mają identyczne formatowanie, aby je pogrupować?
Porównaj kluczowe właściwości formatowania każdego kształtu — wypełnienie, linia i ustawienia efektów. Jeśli wszystkie odpowiadające sobie wartości się zgadzają, potraktuj ich style jako identyczne i logicznie pogrupuj te kształty, co upraszcza późniejsze zarządzanie stylami.
Czy mogę zapisać zestaw niestandardowych stylów kształtów w osobnym pliku do ponownego użycia w innych prezentacjach?
Tak. Przechowuj przykładowe kształty z żądanymi stylami w szablonie prezentacji lub pliku szablonu .POTX. Tworząc nową prezentację, otwórz szablon, sklonuj potrzebne stylowe kształty i ponownie zastosuj ich formatowanie tam, gdzie jest to wymagane.