Formatar formas do PowerPoint no Android
Introdução
Formate formas no PowerPoint ajustando seus contornos, preenchimentos e efeitos. Aspose.Slides for Android via Java permite controlar essas configurações programaticamente, incluindo transparência, rotação e formatação 3D.

Aspose.Slides for Android via Java fornece interfaces e métodos que permitem formatar formas usando as mesmas opções disponíveis no PowerPoint.
Formatar Linhas
Use IShape.getLineFormat para controlar o contorno de uma forma. Este exemplo cria um retângulo sem preenchimento com um contorno azul tracejado. ILineFormat.setStyle seleciona uma linha composta grossa-fina, enquanto ILineFormat.setWidth define sua largura para 7 pontos e ILineFormat.setDashStyle seleciona o padrão de tracejado.
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();
}
O resultado:

Definir Padrões de Tracejado Personalizados
Use ILineFormat.setCustomDashPattern quando os estilos de linha predefinidos não fornecem os comprimentos de traço e espaço que você precisa, por exemplo para contornos de marca ou diagramas técnicos. Atribuir um padrão altera automaticamente o estilo de tracejado da linha para LineDashStyle.Custom.
As entradas do array alternam entre comprimentos de traço e espaço, começando com um traço. Cada valor é múltiplo da largura da linha: { 4, 2 } com largura de 3 pontos produz um traço de 12 pontos seguido por um espaço de 6 pontos. Use pares de valores finitos e não‑negativos para definir segmentos completos de traço‑e‑espaço. O exemplo usa valores positivos para manter cada traço e espaço visíveis.
Este exemplo cria cinco linhas azuis com o mesmo comprimento e cantos planos. As três primeiras comparam padrões com largura de 3 pontos. A quarta repete o primeiro padrão com o dobro da largura, dobrando os comprimentos de traço e espaço. A quinta troca de um padrão personalizado para uma linha sólida.
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]);
}
// Retornar a última linha para um estilo sólido.
slide.getShapes().get_Item(4).getLineFormat().setDashStyle(LineDashStyle.Solid);
presentation.save("custom_dash_patterns.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Para voltar a um estilo tracejado predefinido, passe LineDashStyle.Dash para ILineFormat.setDashStyle. O estilo selecionado controla a aparência da linha.
O resultado no PowerPoint, de cima para baixo: {4, 2}, 3 pt; {1, 2}, 3 pt; {6, 2, 1, 2}, 3 pt; {4, 2}, 6 pt; e Solid, 3 pt.

Definir Extremidades da Linha
Use ILineFormat.setCapStyle para definir as extremidades de uma linha aberta. A classe LineCapStyle fornece três estilos de extremidade explícitos:
Flat: O traço para no ponto final.Round: Uma extremidade semicircular estende-se além do ponto final em metade da largura da linha.Square: Uma extremidade quadrada estende-se além do ponto final em metade da largura da linha.
A classe também inclui NotDefined, que indica que nenhum estilo de extremidade foi atribuído explicitamente.
Extremidades são diferentes de pontas de seta, que adicionam símbolos nas pontas da linha, e de junções, que controlam cantos entre segmentos de linha. Este exemplo desabilita as pontas de seta através de ILineFormat.setBeginArrowheadStyle e ILineFormat.setEndArrowheadStyle para que apenas as formas das extremidades sejam comparadas.
O exemplo a seguir cria três linhas horizontais idênticas, 20 pontos de largura. De cima para baixo, elas usam extremidades flat, round e square. Seus pontos finais têm as mesmas coordenadas horizontais; as extremidades round e square estendem‑se 10 pontos além de cada ponto final.
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();
}
O resultado no PowerPoint, de cima para baixo: Flat, Round e Square.

