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

Aspose.Slides for Python via Java zapewnia klasy i metody, które pozwalają formatować kształty przy użyciu tych samych opcji dostępnych w programie PowerPoint.
Formatuj linie
Użyj Shape.getLineFormat, aby kontrolować obrys kształtu. Ten przykład tworzy prostokąt bez wypełnienia z niebieskim, przerywanym obrysem. LineFormat.setStyle wybiera złożoną linię grubą-cienką, natomiast LineFormat.setWidth ustawia jej szerokość na 7 punktów, a LineFormat.setDashStyle wybiera wzór kreski.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, LineDashStyle, LineStyle, Presentation, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
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:

Ustaw niestandardowe wzory kresk linii
Użyj LineFormat.setCustomDashPattern, gdy wstępnie zdefiniowane style linii nie oferują wymaganych długości kresek i przerw, na przykład dla oznakowanych obrysów lub diagramów technicznych. Przypisanie wzoru automatycznie zmienia styl kreski linii na LineDashStyle.Custom.
Elementy tablicy naprzemiennie określają długości kresek i przerw, 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, po której następuje przerwa 6 punktów. Używaj par skończonych, nieujemnych wartości, aby zdefiniować pełne segmenty kreska-przerwa. W przykładzie użyto 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ą wzory przy szerokości 3 punktów. Czwarta powtarza pierwszy wzór przy dwukrotnie większej szerokości, podwajając zarówno długości kresek, jak i przerw. Piąta przełącza się z niestandardowego wzoru na linię ciągłą.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, LineArrowheadStyle, LineCapStyle, LineDashStyle, Presentation, SaveFormat, ShapeType, SlideSizeScaleType
from java.awt import Color
presentation = Presentation()
try:
presentation.getSlideSize().setSize(600, 300, SlideSizeScaleType.DoNotScale)
slide = presentation.getSlides().get_Item(0)
patterns = [
[4, 2],
[1, 2],
[6, 2, 1, 2],
[4, 2],
[4, 2]
]
for i, pattern in enumerate(patterns):
line = slide.getShapes().addAutoShape(ShapeType.Line, 50, 50 + i * 50, 500, 0)
line.getLineFormat().setWidth(6 if i == 3 else 3)
line.getLineFormat().getFillFormat().setFillType(FillType.Solid)
color = Color(0, 0, 139)
line.getLineFormat().getFillFormat().getSolidFillColor().setColor(color)
line.getLineFormat().setCapStyle(LineCapStyle.Flat)
line.getLineFormat().setBeginArrowheadStyle(LineArrowheadStyle.None_)
line.getLineFormat().setEndArrowheadStyle(LineArrowheadStyle.None_)
line.getLineFormat().setCustomDashPattern(jpype.JArray(jpype.JFloat)(pattern))
# 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 zamiast tego wrócić do wstępnie zdefiniowanego stylu przerywanego, przekaż LineDashStyle.Dash do LineFormat.setDashStyle. Wybrany styl kontroluje wygląd linii.
Wynik w 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.

