Adicionar Retângulos a Apresentações no Android

Visão geral

Este artigo mostra como adicionar formas retangulares aos slides do PowerPoint usando Aspose.Slides. Ele cobre a criação de um retângulo simples, a criação de um retângulo formatado e a gravação da apresentação atualizada como um arquivo PPTX.

Você também verá como aplicar formatação básica ao retângulo, como cor de preenchimento sólido, cor da linha e largura da linha. Além disso, a seção de FAQ do artigo aponta para tarefas relacionadas ao retângulo, incluindo cantos arredondados, preenchimentos com imagem, efeitos visuais, hyperlinks, bloqueios de forma, opções de exportação e propriedades efetivas.

Adicionar um retângulo a um slide

Para adicionar um retângulo simples a um slide selecionado da apresentação, siga as etapas abaixo:

• Crie uma instância da classe Presentation.
• Obtenha a referência de um slide usando seu Índice.
• Adicione um IAutoShape do tipo Rectangle usando o método addAutoShape exposto pelo objeto IShapeCollection.
• Grave a apresentação modificada como um arquivo PPTX.

No exemplo abaixo, adicionamos um retângulo simples ao primeiro slide da apresentação.

// Instanciar a classe Presentation que representa o PPTX
Presentation pres = new Presentation();
try {
    // Obter o primeiro slide
    ISlide sld = pres.getSlides().get_Item(0);

    // Adicionar AutoShape do tipo elipse
    IShape shp = sld.getShapes().addAutoShape(ShapeType.Rectangle, 50, 150, 150, 50);

    // Gravar o arquivo PPTX no disco
    pres.save("RecShp1.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Adicionar um retângulo formatado a um slide

Para adicionar um retângulo formatado a um slide, siga as etapas abaixo:

• Crie uma instância da classe Presentation.
• Obtenha a referência de um slide usando seu Índice.
• Adicione um IAutoShape do tipo Rectangle usando o método addAutoShape exposto pelo objeto IShapeCollection.
• Defina o Fill Type do retângulo como Solid.
• Defina a cor do retângulo usando o método SolidFillColor.setColor exposto pelo objeto IFillFormat associado ao objeto IShape.
• Defina a cor das linhas do retângulo.
• Defina a largura das linhas do retângulo.
• Grave a apresentação modificada como um arquivo PPTX.

As etapas acima são implementadas no exemplo abaixo.

// Instanciar a classe Presentation que representa o PPTX
Presentation pres = new Presentation();
try {
    // Obter o primeiro slide
    ISlide sld = pres.getSlides().get_Item(0);

    // Adicionar AutoShape do tipo elipse
    IShape shp = sld.getShapes().addAutoShape(ShapeType.Rectangle, 50, 150, 150, 50);

    // Aplicar alguma formatação à forma elipse
    shp.getFillFormat().setFillType(FillType.Solid);
    shp.getFillFormat().getSolidFillColor().setColor(Color.GRAY);

    // Aplicar alguma formatação à linha da elipse
    shp.getLineFormat().getFillFormat().setFillType(FillType.Solid);
    shp.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    shp.getLineFormat().setWidth(5);

    // Gravar o arquivo PPTX no disco
    pres.save("RecShp2.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

FAQ

Como adiciono um retângulo com cantos arredondados?

Use o shape type de canto arredondado e ajuste o raio do canto nas propriedades da forma; o arredondamento também pode ser aplicado por canto via ajustes de geometria.

Como preencho um retângulo com uma imagem (textura)?

Selecione o fill type de imagem, forneça a origem da imagem e configure os modos de stretching/tiling.

Um retângulo pode ter sombra e brilho?

Sim. Outer/inner shadow, glow, and soft edges estão disponíveis com parâmetros ajustáveis.

Posso transformar um retângulo em um botão com hyperlink?

Sim. Assign a hyperlink ao clique da forma (ir para um slide, arquivo, endereço web ou e‑mail).

Como posso proteger um retângulo contra movimento e alterações?

Use bloqueios de forma: você pode impedir mover, redimensionar, selecionar ou editar texto para preservar o layout.

Posso converter um retângulo em imagem raster ou SVG?

Sim. Você pode render the shape para uma imagem com tamanho/escala especificados ou exportá‑lo como SVG para uso vetorial.

Como obtenho rapidamente as propriedades reais (efetivas) de um retângulo considerando tema e herança?

Use the shape’s effective properties: a API devolve valores computados que consideram estilos de tema, layout e configurações locais, simplificando a análise de formatação.