Aplicar Efeitos de Esboço às Linhas da Forma
Um efeito de esboço faz a linha de uma forma parecer desenhada à mão. Use IShape.getLineFormat para acessar as configurações da linha, ILineFormat.getSketchFormat para acessar as configurações de esboço e ISketchFormat.setSketchType para selecionar um valor da classe LineSketchType.
O código Java a seguir mostra como aplicar um efeito LineSketchType.Curved, ler o valor atribuído explicitamente e remover o efeito com 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();
}
O valor retornado por ISketchFormat.getSketchType representa a configuração atribuída diretamente à forma. Se a formatação da linha puder ser herdada de um tema, slide mestre ou slide de layout, use ILineFormat.getEffective, acesse ILineFormatEffectiveData.getSketchFormat, e leia ISketchFormatEffectiveData.getSketchType. O valor efetivo reflete a formatação realmente aplicada após a resolução da herança. Este exemplo requer uma apresentação existente com ao menos uma forma no primeiro slide e imprime ambos os valores:
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();
}
Formatar Estilos de Junção
Aqui estão as três opções de tipo de junção:
- Round
- Miter
- Bevel
O estilo de junção controla como dois segmentos de contorno se encontram em um canto. Use Round para cantos arredondados, Miter para cantos agudos ou Bevel para cantos achatados.

Este exemplo cria três retângulos pretos com contornos azuis de 15 pontos de largura. Ele usa ILineFormat.setJoinStyle para aplicar os valores miter, bevel e round da classe LineJoinStyle, respectivamente, a fim de comparar como os cantos são desenhados.
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();
}
Limitar Junções Miter em Cantos Agudos
Use ILineFormat.setMiterLimit com ILineFormat.setJoinStyle definido para LineJoinStyle.Miter para limitar o quanto um canto agudo pode se estender.
O limite é uma razão entre a distância entre os cantos interno e externo da junção e a largura da linha. Por exemplo, um valor de 8 permite um comprimento de miter de até oito vezes a largura da linha; não se trata de uma medida em pontos. Se o canto exceder o limite, o PowerPoint usa uma junção chanfrada nesse canto. Um limite maior permite pontos mais afiados. A configuração afeta apenas junções miter e não tem efeito visível quando o canto permanece dentro dos limites.
Este exemplo cria dois triângulos idênticos, sem preenchimento, com contornos de 20 pontos de largura. O triângulo à esquerda usa limite 2 e o da direita usa 8. Cada triângulo tem 80 pontos de largura e 160 pontos de altura, dando ao seu canto superior uma razão comprimento‑de‑miter‑para‑largura‑da‑linha de aproximadamente 4.12. Consequentemente, o PowerPoint chanfrará o ápice esquerdo e preservará o ápice direito.
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();
}
O resultado no PowerPoint: Limite miter 2 à esquerda e limite miter 8 à direita.

Preenchimento em Gradiente
Um preenchimento em gradiente mistura cores ao longo de uma forma. Este exemplo preenche uma elipse com um gradiente linear em ângulo de 45 graus do vermelho ao roxo usando IFillFormat.getGradientFormat. O método IGradientStopCollection.addPresetColor coloca as paradas de cor em 0 e 1, início e fim do gradiente. Limpar as paradas existentes garante que apenas essas duas cores sejam usadas.
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();
}
O resultado:

Se um gradiente parecer diferente em uma imagem exportada do que no PowerPoint, veja Choose a Gradient Rendering Style. Você pode selecionar um estilo de renderização sem alterar o gradiente armazenado na apresentação.
Definir o Ângulo do Gradiente Linear
Use IGradientFormat.setLinearGradientAngle para controlar a orientação de um preenchimento GradientShape.Linear. O ângulo é medido em graus e aumenta no sentido horário: 0 vai da esquerda para a direita, 90 de cima para baixo, 180 da direita para a esquerda e 270 de baixo para cima. Ângulos fracionários são suportados. Ângulos finitos fora de [0, 360) são normalizados para uma revolução; por exemplo, -45 torna‑se 315 e 360 torna‑se 0.
Este exemplo cria seis retângulos com paradas de cor vermelha, verde e azul idênticas nas posições 0, 0.5 e 1. A escala está desativada para que o ângulo possa ser comparado independentemente das proporções dos retângulos. Os ângulos, da esquerda para a direita, são 0, 45 e 90 na primeira linha, e 135, 180 e 270 na segunda linha.
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();
}
O resultado no PowerPoint:

Escalar um Gradiente Linear com a Forma
IGradientFormat.setLinearGradientScaled aceita um valor NullableBool. Defina‑o explicitamente como False para manter o ângulo geométrico do gradiente enquanto as proporções da forma mudam, ou como True para escalar o gradiente com a largura e altura da forma. Com a escala habilitada, o ângulo visível pode diferir do ângulo atribuído em uma forma não quadrada.
O exemplo a seguir usa um ângulo de 45 graus e as mesmas paradas de cor do exemplo de comparação de ângulos. A coluna da esquerda usa False; a da direita usa True. Cada coluna contém um retângulo largo acima de um retângulo alto. Ambos começam com as mesmas dimensões largas; mudar a largura e a altura do segundo retângulo demonstra como o preenchimento responde ao redimensionamento sem mudar as configurações do gradiente.
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();
}
O resultado no PowerPoint, com escala desativada à esquerda e ativada à direita:

Com a escala desativada, as faixas de cor diagonais mantêm a mesma orientação em ambos os retângulos. Com a escala ativada, as faixas se esticam com as proporções da forma. Isso ajuda a reproduzir o gradiente de um modelo ao adaptar uma forma a um tamanho diferente. Em um quadrado, habilitar a escala não altera a aparência deste gradiente de 45 graus.
Tanto o ângulo quanto as configurações de escala se aplicam a gradientes lineares. Elas não controlam preenchimentos GradientShape.Radial ou GradientShape.Rectangle.
Combinar Ângulo com Direção do Gradiente
IGradientFormat.setGradientDirection seleciona um estilo de gradiente da classe GradientDirection; não substitui um ângulo numérico. Para um gradiente linear, os estilos de canto podem mudar a área sobre a qual as cores são distribuídas sem mudar o ângulo atribuído por setLinearGradientAngle. Mantenha a direção inalterada ao comparar ângulos ou escala.
O exemplo a seguir aplica as mesmas configurações em ordens opostas. Os dois retângulos têm a mesma aparência: atribuir a direção antes ou depois do ângulo não altera o resultado.
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();
}
Preenchimento de Padrão
Um preenchimento de padrão aplica um desenho bicromático, como pontos, listras ou xadrez. Este exemplo usa IPatternFormat.setPatternStyle para selecionar um padrão de treliça. IPatternFormat.getBackColor fornece o fundo cinza‑claro, e IPatternFormat.getForeColor fornece a cor amarela do padrão.
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();
}
O resultado:

Preenchimento com Imagem
Um preenchimento com imagem usa uma foto dentro de uma forma. Este exemplo requer uma imagem local e usa Images.fromFile para carregá‑la na coleção de imagens da apresentação. Definir IPictureFillFormat.setPictureFillMode como modo mosaico repete a imagem dentro do retângulo. A imagem‑fonte usada aqui é mostrada abaixo:

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

Mosaicar Imagem como Textura
Se desejar definir uma imagem mosaico como textura e personalizar o comportamento do mosaico, você pode usar os seguintes métodos da interface IPictureFillFormat e da classe PictureFillFormat:
- setPictureFillMode: Define o modo de preenchimento da imagem —
TileouStretch. - setTileAlignment: Especifica o alinhamento dos mosaicos dentro da forma.
- setTileFlip: Controla se o mosaico é espelhado horizontalmente, verticalmente ou ambos.
- setTileOffsetX: Define o deslocamento horizontal do mosaico (em pontos) a partir da origem da forma.
- setTileOffsetY: Define o deslocamento vertical do mosaico (em pontos) a partir da origem da forma.
- setTileScaleX: Define a escala horizontal do mosaico como porcentagem.
- setTileScaleY: Define a escala vertical do mosaico como porcentagem.
Este exemplo requer uma imagem local e configura IPictureFillFormat para repeti‑la em 50 % do tamanho original. Deslocamentos de −32 pontos deslocam os mosaicos horizontal e verticalmente; o alinhamento inferior‑direito e o espelhamento em ambas as direções determinam como a textura repetida é organizada.
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();
}
O resultado:

Preenchimento de Cor Sólida
Um preenchimento sólido dá à forma uma única cor uniforme. Este exemplo usa IFillFormat.setFillType para selecionar o modo de preenchimento sólido e atribui amarelo através de IFillFormat.getSolidFillColor, depois salva o retângulo em uma apresentação.
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();
}
O resultado:

Copiar Cores Preservando Referências de Tema
Use IColorFormat.copyFrom para copiar uma definição de cor, incluindo seu tipo de cor, referência de tema e transformações. Isso é útil ao transferir uma cor de preenchimento entre formas que devem continuar seguindo o tema da apresentação. O método copia apenas a cor: não copia o tipo de preenchimento, contorno ou outras formatações da forma. Defina explicitamente o tipo de preenchimento de destino com IFillFormat.setFillType.
Este exemplo cria três retângulos, da esquerda para a direita: a origem, uma cópia consciente de tema e uma cópia fixa em RGB. A origem usa IColorFormat.setSchemeColor para referenciar a primeira cor de destaque e adiciona um matiz através de IColorOperationCollection.add. A cópia RGB usa a cor de preenchimento efetiva da origem, de modo que as três inicialmente pareçam idênticas. Chamar IColorFormat.setColor define um valor RGB fixo e limpa quaisquer transformações de cor existentes.
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();
}
// As referências de tema seguem a nova cor de destaque; o valor RGB fixo não.
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();
}
Antes da mudança de tema, os três preenchimentos são iguais:

Depois da mudança de tema, a origem e a cópia consciente de tema seguem a nova cor de destaque e mantêm o matiz. A cópia RGB fixa permanece azul:

A definição copiada é independente da origem. Alterar posteriormente a referência de tema da origem, atribuir outra cor ou adicionar ou remover suas transformações não altera o destino. Uma mudança de tema ainda afeta ambas as formas porque cada uma refere‑se independentemente à mesma cor de tema.
Salvar e reabrir o PPTX preserva o tipo de cor copiado retornado por IColorFormat.getColorType, a referência de tema e a coleção de transformações retornada por IColorFormat.getColorTransform; não converte a definição para RGB.
Ao copiar entre contextos de tema diferentes, como apresentações com paletas de destaque distintas, a referência copiada é resolvida contra o tema do destino. A mesma referência e transformações podem, portanto, produzir uma cor visível diferente. Consulte Presentation Theme para mais informações sobre configuração de cores de tema.
Usar o Plano de Fundo do Slide como Preenchimento da Forma
Use IAutoShape.setUseBackgroundFill quando uma forma deve combinar com o plano de fundo do slide, por exemplo em um modelo de apresentação. Defina o tipo de preenchimento com IFillFormat.setFillType para FillType.NotDefined primeiro, a fim de remover qualquer preenchimento explícito. Com essa combinação, a forma usa o plano de fundo do slide em vez do seu preenchimento de estilo. Habilitar apenas a bandeira não remove um preenchimento explícito existente.
Isso difere de FillType.NoFill: preenchimento de fundo cobre objetos atrás da forma com a área correspondente do plano de fundo do slide, enquanto nenhum preenchimento deixa esses objetos visíveis. Um gradiente permanece alinhado ao slide ao invés de reiniciar dentro de cada forma.
O exemplo a seguir cria um plano de fundo mestre herdado pelo slide e coloca uma faixa magenta atrás de três retângulos. O retângulo da esquerda usa o plano de fundo, o do meio não tem preenchimento e o da direita troca de preenchimento de plano de fundo para um preenchimento laranja explícito.
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);
// Herda o gradiente do mestre.
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));
// Adicione este objeto primeiro para que ele apareça atrás dos retângulos.
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);
// Desative o preenchimento de fundo antes de aplicar um preenchimento explícito.
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();
}
O resultado, da esquerda para a direita: preenchimento de fundo, sem preenchimento e preenchimento explícito. A faixa magenta fica oculta pelos retângulos esquerdo e direito, mas permanece visível através do retângulo do meio.

O mesmo comportamento se aplica a um plano de fundo definido diretamente no slide ou herdado de um layout. A forma usa o plano de fundo resolvido do slide; o exemplo deixa ambos os planos de fundo do slide e do layout indefinidos para que o mestre os forneça.
Definir Transparência
Para um preenchimento sólido, o componente alfa da cor controla a opacidade: 0 é totalmente transparente e 255 totalmente opaco. Este exemplo usa um valor alfa de 128 para um retângulo amarelo, tornando‑o aproximadamente 50 % transparente para que o retângulo abaixo permaneça visível. A cor é atribuída via IFillFormat.getSolidFillColor.
import com.aspose.slides.*;
import android.graphics.Color;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape solidShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75);
IAutoShape transparentShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 80, 80, 150, 75);
transparentShape.getFillFormat().setFillType(FillType.Solid);
transparentShape.getFillFormat().getSolidFillColor().setColor(Color.argb(128, 255, 255, 0));
presentation.save("shape_transparency.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
O resultado:

Rotacionar Formas
Use IShape.setRotation para rotacionar uma forma no plano do slide. O ângulo é medido em graus; este exemplo rotaciona um retângulo 5 graus no sentido horário e salva a apresentação.
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();
}
O resultado:

