Mise en forme des formes PowerPoint en JavaScript
Introduction
Formatez les formes dans PowerPoint en ajustant leurs contours, remplissages et effets. Aspose.Slides for Node.js via Java vous permet de contrôler ces paramètres de façon programmatique, y compris la transparence, la rotation et le formatage 3D.

Aspose.Slides for Node.js via Java fournit des classes et des méthodes qui vous permettent de formater les formes en utilisant les mêmes options disponibles dans PowerPoint.
Format Lines
Utilisez Shape.getLineFormat pour contrôler le contour d’une forme. Cet exemple crée un rectangle sans remplissage avec un contour bleu en tirets. LineFormat.setStyle sélectionne une ligne composée épaisse‑fine, tandis que LineFormat.setWidth définit sa largeur à 7 points et LineFormat.setDashStyle choisit le motif de tirets.
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
let presentation = new aspose.slides.Presentation();
try {
let slide = presentation.getSlides().get_Item(0);
let shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 50, 150, 75);
shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
shape.getLineFormat().setStyle(java.newByte(aspose.slides.LineStyle.ThickThin));
shape.getLineFormat().setWidth(7);
shape.getLineFormat().setDashStyle(java.newByte(aspose.slides.LineDashStyle.Dash));
shape.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLUE"));
presentation.save("formatted_lines.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Le résultat :

Set Custom Line Dash Patterns
Utilisez LineFormat.setCustomDashPattern lorsque les styles de ligne prédéfinis ne fournissent pas les longueurs de tirets et d’intervalles dont vous avez besoin, par exemple pour des contours de marque ou des schémas techniques. L’affectation d’un motif modifie automatiquement le style de tiret de ligne en LineDashStyle.Custom.
Les entrées du tableau alternent entre longueurs de tiret et d’écart, en commençant par un tiret. Chaque valeur est un multiple de la largeur de ligne : [4, 2] à une largeur de 3 points produit un tiret de 12 points suivi d’un écart de 6 points. Utilisez des paires de valeurs finies et non négatives pour définir des segments complets de tiret‑et‑écart. L’exemple utilise des valeurs positives afin que chaque tiret et chaque écart restent visibles.
Cet exemple crée cinq lignes bleues de même longueur et avec des extrémités plates. Les trois premières comparent les motifs à une largeur de 3 points. La quatrième répète le premier motif à deux fois la largeur, doublant ainsi les longueurs du tiret et de l’écart. La cinquième passe d’un motif personnalisé à une ligne pleine.
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
let presentation = new aspose.slides.Presentation();
try {
presentation.getSlideSize().setSize(600, 300, aspose.slides.SlideSizeScaleType.DoNotScale);
let slide = presentation.getSlides().get_Item(0);
let patterns = [
[4, 2],
[1, 2],
[6, 2, 1, 2],
[4, 2],
[4, 2]
];
for (let i = 0; i < patterns.length; i++) {
let line = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Line, 50, 50 + i * 50, 500, 0);
line.getLineFormat().setWidth(i == 3 ? 6 : 3);
line.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
line.getLineFormat().getFillFormat().getSolidFillColor().setColor(java.newInstanceSync("java.awt.Color", 0, 0, 139));
line.getLineFormat().setCapStyle(java.newByte(aspose.slides.LineCapStyle.Flat));
line.getLineFormat().setBeginArrowheadStyle(java.newByte(aspose.slides.LineArrowheadStyle.None));
line.getLineFormat().setEndArrowheadStyle(java.newByte(aspose.slides.LineArrowheadStyle.None));
let pattern = java.newArray("float", patterns[i]);
line.getLineFormat().setCustomDashPattern(pattern);
}
// Rétablir la dernière ligne à un style plein.
slide.getShapes().get_Item(4).getLineFormat().setDashStyle(java.newByte(aspose.slides.LineDashStyle.Solid));
presentation.save("custom_dash_patterns.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Pour revenir à un style de tiret prédéfini, passez LineDashStyle.Dash à LineFormat.setDashStyle. Le style sélectionné contrôle l’apparence de la ligne.
Le résultat dans PowerPoint, de haut en bas : {4, 2}, 3 pt ; {1, 2}, 3 pt ; {6, 2, 1, 2}, 3 pt ; {4, 2}, 6 pt ; et Solid, 3 pt.

Set Line Caps
Utilisez LineFormat.setCapStyle pour définir les extrémités d’une ligne ouverte. La classe LineCapStyle propose trois styles d’extrémité explicites :
Flat: le trait s’arrête au point final.Round: une extrémité semi‑circulaire dépasse le point final de la moitié de la largeur de la ligne.Square: une extrémité carrée dépasse le point final de la moitié de la largeur de la ligne.
La classe comprend également NotDefined, qui signifie qu’aucun style d’extrémité n’est explicitement assigné.
Les extrémités diffèrent des pointes de flèche, qui ajoutent des symboles aux bouts de ligne, et des jointures, qui contrôlent les coins entre les segments de ligne. Cet exemple désactive les pointes de flèche via LineFormat.setBeginArrowheadStyle et LineFormat.setEndArrowheadStyle afin que seules les formes d’extrémité soient comparées.
L’exemple suivant crée trois lignes horizontales sinon identiques, de 20 points de largeur. De haut en bas, elles utilisent respectivement les extrémités Flat, Round et Square. Leurs points d’extrémité ont les mêmes coordonnées horizontales ; les extrémités rondes et carrées dépassent de 10 points chaque côté.
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
let presentation = new aspose.slides.Presentation();
try {
presentation.getSlideSize().setSize(500, 240, aspose.slides.SlideSizeScaleType.DoNotScale);
let slide = presentation.getSlides().get_Item(0);
let capStyles = [aspose.slides.LineCapStyle.Flat, aspose.slides.LineCapStyle.Round, aspose.slides.LineCapStyle.Square];
for (let i = 0; i < capStyles.length; i++) {
let line = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Line, 100, 50 + i * 70, 300, 0);
line.getLineFormat().setWidth(20);
line.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
line.getLineFormat().getFillFormat().getSolidFillColor().setColor(java.newInstanceSync("java.awt.Color", 0, 0, 139));
line.getLineFormat().setDashStyle(java.newByte(aspose.slides.LineDashStyle.Solid));
line.getLineFormat().setCapStyle(java.newByte(capStyles[i]));
line.getLineFormat().setBeginArrowheadStyle(java.newByte(aspose.slides.LineArrowheadStyle.None));
line.getLineFormat().setEndArrowheadStyle(java.newByte(aspose.slides.LineArrowheadStyle.None));
}
presentation.save("line_caps.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Le résultat dans PowerPoint, de haut en bas : Flat, Round, et Square.

Apply Sketch Effects to Shape Lines
Un effet de croquis rend la ligne d’une forme semblable à un dessin à main levée. Utilisez Shape.getLineFormat pour accéder aux paramètres de ligne, LineFormat.getSketchFormat pour accéder aux paramètres de croquis, et SketchFormat.setSketchType pour sélectionner une valeur de la classe LineSketchType.
Le code JavaScript suivant montre comment appliquer un effet LineSketchType.Curved, lire la valeur explicitement assignée, et supprimer l’effet avec LineSketchType.None :
const aspose = { slides: require("aspose.slides.via.java") };
let presentation = new aspose.slides.Presentation();
try {
let slide = presentation.getSlides().get_Item(0);
let shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 50, 200, 100);
let sketchFormat = shape.getLineFormat().getSketchFormat();
sketchFormat.setSketchType(aspose.slides.LineSketchType.Curved);
let explicitSketchType = sketchFormat.getSketchType();
console.log("Explicit sketch type: " + explicitSketchType);
sketchFormat.setSketchType(aspose.slides.LineSketchType.None);
} finally {
presentation.dispose();
}
La valeur renvoyée par SketchFormat.getSketchType représente le paramètre assigné directement à la forme. Si le formatage de ligne peut être hérité d’un thème, d’une diapositive maître ou d’une diapositive de mise en page, utilisez LineFormat.getEffective, appelez getSketchFormat sur l’objet retourné, puis appelez sa méthode getSketchType. La valeur effective reflète le formatage réellement appliqué après résolution de l’héritage. Cet exemple nécessite une présentation existante contenant au moins une forme sur la première diapositive et affiche les deux valeurs :
const aspose = { slides: require("aspose.slides.via.java") };
let presentation = new aspose.slides.Presentation("presentation.pptx");
try {
let shape = presentation.getSlides().get_Item(0).getShapes().get_Item(0);
let lineFormat = shape.getLineFormat();
let explicitSketchType = lineFormat.getSketchFormat().getSketchType();
let effectiveLineFormat = lineFormat.getEffective();
let effectiveSketchType = effectiveLineFormat.getSketchFormat().getSketchType();
console.log("Explicit sketch type: " + explicitSketchType);
console.log("Effective sketch type: " + effectiveSketchType);
} finally {
presentation.dispose();
}
Format Join Styles
Voici les trois options de type de jointure :
- Round
- Miter
- Bevel
Le style de jointure contrôle la façon dont deux segments de contour se rejoignent à un coin. Utilisez Round pour des coins arrondis, Miter pour des angles pointus, ou Bevel pour des coins aplatis.

Cet exemple crée trois rectangles noirs avec des contours bleus de 15 points de largeur. Il utilise LineFormat.setJoinStyle pour appliquer respectivement les valeurs miter, bevel et round de LineJoinStyle, afin de comparer la manière dont les coins sont tracés.
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
let presentation = new aspose.slides.Presentation();
try {
let slide = presentation.getSlides().get_Item(0);
let miterShape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 20, 20, 150, 75);
let bevelShape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 210, 20, 150, 75);
let roundShape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 20, 135, 150, 75);
miterShape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
miterShape.getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLACK"));
bevelShape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
bevelShape.getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLACK"));
roundShape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
roundShape.getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLACK"));
miterShape.getLineFormat().setWidth(15);
bevelShape.getLineFormat().setWidth(15);
roundShape.getLineFormat().setWidth(15);
miterShape.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
miterShape.getLineFormat().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLUE"));
bevelShape.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
bevelShape.getLineFormat().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLUE"));
roundShape.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
roundShape.getLineFormat().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLUE"));
miterShape.getLineFormat().setJoinStyle(java.newByte(aspose.slides.LineJoinStyle.Miter));
bevelShape.getLineFormat().setJoinStyle(java.newByte(aspose.slides.LineJoinStyle.Bevel));
roundShape.getLineFormat().setJoinStyle(java.newByte(aspose.slides.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", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Limit Miter Joins at Sharp Corners
Utilisez LineFormat.setMiterLimit avec LineFormat.setJoinStyle réglé sur LineJoinStyle.Miter pour limiter l’étendue d’un coin pointu.
La limite est le rapport entre la distance des coins interne et externe de la jointure et la largeur de ligne. Par exemple, une valeur de 8 autorise une longueur de jointure allant jusqu’à huit fois la largeur de ligne ; ce n’est pas une mesure en points. Si le coin devait dépasser la limite, PowerPoint utilise une jointure biseautée à ce coin. Une limite plus grande permet des pointes plus aiguës. Ce paramètre n’affecte que les jointures de type miter, et le changer n’a aucun effet visible lorsque le coin reste dans les deux limites.
Cet exemple crée deux triangles non remplis et identiques, avec des contours de 20 points de largeur. Le triangle de gauche utilise une limite de 2, celui de droite une limite de 8. Chaque triangle mesure 80 points de largeur et 160 points de hauteur, ce qui donne à son coin supérieur un rapport longueur‑de‑jointure‑à‑largeur de ligne d’environ 4.12. Ainsi, PowerPoint biseautera l’apex gauche et conservera l’apex droit pointu.
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
let presentation = new aspose.slides.Presentation();
try {
presentation.getSlideSize().setSize(500, 320, aspose.slides.SlideSizeScaleType.DoNotScale);
let slide = presentation.getSlides().get_Item(0);
let miterLimits = [2, 8];
for (let i = 0; i < miterLimits.length; i++) {
let triangle = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Triangle, 90 + i * 240, 110, 80, 160);
triangle.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
triangle.getLineFormat().setWidth(20);
triangle.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
triangle.getLineFormat().getFillFormat().getSolidFillColor().setColor(java.newInstanceSync("java.awt.Color", 0, 0, 139));
triangle.getLineFormat().setJoinStyle(java.newByte(aspose.slides.LineJoinStyle.Miter));
triangle.getLineFormat().setMiterLimit(java.newFloat(miterLimits[i]));
}
presentation.save("miter_limits.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Le résultat dans PowerPoint : Miter limit 2 à gauche et miter limit 8 à droite.

Gradient Fill
Un remplissage en dégradé mélange des couleurs sur une forme. Cet exemple remplit une ellipse avec un dégradé linéaire à 45° du rouge au violet en utilisant FillFormat.getGradientFormat. La méthode GradientStopCollection.addPresetColor place les points de couleur à 0 et 1, au début et à la fin du dégradé. Effacer les points existants garantit que seules ces deux couleurs sont utilisées.
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
let presentation = new aspose.slides.Presentation();
try {
let slide = presentation.getSlides().get_Item(0);
let shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Ellipse, 50, 50, 150, 75);
shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Gradient));
shape.getFillFormat().getGradientFormat().setGradientShape(java.newByte(aspose.slides.GradientShape.Linear));
shape.getFillFormat().getGradientFormat().setLinearGradientAngle(45);
shape.getFillFormat().getGradientFormat().getGradientStops().clear();
shape.getFillFormat().getGradientFormat().getGradientStops().addPresetColor(1.0, aspose.slides.PresetColor.Purple);
shape.getFillFormat().getGradientFormat().getGradientStops().addPresetColor(0.0, aspose.slides.PresetColor.Red);
presentation.save("gradient_fill.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Le résultat :

Si un dégradé apparaît différemment dans une image exportée que dans PowerPoint, consultez Choose a Gradient Rendering Style. Vous pouvez sélectionner un style de rendu sans modifier le dégradé stocké dans la présentation.
Set the Linear Gradient Angle
Utilisez GradientFormat.setLinearGradientAngle pour contrôler l’orientation d’un remplissage GradientShape.Linear. L’angle est mesuré en degrés et augmente dans le sens des aiguilles d’une montre : 0 va de gauche à droite, 90 de haut en bas, 180 de droite à gauche, et 270 de bas en haut. Les angles fractionnaires sont pris en charge. Les angles finis hors de l’intervalle [0, 360) sont normalisés à un tour complet ; par exemple, -45 devient 315 et 360 devient 0.
Cet exemple crée six rectangles avec des points de couleur rouge, vert et bleu identiques aux positions 0, 0.5 et 1. L’échelle est désactivée afin que l’angle puisse être comparé indépendamment des proportions des rectangles. Les angles, de gauche à droite, sont 0, 45 et 90 dans la première rangée, et 135, 180 et 270 dans la seconde.
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
let presentation = new aspose.slides.Presentation();
try {
presentation.getSlideSize().setSize(720, 400, aspose.slides.SlideSizeScaleType.DoNotScale);
let slide = presentation.getSlides().get_Item(0);
let angles = [0, 45, 90, 135, 180, 270];
for (let i = 0; i < angles.length; i++) {
let x = 30 + (i % 3) * 230;
let y = 30 + Math.floor(i / 3) * 190;
let shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, x, y, 200, 150);
shape.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Gradient));
let gradient = shape.getFillFormat().getGradientFormat();
gradient.setGradientShape(java.newByte(aspose.slides.GradientShape.Linear));
gradient.getGradientStops().clear();
gradient.getGradientStops().add(0, java.getStaticFieldValue("java.awt.Color", "RED"));
gradient.getGradientStops().add(java.newFloat(0.5), java.getStaticFieldValue("java.awt.Color", "GREEN"));
gradient.getGradientStops().add(1, java.getStaticFieldValue("java.awt.Color", "BLUE"));
gradient.setLinearGradientScaled(java.newByte(aspose.slides.NullableBool.False));
gradient.setLinearGradientAngle(angles[i]);
}
presentation.save("linear_gradient_angles.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Le résultat dans PowerPoint :

Scale a Linear Gradient with the Shape
GradientFormat.setLinearGradientScaled accepte une valeur NullableBool. Définissez‑la explicitement sur False pour conserver l’angle géométrique du dégradé lorsque les proportions de la forme changent, ou sur True pour mettre à l’échelle le dégradé avec la largeur et la hauteur de la forme. Avec l’échelle activée, l’angle visible peut différer de l’angle assigné sur une forme non carrée.
L’exemple suivant utilise un angle de 45 degrés et les mêmes points de couleur que la comparaison d’angles. La colonne de gauche utilise False ; la colonne de droite utilise True. Chaque colonne comporte un rectangle large au-dessus d’un rectangle haut. Les deux commencent avec les mêmes dimensions larges ; modifier la largeur et la hauteur du deuxième rectangle montre comment le remplissage réagit au redimensionnement sans changer les réglages du dégradé.
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
let presentation = new aspose.slides.Presentation();
try {
presentation.getSlideSize().setSize(720, 460, aspose.slides.SlideSizeScaleType.DoNotScale);
let slide = presentation.getSlides().get_Item(0);
let scalingOptions = [aspose.slides.NullableBool.False, aspose.slides.NullableBool.True];
for (let column = 0; column < scalingOptions.length; column++) {
for (let row = 0; row < 2; row++) {
let x = 30 + column * 360;
let y = row == 0 ? 30 : 150;
let shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, x, y, 300, 90);
shape.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Gradient));
let gradient = shape.getFillFormat().getGradientFormat();
gradient.setGradientShape(java.newByte(aspose.slides.GradientShape.Linear));
gradient.getGradientStops().clear();
gradient.getGradientStops().add(0, java.getStaticFieldValue("java.awt.Color", "RED"));
gradient.getGradientStops().add(java.newFloat(0.5), java.getStaticFieldValue("java.awt.Color", "GREEN"));
gradient.getGradientStops().add(1, java.getStaticFieldValue("java.awt.Color", "BLUE"));
gradient.setLinearGradientAngle(45);
gradient.setLinearGradientScaled(java.newByte(scalingOptions[column]));
if (row == 1) {
shape.setWidth(90);
shape.setHeight(280);
}
}
}
presentation.save("linear_gradient_scaling.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Le résultat dans PowerPoint, avec l’échelle désactivée à gauche et activée à droite :

Avec l’échelle désactivée, les bandes de couleur diagonales conservent la même orientation dans les deux rectangles. Avec l’échelle activée, les bandes s’étirent avec les proportions de la forme. Cela aide à reproduire le dégradé d’un modèle lorsqu’on adapte une forme à une taille différente. Sur un carré, activer l’échelle ne modifie pas l’apparence de ce dégradé à 45 degrés.
Les réglages d’angle et d’échelle s’appliquent aux dégradés linéaires. Ils ne contrôlent pas les remplissages GradientShape.Radial ou GradientShape.Rectangle.
Combine the Angle with Gradient Direction
GradientFormat.setGradientDirection sélectionne un style de dégradé parmi la classe GradientDirection; ce n’est pas un substitut à un angle numérique. Pour un dégradé linéaire, les styles de coin peuvent modifier la zone sur laquelle les couleurs sont distribuées sans changer l’angle assigné via setLinearGradientAngle. Conservez la direction inchangée lors de la comparaison des angles ou de l’échelle.
L’exemple suivant applique les mêmes réglages dans des ordres opposés. Les deux rectangles ont la même apparence : assigner la direction avant ou après l’angle ne modifie pas le résultat.
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
let presentation = new aspose.slides.Presentation();
try {
let slide = presentation.getSlides().get_Item(0);
for (let i = 0; i < 2; i++) {
let shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 30, 30 + i * 140, 320, 100);
shape.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Gradient));
let gradient = shape.getFillFormat().getGradientFormat();
gradient.setGradientShape(java.newByte(aspose.slides.GradientShape.Linear));
gradient.getGradientStops().clear();
gradient.getGradientStops().add(0, java.getStaticFieldValue("java.awt.Color", "RED"));
gradient.getGradientStops().add(java.newFloat(0.5), java.getStaticFieldValue("java.awt.Color", "GREEN"));
gradient.getGradientStops().add(1, java.getStaticFieldValue("java.awt.Color", "BLUE"));
gradient.setLinearGradientScaled(java.newByte(aspose.slides.NullableBool.True));
if (i == 0) {
gradient.setGradientDirection(aspose.slides.GradientDirection.FromCorner1);
gradient.setLinearGradientAngle(30);
} else {
gradient.setLinearGradientAngle(30);
gradient.setGradientDirection(aspose.slides.GradientDirection.FromCorner1);
}
}
presentation.save("linear_gradient_direction.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Pattern Fill
Un remplissage de motif applique un motif bicolore, tel que points, rayures ou damiers. Cet exemple utilise PatternFormat.setPatternStyle pour sélectionner un motif treillis. PatternFormat.getBackColor fournit le fond gris clair, et PatternFormat.getForeColor fournit la couleur jaune du motif.
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
let presentation = new aspose.slides.Presentation();
try {
let slide = presentation.getSlides().get_Item(0);
let shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 50, 150, 75);
shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Pattern));
shape.getFillFormat().getPatternFormat().setPatternStyle(java.newByte(aspose.slides.PatternStyle.Trellis));
shape.getFillFormat().getPatternFormat().getBackColor().setColor(java.getStaticFieldValue("java.awt.Color", "LIGHT_GRAY"));
shape.getFillFormat().getPatternFormat().getForeColor().setColor(java.getStaticFieldValue("java.awt.Color", "YELLOW"));
presentation.save("pattern_fill.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Le résultat :

Picture Fill
Un remplissage d’image utilise une image à l’intérieur d’une forme. Cet exemple nécessite une image locale et utilise Images.fromFile pour la charger dans la collection d’images de la présentation. Le réglage de PictureFillFormat.setPictureFillMode sur le mode mosaïque répète l’image à l’intérieur du rectangle. L’image source utilisée ici est affichée ci‑dessous :

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
let presentation = new aspose.slides.Presentation();
try {
let slide = presentation.getSlides().get_Item(0);
let shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 50, 255, 130);
shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Picture));
shape.getFillFormat().getPictureFillFormat().setPictureFillMode(aspose.slides.PictureFillMode.Tile);
let image = aspose.slides.Images.fromFile("lotus.png");
let picture;
try {
picture = presentation.getImages().addImage(image);
} finally {
image.dispose();
}
shape.getFillFormat().getPictureFillFormat().getPicture().setImage(picture);
presentation.save("picture_fill.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Le résultat :

Tile Picture As Texture
Si vous souhaitez définir une image en mosaïque comme texture et personnaliser le comportement du carrelage, vous pouvez utiliser les méthodes suivantes de la classe PictureFillFormat :
- setPictureFillMode : définit le mode de remplissage d’image —
TileouStretch. - setTileAlignment : spécifie l’alignement des tuiles dans la forme.
- setTileFlip : contrôle si la tuile est retournée horizontalement, verticalement, ou les deux.
- setTileOffsetX : définit le décalage horizontal de la tuile (en points) depuis l’origine de la forme.
- setTileOffsetY : définit le décalage vertical de la tuile (en points) depuis l’origine de la forme.
- setTileScaleX : définit l’échelle horizontale de la tuile en pourcentage.
- setTileScaleY : définit l’échelle verticale de la tuile en pourcentage.
Cet exemple nécessite une image locale et configure PictureFillFormat pour la répéter à 50 % de sa taille originale. Des décalages de −32 points déplacent les tuiles horizontalement et verticalement ; l’alignement en bas‑à‑droite et le retournement dans les deux directions déterminent la façon dont la texture répétée est disposée.
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
let presentation = new aspose.slides.Presentation();
try {
let firstSlide = presentation.getSlides().get_Item(0);
let shape = firstSlide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 50, 190, 95);
shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Picture));
let sourceImage = aspose.slides.Images.fromFile("lotus.png");
let presentationImage;
try {
presentationImage = presentation.getImages().addImage(sourceImage);
} finally {
sourceImage.dispose();
}
let pictureFillFormat = shape.getFillFormat().getPictureFillFormat();
pictureFillFormat.getPicture().setImage(presentationImage);
pictureFillFormat.setPictureFillMode(aspose.slides.PictureFillMode.Tile);
pictureFillFormat.setTileOffsetX(-32);
pictureFillFormat.setTileOffsetY(-32);
pictureFillFormat.setTileScaleX(50);
pictureFillFormat.setTileScaleY(50);
pictureFillFormat.setTileAlignment(java.newByte(aspose.slides.RectangleAlignment.BottomRight));
pictureFillFormat.setTileFlip(aspose.slides.TileFlip.FlipBoth);
presentation.save("tile.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Le résultat :

Solid Color Fill
Un remplissage uni donne à une forme une seule couleur uniforme. Cet exemple utilise FillFormat.setFillType pour sélectionner le mode de remplissage solide et assigne le jaune via FillFormat.getSolidFillColor, puis enregistre le rectangle dans une présentation.
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
let presentation = new aspose.slides.Presentation();
try {
let slide = presentation.getSlides().get_Item(0);
let shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 50, 150, 75);
shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
shape.getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "YELLOW"));
presentation.save("solid_color_fill.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Le résultat :

Copy Colors While Preserving Theme References
Utilisez ColorFormat.copyFrom pour copier une définition de couleur, y compris son type de couleur, sa référence de thème et ses transformations. Ceci est utile lors du transfert d’une couleur de remplissage entre des formes qui doivent continuer à suivre le thème de la présentation. La méthode copie uniquement la couleur ; elle ne copie pas le type de remplissage, le contour ou d’autres formatages de forme. Définissez explicitement le type de remplissage de destination avec FillFormat.setFillType.
Cet exemple crée trois rectangles, de gauche à droite : la source, une copie sensible au thème, et une copie RGB fixe. La source utilise ColorFormat.setSchemeColor pour référencer la première couleur d’accent et ajoute une teinte via ColorOperationCollection.add. La copie RGB utilise la couleur de remplissage effective de la source, de sorte que les trois semblent identiques au départ. L’appel à ColorFormat.setColor fixe une valeur RGB et supprime toutes les transformations de couleur existantes.
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
let presentation = new aspose.slides.Presentation();
try {
presentation.getSlideSize().setSize(660, 220, aspose.slides.SlideSizeScaleType.DoNotScale);
let slide = presentation.getSlides().get_Item(0);
presentation.getMasterTheme().getColorScheme().getAccent1().setColor(java.newInstanceSync("java.awt.Color", 65, 105, 225));
let source = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 30, 40, 180, 140);
let themeCopy = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 240, 40, 180, 140);
let rgbCopy = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 450, 40, 180, 140);
for (let shape of [source, themeCopy, rgbCopy]) {
shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
shape.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
}
let sourceColor = source.getFillFormat().getSolidFillColor();
sourceColor.setSchemeColor(aspose.slides.SchemeColor.Accent1);
sourceColor.getColorTransform().add(aspose.slides.ColorTransformOperation.Tint, java.newFloat(0.75));
themeCopy.getFillFormat().getSolidFillColor().copyFrom(sourceColor);
rgbCopy.getFillFormat().getSolidFillColor().setColor(source.getFillFormat().getEffective().getSolidFillColor());
let before = slide.getImage(1, 1);
try {
before.save("color-copy-before.png", aspose.slides.ImageFormat.Png);
} finally {
before.dispose();
}
// Les références de thème suivent la nouvelle couleur d'accent ; la valeur RVB fixe ne le fait pas.
presentation.getMasterTheme().getColorScheme().getAccent1().setColor(java.newInstanceSync("java.awt.Color", 255, 69, 0));
let after = slide.getImage(1, 1);
try {
after.save("color-copy-after.png", aspose.slides.ImageFormat.Png);
} finally {
after.dispose();
}
presentation.save("copied_colors.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Avant le changement de thème, les trois remplissages correspondent :

Après le changement de thème, la source et la copie sensible au thème suivent la nouvelle couleur d’accent et conservent leur teinte. La copie RGB fixe reste bleue :

La définition copiée est indépendante de la source. Modifier ultérieurement la référence de thème de la source, assigner une autre couleur, ou ajouter/supprimer ses transformations ne modifie pas la destination. Un changement de thème affecte toujours les deux formes parce que chacune fait référence de façon indépendante à la même couleur de thème.
Enregistrer et rouvrir le PPTX conserve le type de couleur copié renvoyé par ColorFormat.getColorType, la référence de thème et la collection de transformations renvoyée par ColorFormat.getColorTransform ; cela n’aplatit pas la définition en RGB.
Lors de la copie entre des contextes de thème différents, comme des présentations avec des palettes d’accent distinctes, la référence copiée se résout selon le thème de destination. La même référence et les mêmes transformations peuvent donc produire une couleur visible différente. Consultez Presentation Theme pour plus d’informations sur la configuration des couleurs de thème.
Use the Slide Background as a Shape Fill
Utilisez AutoShape.setUseBackgroundFill lorsqu’une forme doit correspondre à l’arrière‑plan de la diapositive, par exemple dans un modèle de présentation. Réglez le type de remplissage avec FillFormat.setFillType sur FillType.NotDefined d’abord pour supprimer tout remplissage explicite. Avec cette combinaison, la forme utilise l’arrière‑plan de la diapositive au lieu de son remplissage de style. Activer simplement le drapeau ne supprime pas un remplissage explicite existant.
Cela diffère de FillType.NoFill : le remplissage d’arrière‑plan couvre les objets derrière la forme avec la zone correspondante de l’arrière‑plan de la diapositive, tandis que aucun remplissage laisse ces objets visibles. Un dégradé reste aligné avec la diapositive plutôt que de recommencer à l’intérieur de chaque forme.
L’exemple suivant crée un arrière‑plan maître hérité par la diapositive et place une bande magenta derrière trois rectangles. Le rectangle de gauche utilise l’arrière‑plan, le rectangle du centre n’a aucun remplissage, et le rectangle de droite passe d’un remplissage d’arrière‑plan à un remplissage orange explicite.
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
let presentation = new aspose.slides.Presentation();
try {
presentation.getSlideSize().setSize(720, 400, aspose.slides.SlideSizeScaleType.DoNotScale);
let slide = presentation.getSlides().get_Item(0);
// Hériter du dégradé du maître.
slide.getBackground().setType(java.newByte(aspose.slides.BackgroundType.NotDefined));
slide.getLayoutSlide().getBackground().setType(java.newByte(aspose.slides.BackgroundType.NotDefined));
let background = slide.getLayoutSlide().getMasterSlide().getBackground();
background.setType(java.newByte(aspose.slides.BackgroundType.OwnBackground));
background.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Gradient));
let gradient = background.getFillFormat().getGradientFormat();
gradient.setGradientShape(java.newByte(aspose.slides.GradientShape.Linear));
gradient.setLinearGradientAngle(0);
gradient.getGradientStops().clear();
gradient.getGradientStops().add(0, java.newInstanceSync("java.awt.Color", 0, 0, 139));
gradient.getGradientStops().add(1, java.newInstanceSync("java.awt.Color", 135, 206, 250));
// Ajouter cet objet en premier afin qu'il apparaisse derrière les rectangles.
let band = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 25, 150, 670, 100);
band.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
band.getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "MAGENTA"));
band.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
let backgroundShape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 100, 160, 200);
backgroundShape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NotDefined));
backgroundShape.setUseBackgroundFill(true);
let noFillShape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 280, 100, 160, 200);
noFillShape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
let explicitShape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 510, 100, 160, 200);
explicitShape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NotDefined));
explicitShape.setUseBackgroundFill(true);
// Désactiver le remplissage d'arrière-plan avant d'appliquer un remplissage explicite.
explicitShape.setUseBackgroundFill(false);
explicitShape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
explicitShape.getFillFormat().getSolidFillColor().setColor(java.newInstanceSync("java.awt.Color", 255, 165, 0));
presentation.save("background_fill.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Le résultat, de gauche à droite : remplissage d’arrière‑plan, pas de remplissage, et remplissage explicite. La bande magenta est masquée par les rectangles gauche et droit mais reste visible à travers le rectangle du centre.

Le même comportement s’applique à un arrière‑plan défini directement sur la diapositive ou hérité d’une mise en page. La forme utilise l’arrière‑plan résolu de la diapositive ; l’exemple laisse les arrière‑plans de la diapositive et de la mise en page indéfinis afin que le maître le fournisse.
Set Transparency
Pour un remplissage solide, le composant alpha de la couleur contrôle l’opacité : 0 est totalement transparent et 255 totalement opaque. Cet exemple utilise une valeur alpha de 128 pour un rectangle jaune, le rendant approximativement à 50 % transparent afin que le rectangle situé en dessous reste visible. La couleur est assignée via FillFormat.getSolidFillColor.
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
let presentation = new aspose.slides.Presentation();
try {
let slide = presentation.getSlides().get_Item(0);
let solidShape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 50, 150, 75);
let transparentShape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 80, 80, 150, 75);
transparentShape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
transparentShape.getFillFormat().getSolidFillColor().setColor(java.newInstanceSync("java.awt.Color", 255, 255, 0, 128));
presentation.save("shape_transparency.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Le résultat :

Rotate Shapes
Utilisez Shape.setRotation pour faire pivoter une forme dans le plan de la diapositive. L’angle est mesuré en degrés ; cet exemple pivote un rectangle de 5 degrés dans le sens des aiguilles d’une montre et enregistre la présentation.
const aspose = { slides: { ? } };
Le résultat :

Add 3D Bevel Effects
Utilisez Shape.getThreeDFormat pour donner de la profondeur et des arêtes biseautées à une forme. Cet exemple crée une ellipse verte avec un contour orange, utilise ThreeDFormat.setDepth pour définir la profondeur à 4 points, et applique un biseau supérieur circulaire d’une largeur et hauteur de 6 points via ThreeDFormat.getBevelTop. Une caméra orthographique de face et un éclairage à trois points rendent le biseau visible.
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
let presentation = new aspose.slides.Presentation();
try {
let slide = presentation.getSlides().get_Item(0);
let shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Ellipse, 50, 50, 100, 100);
shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
shape.getFillFormat().getSolidFillColor().setColor(java.newInstanceSync("java.awt.Color", 0, 128, 0));
shape.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(java.newInstanceSync("java.awt.Color", 255, 165, 0));
shape.getLineFormat().setWidth(2.0);
shape.getThreeDFormat().setDepth(4);
shape.getThreeDFormat().getBevelTop().setBevelType(aspose.slides.BevelPresetType.Circle);
shape.getThreeDFormat().getBevelTop().setHeight(6);
shape.getThreeDFormat().getBevelTop().setWidth(6);
shape.getThreeDFormat().getCamera().setCameraType(aspose.slides.CameraPresetType.OrthographicFront);
shape.getThreeDFormat().getLightRig().setLightType(aspose.slides.LightRigPresetType.ThreePt);
shape.getThreeDFormat().getLightRig().setDirection(aspose.slides.LightingDirection.Top);
presentation.save("3D_bevel_effect.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Le résultat :

Add 3D Rotation Effects
La vue 3D d’une forme est contrôlée par les paramètres de sa caméra. Cet exemple utilise Camera.setRotation avec des angles de latitude, longitude et révolution de 40, 35 et 20 degrés respectivement. Il sélectionne une caméra isométrique via Camera.setCameraType et un éclairage équilibré via LightRig.setLightType, puis enregistre le rectangle formaté.
const aspose = { slides: require("aspose.slides.via.java") };
let presentation = new aspose.slides.Presentation();
try {
let slide = presentation.getSlides().get_Item(0);
let autoShape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 50, 150, 75);
autoShape.getTextFrame().setText("Hello, Aspose!");
autoShape.getThreeDFormat().getCamera().setCameraType(aspose.slides.CameraPresetType.IsometricLeftUp);
autoShape.getThreeDFormat().getCamera().setRotation(40, 35, 20);
autoShape.getThreeDFormat().getLightRig().setLightType(aspose.slides.LightRigPresetType.Balanced);
presentation.save("3D_rotation_effect.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Le résultat :

Control Black-and-White Rendering for Shapes
La méthode Shape.setBlackWhiteMode indique comment une forme individuelle est rendue lorsqu’une présentation est visualisée ou traitée en mode noir et blanc. Elle n’active pas l’affichage noir et blanc en soi, et ne modifie pas le remplissage, le contour ou autre formatage de la forme en mode couleur normal.
Utilisez une valeur de la classe BlackWhiteMode pour sélectionner le comportement souhaité. Par exemple, Automatic laisse l’application de rendu choisir la conversion, Gray et LightGray utilisent une coloration grise, BlackWhite n’emploie que le noir et blanc, Black et White imposent une couleur unique, Color préserve la coloration normale, et Hidden omet la forme en mode noir et blanc. NotDefined signifie qu’aucun mode au niveau de la forme n’est assigné.
Cet exemple crée un rectangle orange et utilise Shape.setBlackWhiteMode pour choisir la coloration grise. La forme enregistrée conserve son remplissage orange pour l’affichage couleur normal et demande une coloration grise aux applications respectant les paramètres d’affichage noir et blanc :
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
let presentation = new aspose.slides.Presentation();
try {
let slide = presentation.getSlides().get_Item(0);
let shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 50, 200, 100);
shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
shape.getFillFormat().getSolidFillColor().setColor(java.newInstanceSync("java.awt.Color", 255, 165, 0));
shape.setBlackWhiteMode(java.newByte(aspose.slides.BlackWhiteMode.Gray));
presentation.save("shape_black_white_mode.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
En mode couleur normal, le rectangle conserve son remplissage orange. En flux de travail d’affichage noir et blanc, il utilise la coloration grise parce que son mode est réglé sur Gray. Cela vous permet de préserver une diapositive en couleur complète tout en définissant une apparence distincte pour l’impression, la prévisualisation ou d’autres flux qui respectent les paramètres d’affichage noir et blanc de la présentation.
Reset Formatting
Utilisez Slide.reset pour restaurer la position, la taille et le formatage des espaces réservés de diapositive à partir de leurs espaces réservés de mise en page correspondants. Cet exemple nécessite une présentation existante avec des espaces réservés liés à la mise en page et réinitialise chaque diapositive avant l’enregistrement. Les formes sans espace réservé de mise en page correspondant ne sont pas réinitialisées.
const aspose = { slides: require("aspose.slides.via.java") };
let presentation = new aspose.slides.Presentation("sample.pptx");
try {
for (let i = 0; i < presentation.getSlides().size(); i++) {
let slide = presentation.getSlides().get_Item(i);
slide.reset();
}
presentation.save("reset_formatting.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
FAQ
Le formatage des formes influence‑t‑il la taille finale du fichier de présentation ?
Les couleurs, styles de ligne et paramètres d’effets ajoutent généralement peu de données comparés aux images intégrées et aux médias. Les remplissages d’image peuvent augmenter la taille du fichier car leurs images sont stockées dans la présentation.
Comment détecter les formes d’une diapositive partageant un formatage identique afin de les regrouper ?
Comparez les propriétés clés de formatage de chaque forme—remplissage, ligne et paramètres d’effet. Si toutes les valeurs correspondantes sont identiques, traitez leurs styles comme identiques et regroupez logiquement ces formes, ce qui simplifie la gestion ultérieure des styles.
Puis‑je enregistrer un ensemble de styles de forme personnalisés dans un fichier séparé pour les réutiliser dans d’autres présentations ?
Oui. Stockez des formes d’exemple avec les styles souhaités dans un jeu de diapositives modèle ou un fichier de modèle .POTX. Lors de la création d’une nouvelle présentation, ouvrez le modèle, clonez les formes stylisées dont vous avez besoin, et réappliquez leur formatage où nécessaire.