Ustaw zakończenia linii
Użyj LineFormat.setCapStyle, aby ustawić zakończenia 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 także NotDefined, co oznacza, że nie przypisano wyraźnie stylu zakończenia.
Zakończenia różnią się od grotów strzałek, które dodają symbole na końcach linii, oraz połączeń, które kontrolują rogi pomiędzy odcinkami linii. Ten przykład wyłącza groty strzałek za pomocą LineFormat.setBeginArrowheadStyle i LineFormat.setEndArrowheadStyle, aby porównać jedynie kształty zakończeń.
Poniższy przykład tworzy trzy w przeciwnym razie identyczne linie poziome o szerokości 20 punktów. Od góry do dołu używają zakończeń odpowiednio 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ą 10 punktów poza każdy punkt końcowy.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, LineArrowheadStyle, LineCapStyle, LineDashStyle, Presentation, SaveFormat, ShapeType, SlideSizeScaleType
from java.awt import Color
presentation = Presentation()
try:
presentation.getSlideSize().setSize(500, 240, SlideSizeScaleType.DoNotScale)
slide = presentation.getSlides().get_Item(0)
cap_styles = [LineCapStyle.Flat, LineCapStyle.Round, LineCapStyle.Square]
for i, cap_style in enumerate(cap_styles):
line = slide.getShapes().addAutoShape(ShapeType.Line, 100, 50 + i * 70, 300, 0)
line.getLineFormat().setWidth(20)
line.getLineFormat().getFillFormat().setFillType(FillType.Solid)
color = Color(0, 0, 139)
line.getLineFormat().getFillFormat().getSolidFillColor().setColor(color)
line.getLineFormat().setDashStyle(LineDashStyle.Solid)
line.getLineFormat().setCapStyle(cap_style)
line.getLineFormat().setBeginArrowheadStyle(LineArrowheadStyle.None_)
line.getLineFormat().setEndArrowheadStyle(LineArrowheadStyle.None_)
presentation.save("line_caps.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Wynik w PowerPoint, od góry do dołu: Flat, Round, oraz Square.

Zastosuj efekty szkicu do linii kształtu
Efekt szkicu sprawia, że linia kształtu wygląda jak narysowana ręcznie. Użyj Shape.getLineFormat, aby uzyskać dostęp do ustawień linii, LineFormat.getSketchFormat, aby uzyskać dostęp do ustawień szkicu, oraz SketchFormat.setSketchType, aby wybrać wartość z klasy LineSketchType.
Poniższy kod w Pythonie pokazuje, jak zastosować efekt LineSketchType.Curved , odczytać wyraźnie przypisaną wartość oraz usunąć efekt za pomocą LineSketchType.None_:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import LineSketchType, Presentation, ShapeType
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 200, 100)
sketch_format = shape.getLineFormat().getSketchFormat()
sketch_format.setSketchType(LineSketchType.Curved)
explicit_sketch_type = sketch_format.getSketchType()
print("Explicit sketch type:", explicit_sketch_type)
sketch_format.setSketchType(LineSketchType.None_)
finally:
presentation.dispose()
Wartość zwrócona przez SketchFormat.getSketchType reprezentuje ustawienie przypisane bezpośrednio do kształtu. Jeśli formatowanie linii może być dziedziczone z motywu, slajdu-matki lub slajdu układu, użyj LineFormat.getEffective i odczytaj typ szkicu z zwróconego efektywnego formatowania linii, jak pokazano poniżej. Wartość efektywna odzwierciedla formatowanie, które jest faktycznie zastosowane po rozwiązaniu dziedziczenia. Ten przykład wymaga istniejącej prezentacji z co najmniej jednym kształtem na pierwszym slajdzie i wypisuje obie wartości:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation
presentation = Presentation("presentation.pptx")
try:
shape = presentation.getSlides().get_Item(0).getShapes().get_Item(0)
line_format = shape.getLineFormat()
explicit_sketch_type = line_format.getSketchFormat().getSketchType()
effective_line_format = line_format.getEffective()
effective_sketch_type = effective_line_format.getSketchFormat().getSketchType()
print("Explicit sketch type:", explicit_sketch_type)
print("Effective sketch type:", effective_sketch_type)
finally:
presentation.dispose()
Formatuj style połączeń
Oto trzy dostępne opcje typu połączenia:
- Round
- Miter
- Bevel
Styl połączenia kontroluje, jak dwa odcinki konturu spotykają 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 obramowaniami o szerokości 15 punktów. Używa LineFormat.setJoinStyle, aby kolejno ustawić wartości miter, bevel i round w LineJoinStyle, aby porównać, jak rysowane są rogi.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, LineJoinStyle, Presentation, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
miter_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 20, 150, 75)
bevel_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 210, 20, 150, 75)
round_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 135, 150, 75)
miter_shape.getFillFormat().setFillType(FillType.Solid)
miter_shape.getFillFormat().getSolidFillColor().setColor(Color.BLACK)
bevel_shape.getFillFormat().setFillType(FillType.Solid)
bevel_shape.getFillFormat().getSolidFillColor().setColor(Color.BLACK)
round_shape.getFillFormat().setFillType(FillType.Solid)
round_shape.getFillFormat().getSolidFillColor().setColor(Color.BLACK)
miter_shape.getLineFormat().setWidth(15)
bevel_shape.getLineFormat().setWidth(15)
round_shape.getLineFormat().setWidth(15)
miter_shape.getLineFormat().getFillFormat().setFillType(FillType.Solid)
miter_shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE)
bevel_shape.getLineFormat().getFillFormat().setFillType(FillType.Solid)
bevel_shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE)
round_shape.getLineFormat().getFillFormat().setFillType(FillType.Solid)
round_shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE)
miter_shape.getLineFormat().setJoinStyle(LineJoinStyle.Miter)
bevel_shape.getLineFormat().setJoinStyle(LineJoinStyle.Bevel)
round_shape.getLineFormat().setJoinStyle(LineJoinStyle.Round)
miter_shape.getTextFrame().setText("Miter Join Style")
bevel_shape.getTextFrame().setText("Bevel Join Style")
round_shape.getTextFrame().setText("Round Join Style")
presentation.save("join_styles.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Ogranicz połączenia miter przy ostrych rogach
Użyj LineFormat.setMiterLimit wraz z LineFormat.setJoinStyle ustawionym na LineJoinStyle.Miter, aby ograniczyć, jak daleko może wystawać ostry róg.
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śmiu razy większą od szerokości linii; nie jest to pomiar w punktach. Jeśli róg przekroczy limit, PowerPoint używa połączenia spłaszczonego w tym miejscu. Większy limit umożliwia ostrzejsze punkty. Ustawienie wpływa tylko na połączenia miter i zmiana nie ma widocznego efektu, gdy róg pozostaje w granicach limitów.
Ten przykład tworzy dwa identyczne, nie wypełnione trójkąty z obramowaniem o szerokości 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 około 4.12. W konsekwencji PowerPoint spłaszcza lewy wierzchołek i zachowuje prawy.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, LineJoinStyle, Presentation, SaveFormat, ShapeType, SlideSizeScaleType
from java.awt import Color
presentation = Presentation()
try:
presentation.getSlideSize().setSize(500, 320, SlideSizeScaleType.DoNotScale)
slide = presentation.getSlides().get_Item(0)
miter_limits = [2.0, 8.0]
for i, miter_limit in enumerate(miter_limits):
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)
color = Color(0, 0, 139)
triangle.getLineFormat().getFillFormat().getSolidFillColor().setColor(color)
triangle.getLineFormat().setJoinStyle(LineJoinStyle.Miter)
triangle.getLineFormat().setMiterLimit(miter_limit)
presentation.save("miter_limits.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Wynik w PowerPoint: Miter limit 2 po lewej i miter limit 8 po prawej.

Wypełnienie gradientem
Wypełnienie gradientem miesza kolory w obrębie kształtu. Ten przykład wypełnia elipsę gradientem liniowym pod kątem 45 stopni od czerwonego do fioletowego przy użyciu FillFormat.getGradientFormat. Metoda GradientStopCollection.addPresetColor umieszcza przystanki kolorów na pozycjach 0 i 1, czyli na początku i końcu gradientu. Usunięcie istniejących przystanków zapewnia, że używane będą tylko te dwa kolory.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, GradientShape, Presentation, PresetColor, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
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.0, PresetColor.Purple)
shape.getFillFormat().getGradientFormat().getGradientStops().addPresetColor(0.0, PresetColor.Red)
presentation.save("gradient_fill.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Wynik:

Jeśli gradient wygląda inaczej na wyeksportowanym obrazie niż w PowerPoint, zobacz Choose a Gradient Rendering Style. Możesz wybrać styl renderowania bez zmiany gradientu zapisanego w prezentacji.
Ustaw kąt gradientu liniowego
Użyj GradientFormat.setLinearGradientAngle, aby kontrolować orientację wypełnienia GradientShape.Linear. Kąt mierzony jest w stopniach i rośnie zgodnie z ruchem wskazówek zegara: 0 działa od lewej do prawej, 90 od góry do dołu, 180 od prawej do lewej i 270 od dołu do góry. Obsługiwane są kąty ułamkowe. Kąty skończone spoza przedziału [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 na pozycjach 0, 0.5 i 1. Skalowanie jest wyłączone, aby kąt można było porównać niezależnie od proporcji prostokątów. Kąty, od lewej do prawej, to 0, 45 i 90 w pierwszym wierszu oraz 135, 180 i 270 w drugim wierszu.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, GradientShape, NullableBool, Presentation, SaveFormat, ShapeType, SlideSizeScaleType
from java.awt import Color
presentation = Presentation()
try:
presentation.getSlideSize().setSize(720, 400, SlideSizeScaleType.DoNotScale)
slide = presentation.getSlides().get_Item(0)
angles = [0, 45, 90, 135, 180, 270]
for i, angle in enumerate(angles):
x = 30 + (i % 3) * 230
y = 30 + (i // 3) * 190
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, x, y, 200, 150)
shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill)
shape.getFillFormat().setFillType(FillType.Gradient)
gradient = shape.getFillFormat().getGradientFormat()
gradient.setGradientShape(GradientShape.Linear)
gradient.getGradientStops().clear()
gradient.getGradientStops().add(0, Color.RED)
gradient.getGradientStops().add(0.5, Color.GREEN)
gradient.getGradientStops().add(1, Color.BLUE)
gradient.setLinearGradientScaled(NullableBool.False_)
gradient.setLinearGradientAngle(angle)
presentation.save("linear_gradient_angles.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Wynik w PowerPoint:

Skaluj gradient liniowy z kształtem
GradientFormat.setLinearGradientScaled przyjmuje wartość NullableBool. Ustaw ją jawnie 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 kształtu niebędącego kwadratem.
Poniższy przykład używa kąta 45 stopni oraz tych samych przystanków kolorów co w porównaniu kątów. Lewa kolumna używa False_; prawa kolumna używa True_. Każda kolumna zawiera szeroki prostokąt powyżej wysokiego prostokąta. Oba zaczynają się od tych samych szerokich wymiarów; zmiana szerokości i wysokości drugiego prostokąta pokazuje, jak wypełnienie reaguje na zmianę rozmiaru bez zmiany ustawień gradientu.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, GradientShape, NullableBool, Presentation, SaveFormat, ShapeType, SlideSizeScaleType
from java.awt import Color
presentation = Presentation()
try:
presentation.getSlideSize().setSize(720, 460, SlideSizeScaleType.DoNotScale)
slide = presentation.getSlides().get_Item(0)
scaling_options = [NullableBool.False_, NullableBool.True_]
for column, scaled in enumerate(scaling_options):
for row in range(2):
x = 30 + column * 360
y = 30 if row == 0 else 150
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, x, y, 300, 90)
shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill)
shape.getFillFormat().setFillType(FillType.Gradient)
gradient = shape.getFillFormat().getGradientFormat()
gradient.setGradientShape(GradientShape.Linear)
gradient.getGradientStops().clear()
gradient.getGradientStops().add(0, Color.RED)
gradient.getGradientStops().add(0.5, Color.GREEN)
gradient.getGradientStops().add(1, Color.BLUE)
gradient.setLinearGradientAngle(45)
gradient.setLinearGradientScaled(scaled)
if row == 1:
shape.setWidth(90)
shape.setHeight(280)
presentation.save("linear_gradient_scaling.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Wynik w PowerPoint, przy wyłączonej skali po lewej i włączonej po prawej:

Przy wyłączonej skali, ukośne 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 przy dostosowywaniu kształtu do innego rozmiaru. W przypadku kwadratu, włączenie skali nie zmienia wyglądu tego gradientu o kącie 45 stopni.
Zarówno ustawienie kąta, jak i skalowania mają zastosowanie do gradientów liniowych. Nie kontrolują one wypełnień GradientShape.Radial or GradientShape.Rectangle.
Połącz kąt ze kierunkiem gradientu
GradientFormat.setGradientDirection wybiera styl gradientu z klasy GradientDirection. Nie jest to zamiennik kąta numerycznego. Dla gradientu liniowego style rogów mogą zmieniać obszar, na którym rozprowadzane są kolory, bez zmiany kąta przypisanego przez setLinearGradientAngle. Zachowaj niezmieniony kierunek przy porównywaniu kątów lub skali.
Poniższy przykład stosuje te same ustawienia w odwrotnej kolejności. Dwa prostokąty mają taki sam wygląd: przypisanie kierunku przed lub po kącie nie zmienia wyniku.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, GradientDirection, GradientShape, NullableBool, Presentation, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
for i in range(2):
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 30, 30 + i * 140, 320, 100)
shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill)
shape.getFillFormat().setFillType(FillType.Gradient)
gradient = shape.getFillFormat().getGradientFormat()
gradient.setGradientShape(GradientShape.Linear)
gradient.getGradientStops().clear()
gradient.getGradientStops().add(0, Color.RED)
gradient.getGradientStops().add(0.5, Color.GREEN)
gradient.getGradientStops().add(1, 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 wzorem
Wypełnienie wzorem stosuje dwukolorowy wzór, taki jak kropki, paski lub kratka. Ten przykład używa PatternFormat.setPatternStyle, aby wybrać wzór kraty. PatternFormat.getBackColor dostarcza jasnoszare tło, a PatternFormat.getForeColor dostarcza żółty kolor wzoru.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, PatternStyle, Presentation, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
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.LIGHT_GRAY)
shape.getFillFormat().getPatternFormat().getForeColor().setColor(Color.YELLOW)
presentation.save("pattern_fill.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()

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 PictureFillFormat.setPictureFillMode na tryb kafelkowy powiela obraz wewnątrz prostokąta. Źródłowy obraz użyty tutaj jest pokazany poniżej:

import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, Images, PictureFillMode, Presentation, SaveFormat, ShapeType
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 255, 130)
shape.getFillFormat().setFillType(FillType.Picture)
shape.getFillFormat().getPictureFillFormat().setPictureFillMode(PictureFillMode.Tile)
image = Images.fromFile("lotus.png")
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()