Adicionar Efeitos de Chanfro 3D
Use IShape.getThreeDFormat para dar profundidade e bordas chanfradas a uma forma. Este exemplo cria uma elipse verde com contorno laranja, usa IThreeDFormat.setDepth para definir a profundidade em 4 pontos e aplica um chanfro superior circular com largura e altura de 6 pontos através de IThreeDFormat.getBevelTop. Uma câmera ortográfica frontal e iluminação de três pontos tornam o chanfro visível.
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();
}
O resultado:

Adicionar Efeitos de Rotação 3D
A visualização 3D de uma forma é controlada pelas configurações da câmera. Este exemplo usa ICamera.setRotation com ângulos de latitude, longitude e revolução de 40, 35 e 20 graus, respectivamente. Seleciona uma câmera isométrica através de ICamera.setCameraType e iluminação equilibrada via ILightRig.setLightType, depois salva o retângulo formatado.
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();
}
O resultado:

Controlar Renderização em Preto‑e‑Branco para Formas
O método IShape.setBlackWhiteMode especifica como uma forma individual é renderizada quando uma apresentação é visualizada ou processada em modo preto‑e‑branco. Ele não habilita a exibição em preto‑e‑branco por si só, nem altera o preenchimento, contorno ou outras formatações da forma no modo de cor normal.
Use um valor da classe BlackWhiteMode para selecionar o comportamento desejado. Por exemplo, Automatic deixa o aplicativo de renderização escolher a conversão, Gray e LightGray usam tonalidades de cinza, BlackWhite usa apenas preto e branco, Black e White forçam uma única cor, Color preserva a coloração normal e Hidden omite a forma no modo preto‑e‑branco. NotDefined significa que nenhum modo de forma foi atribuído.
Este exemplo cria um retângulo laranja e usa IShape.setBlackWhiteMode para selecionar a coloração cinza. A forma salva mantém seu preenchimento laranja para exibição em cor normal e solicita coloração cinza em aplicativos que respeitam as configurações de exibição em preto‑e‑branco:
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();
}
No modo de cor normal, o retângulo mantém seu preenchimento laranja. Em um fluxo de trabalho de exibição em preto‑e‑branco, ele usa coloração cinza porque seu modo está definido como Gray. Isso permite preservar um slide em cores completas ao definir uma aparência distinta para impressão, visualização ou outros fluxos que respeitam as configurações de exibição em preto‑e‑branco da apresentação.
Redefinir Formatação
Use ISlide.reset para restaurar a posição, tamanho e formatação de marcadores de posição de slide a partir de seus correspondentes marcadores de layout. Este exemplo requer uma apresentação existente com marcadores vinculados ao layout e redefine todos os slides antes de salvar. Formas sem marcadores de layout correspondentes não são redefinidas.
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
A formatação de forma afeta o tamanho final do arquivo da apresentação?
Cores, estilos de linha e configurações de efeito geralmente adicionam poucos dados comparados a imagens e mídia incorporadas. Preenchimentos com imagens podem aumentar o tamanho do arquivo porque suas imagens são armazenadas na apresentação.
Como detectar formas em um slide que compartilham formatação idêntica para que eu possa agrupá‑las?
Compare as principais propriedades de formatação de cada forma — preenchimento, linha e configurações de efeito. Se todos os valores correspondentes coincidirem, trate seus estilos como idênticos e agrupe logicamente essas formas, o que simplifica o gerenciamento de estilo posterior.
Posso salvar um conjunto de estilos de forma personalizados em um arquivo separado para reutilizar em outras apresentações?
Sim. Armazene formas de exemplo com os estilos desejados em um slide‑modelo ou em um arquivo de modelo .POTX. Ao criar uma nova apresentação, abra o modelo, clone as formas estilizadas que precisar e reaplique sua formatação onde for necessário.