Kafelkowanie obrazu jako tekstury
Jeśli chcesz ustawić obraz kafelkowy jako teksturę i dostosować zachowanie kafelkowania, możesz użyć następujących metod 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 lub w obu kierunkach.
- setTileOffsetX: Ustawia poziome przesunięcie kafelka (w punktach) od pochodzenia kształtu.
- setTileOffsetY: Ustawia pionowe przesunięcie kafelka (w punktach) od pochodzenia kształtu.
- setTileScaleX: Definiuje poziomą skalę kafelka jako procent.
- setTileScaleY: Definiuje pionową skalę kafelka jako procent.
Ten przykład wymaga lokalnego obrazu i konfiguruje PictureFillFormat , aby powielał go w 50% oryginalnego rozmiaru. Przesunięcia o −32 punkty przesuwają kafelki poziomo i pionowo; wyrównanie do prawego dolnego rogu oraz odbicie w obu kierunkach określają, jak powtarzana tekstura jest rozmieszczona.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, Images, PictureFillMode, Presentation, RectangleAlignment, SaveFormat, ShapeType, TileFlip
presentation = Presentation()
try:
first_slide = presentation.getSlides().get_Item(0)
shape = first_slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 190, 95)
shape.getFillFormat().setFillType(FillType.Picture)
source_image = Images.fromFile("lotus.png")
try:
presentation_image = presentation.getImages().addImage(source_image)
finally:
source_image.dispose()
picture_fill_format = shape.getFillFormat().getPictureFillFormat()
picture_fill_format.getPicture().setImage(presentation_image)
picture_fill_format.setPictureFillMode(PictureFillMode.Tile)
picture_fill_format.setTileOffsetX(-32)
picture_fill_format.setTileOffsetY(-32)
picture_fill_format.setTileScaleX(50)
picture_fill_format.setTileScaleY(50)
picture_fill_format.setTileAlignment(RectangleAlignment.BottomRight)
picture_fill_format.setTileFlip(TileFlip.FlipBoth)
presentation.save("tile.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()

Wypełnienie kolorem stałym
Wypełnienie stałe nadaje kształtowi pojedynczy, jednolity kolor. Ten przykład używa FillFormat.setFillType, aby ustawić tryb wypełnienia stałego i przypisuje żółty kolor przez FillFormat.getSolidFillColor, a następnie zapisuje prostokąt w prezentacji.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, Presentation, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
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()

Kopiuj kolory zachowując odniesienia do motywu
Użyj ColorFormat.copyFrom, aby skopiować definicję koloru, w tym typ koloru, odniesienie do motywu i transformacje. Jest to przydatne przy przenoszeniu koloru wypełnienia między kształtami, które powinny nadal podążać za motywem prezentacji. Metoda kopiuje tylko kolor: nie kopiuje typu wypełnienia, obrysu ani innych formatowań kształtu. Ustaw typ wypełnienia docelowego eksplicytnie za pomocą FillFormat.setFillType.
Ten przykład tworzy trzy prostokąty, od lewej do prawej: źródłowy, kopię z zachowaniem motywu oraz kopię o stałym RGB. Źródło używa ColorFormat.setSchemeColor, aby odwołać się do pierwszego koloru akcentu i dodaje odcień przez ColorOperationCollection.add. Kopia RGB używa efektywnego koloru wypełnienia źródła, więc wszystkie trzy początkowo wyglądają identycznie. Wywołanie ColorFormat.setColor ustawia stałą wartość RGB i usuwa istniejące transformacje koloru.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import ColorTransformOperation, FillType, ImageFormat, Presentation, SaveFormat, SchemeColor, ShapeType, SlideSizeScaleType
from java.awt import Color
presentation = Presentation()
try:
presentation.getSlideSize().setSize(660, 220, SlideSizeScaleType.DoNotScale)
slide = presentation.getSlides().get_Item(0)
accent_color = Color(65, 105, 225)
presentation.getMasterTheme().getColorScheme().getAccent1().setColor(accent_color)
source = slide.getShapes().addAutoShape(ShapeType.Rectangle, 30, 40, 180, 140)
theme_copy = slide.getShapes().addAutoShape(ShapeType.Rectangle, 240, 40, 180, 140)
rgb_copy = slide.getShapes().addAutoShape(ShapeType.Rectangle, 450, 40, 180, 140)
for shape in (source, theme_copy, rgb_copy):
shape.getFillFormat().setFillType(FillType.Solid)
shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill)
source_color = source.getFillFormat().getSolidFillColor()
source_color.setSchemeColor(SchemeColor.Accent1)
source_color.getColorTransform().add(ColorTransformOperation.Tint, 0.75)
theme_copy.getFillFormat().getSolidFillColor().copyFrom(source_color)
rgb_copy.getFillFormat().getSolidFillColor().setColor(source.getFillFormat().getEffective().getSolidFillColor())
before = slide.getImage(1.0, 1.0)
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.
accent_color = Color(255, 69, 0)
presentation.getMasterTheme().getColorScheme().getAccent1().setColor(accent_color)
after = slide.getImage(1.0, 1.0)
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ą zgodne:

Po zmianie motywu źródło i kopia z zachowaniem motywu podążają za nowym kolorem akcentu i zachowują odcień. Kopia stała RGB pozostaje niebieska:

Skopiowana definicja jest niezależna od źródła. Subsekwentne zmiany odniesienia motywu źródła, przypisanie innego koloru lub dodanie/usunięcie jego transformacji nie zmieniają docelowego kształtu. Zmiana motywu nadal wpływa na oba kształty, ponieważ każdy niezależnie odwołuje się do tego samego koloru motywu.
Zapis i ponowne otwarcie pliku PPTX zachowuje typ skopiowanego koloru zwracany przez ColorFormat.getColorType, odniesienie do motywu oraz kolekcję transformacji zwracanych przez ColorFormat.getColorTransform, nie spłaszcza definicji do RGB.
Podczas kopiowania pomiędzy różnymi kontekstami motywu, takimi jak prezentacje z różnymi paletami akcentów, skopiowane odniesienie jest rozwiązywane względem motywu docelowego. To samo odniesienie i transformacje mogą więc dawać inny widoczny kolor. Zobacz Presentation Theme po więcej informacji o konfigurowaniu kolorów motywu.
Użyj tła slajdu jako wypełnienia kształtu
Użyj AutoShape.setUseBackgroundFill, gdy kształt powinien odpowiadać tłu slajdu, np. w szablonie prezentacji. Ustaw najpierw typ wypełnienia za pomocą FillFormat.setFillType na FillType.NotDefined , aby usunąć wszelkie wyraźne wypełnienie. W takiej kombinacji kształt używa tła slajdu zamiast swojego wypełnienia stylu. Włączenie samej flagi nie usuwa istniejącego wyraźnego wypełnienia.
Różni się to od FillType.NoFill : wypełnienie tłem pokrywa obiekty za kształtem odpowiednim obszarem tła slajdu, podczas gdy brak wypełnienia pozostawia te obiekty widoczne. Gradient pozostaje wyrównany do slajdu, a nie zaczyna się na nowo wewnątrz każdego kształtu.
Poniższy przykład tworzy tło główne dziedziczone przez slajd i umieszcza magentową wstęgę 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łem na wyraźne pomarańczowe wypełnienie.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import BackgroundType, FillType, GradientShape, Presentation, SaveFormat, ShapeType, SlideSizeScaleType
from java.awt import Color
presentation = Presentation()
try:
presentation.getSlideSize().setSize(720, 400, SlideSizeScaleType.DoNotScale)
slide = presentation.getSlides().get_Item(0)
# Dziedzicz gradient z mastera.
slide.getBackground().setType(BackgroundType.NotDefined)
slide.getLayoutSlide().getBackground().setType(BackgroundType.NotDefined)
background = slide.getLayoutSlide().getMasterSlide().getBackground()
background.setType(BackgroundType.OwnBackground)
background.getFillFormat().setFillType(FillType.Gradient)
gradient = background.getFillFormat().getGradientFormat()
gradient.setGradientShape(GradientShape.Linear)
gradient.setLinearGradientAngle(0)
gradient.getGradientStops().clear()
color = Color(0, 0, 139)
gradient.getGradientStops().add(0, color)
color = Color(135, 206, 250)
gradient.getGradientStops().add(1, color)
# Dodaj ten obiekt jako pierwszy, aby znajdował się za prostokątami.
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)
background_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 100, 160, 200)
background_shape.getFillFormat().setFillType(FillType.NotDefined)
background_shape.setUseBackgroundFill(True)
no_fill_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 280, 100, 160, 200)
no_fill_shape.getFillFormat().setFillType(FillType.NoFill)
explicit_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 510, 100, 160, 200)
explicit_shape.getFillFormat().setFillType(FillType.NotDefined)
explicit_shape.setUseBackgroundFill(True)
# Wyłącz wypełnienie tłem przed zastosowaniem wyraźnego wypełnienia.
explicit_shape.setUseBackgroundFill(False)
explicit_shape.getFillFormat().setFillType(FillType.Solid)
color = Color(255, 165, 0)
explicit_shape.getFillFormat().getSolidFillColor().setColor(color)
presentation.save("background_fill.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Wynik, od lewej do prawej: background fill, no fill, oraz explicit fill. Magentowa wstęga jest zasłonięta przez lewy i prawy prostokąt, ale pozostaje widoczna 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ązania tła slajdu; w przykładzie zarówno tła slajdu, jak i układu są nieokreślone, więc dostarcza je główne tło.
Ustaw przejrzystość
W przypadku wypełnienia stałego, składnik alfa koloru kontroluje nieprzezroczystość: 0 oznacza całkowitą przezroczystość, a 255 pełną nieprzezroczystość. Ten przykład używa wartości alfa 128 dla żółtego prostokąta, co sprawia, że jest on w przybliżeniu 50% przezroczysty, dzięki czemu prostokąt pod nim pozostaje widoczny. Kolor jest przypisany poprzez FillFormat.getSolidFillColor.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, Presentation, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
solid_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75)
transparent_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 80, 80, 150, 75)
transparent_shape.getFillFormat().setFillType(FillType.Solid)
color = Color(255, 255, 0, 128)
transparent_shape.getFillFormat().getSolidFillColor().setColor(color)
presentation.save("shape_transparency.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()

Obróć kształty
Użyj Shape.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 jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat, ShapeType
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75)
shape.setRotation(5)
presentation.save("shape_rotation.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()

Dodaj efekty 3D Bevel
Użyj Shape.getThreeDFormat, aby nadać kształtowi głębokość i krawędzie z fazą. Ten przykład tworzy zieloną elipsę z pomarańczowym obrysem, używa ThreeDFormat.setDepth, aby ustawić głębokość na 4 punkty, i stosuje okrągłą fazę górną o szerokości i wysokości 6 punktów poprzez ThreeDFormat.getBevelTop. Kamera ortograficzna skierowana do przodu oraz oświetlenie trójpunktowe sprawiają, że faza jest widoczna.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import BevelPresetType, CameraPresetType, FillType, LightRigPresetType, LightingDirection, Presentation, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Ellipse, 50, 50, 100, 100)
shape.getFillFormat().setFillType(FillType.Solid)
color = Color(0, 128, 0)
shape.getFillFormat().getSolidFillColor().setColor(color)
shape.getLineFormat().getFillFormat().setFillType(FillType.Solid)
color = Color(255, 165, 0)
shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(color)
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()

Dodaj efekty obrotu 3D
Widok 3D kształtu kontrolowany jest przez ustawienia kamery. Ten przykład używa Camera.setRotation z kątami szerokości, długości i obrotu wynoszącymi odpowiednio 40, 35 i 20 stopni. Wybiera kamerę izometryczną poprzez Camera.setCameraType oraz zrównoważone oświetlenie poprzez LightRig.setLightType, a następnie zapisuje sformatowany prostokąt.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import CameraPresetType, LightRigPresetType, Presentation, SaveFormat, ShapeType
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75)
auto_shape.getTextFrame().setText("Hello, Aspose!")
auto_shape.getThreeDFormat().getCamera().setCameraType(CameraPresetType.IsometricLeftUp)
auto_shape.getThreeDFormat().getCamera().setRotation(40, 35, 20)
auto_shape.getThreeDFormat().getLightRig().setLightType(LightRigPresetType.Balanced)
presentation.save("3D_rotation_effect.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()

Kontroluj renderowanie czarno-białe dla kształtów
Metoda Shape.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 samej funkcji wyświetlania w czerni i bieli oraz 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ą szarego zabarwienia, BlackWhite używa wyłącznie czerni i bieli, Black i White wymuszają jeden kolor, Color zachowuje normalne kolory, 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 Shape.setBlackWhiteMode, aby ustawić tryb na szary. Zapisany kształt zachowuje pomarańczowe wypełnienie w normalnym trybie kolorowym i żąda szarego zabarwienia od aplikacji respektujących ustawienia wyświetlania czarno-białego:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import BlackWhiteMode, FillType, Presentation, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 200, 100)
shape.getFillFormat().setFillType(FillType.Solid)
color = Color(255, 165, 0)
shape.getFillFormat().getSolidFillColor().setColor(color)
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 workflow wyświetlania czarno-białego używa szarego zabarwienia, ponieważ jego tryb jest ustawiony na Gray. Pozwala to zachować slajd w pełnym kolorze, definiując jednocześnie odrębny wygląd dla druku, podglądu lub innych workflow, które respektują ustawienia wyświetlania czarno-białego prezentacji.
Resetowanie formatowania
Użyj Slide.reset, aby przywrócić pozycję, rozmiar i formatowanie pól zastępczych slajdu z ich odpowiadającymi polami zastępczymi układu. Ten przykład wymaga istniejącej prezentacji z polami zastępczymi powiązanymi z układem i resetuje każdy slajd przed zapisaniem. Kształty bez odpowiadających pól zastępczych układu nie są resetowane.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation("sample.pptx")
try:
for slide in 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, linię i ustawienia efektów. Jeśli wszystkie odpowiadające wartości są zgodne, traktuj ich style jako identyczne i logicznie grupuj te kształty, co upraszcza późniejsze zarządzanie stylami.
Czy mogę zapisać zestaw niestandardowych stylów kształtów do osobnego pliku, aby ponownie używać ich w innych prezentacjach?
Tak. Przechowuj przykładowe kształty z pożądanymi stylami w zestawie slajdów szablonu lub pliku szablonu .POTX. Tworząc nową prezentację, otwórz szablon, sklonuj potrzebne stylizowane kształty i ponownie zastosuj ich formatowanie w dowolnym miejscu.