Adicionar Formas de Linha a Apresentações no Android

Visão geral

Aspose.Slides permite adicionar formas de linha a slides do PowerPoint programaticamente. Este artigo mostra como criar uma linha simples e como personalizar uma linha para que ela apareça como uma seta.

Você aprenderá como adicionar uma forma de linha a um slide, ajustar sua aparência visual e salvar a apresentação atualizada. Os exemplos focam em configurações práticas de formatação de linha, como estilo, largura, padrão de traço, opções de ponta de seta e cor de preenchimento.

Criar uma Linha Simples

Para adicionar uma linha simples a um slide selecionado da apresentação, siga os passos abaixo:

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

No exemplo abaixo, adicionamos uma linha ao primeiro slide da apresentação.

// Instanciar a classe PresentationEx que representa o arquivo PPTX
Presentation pres = new Presentation();
try {
    // Obter o primeiro slide
    ISlide sld = pres.getSlides().get_Item(0);
    
    // Adicionar um AutoShape do tipo linha
    sld.getShapes().addAutoShape(ShapeType.Line, 50, 150, 300, 0);
    
    // Gravar o PPTX no disco
    pres.save("LineShape.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Criar uma Linha em Forma de Seta

Aspose.Slides for Android via Java também permite que os desenvolvedores configurem algumas propriedades da linha para que ela pareça mais atraente. Vamos tentar configurar algumas propriedades de uma linha para que ela se pareça com uma seta. Siga os passos abaixo para isso:

• Crie uma instância da classe Presentation.
• Obtenha a referência de um slide usando seu Índice.
• Adicione um AutoShape do tipo Line usando o método addAutoShape exposto pelo objeto IShapeCollection.
• Defina o Line Style para um dos estilos oferecidos pelo Aspose.Slides for Android via Java.
• Defina a Largura da linha.
• Defina o Dash Style da linha para um dos estilos oferecidos pelo Aspose.Slides for Android via Java.
• Defina o Arrow Head Style e o Length do ponto inicial da linha.
• Defina o Arrow Head Style e o Length do ponto final da linha.
• Grave a apresentação modificada como um arquivo PPTX.

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

    // Adicionar um AutoShape do tipo linha
    IAutoShape shp = sld.getShapes().addAutoShape(ShapeType.Line, 50, 150, 300, 0);

    // Aplicar alguma formatação na linha
    shp.getLineFormat().setStyle(LineStyle.ThickBetweenThin);
    shp.getLineFormat().setWidth(10);

    shp.getLineFormat().setDashStyle(LineDashStyle.DashDot);

    shp.getLineFormat().setBeginArrowheadLength(LineArrowheadLength.Short);
    shp.getLineFormat().setBeginArrowheadStyle(LineArrowheadStyle.Oval);

    shp.getLineFormat().setEndArrowheadLength(LineArrowheadLength.Long);
    shp.getLineFormat().setEndArrowheadStyle(LineArrowheadStyle.Triangle);

    shp.getLineFormat().getFillFormat().setFillType(FillType.Solid);
    shp.getLineFormat().getFillFormat().getSolidFillColor().setColor(new Color(PresetColor.Maroon));

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

Perguntas Frequentes

Posso converter uma linha normal em um conector para que ela “encaixe” nas formas?

Não. Uma linha normal (um AutoShape do tipo Line) não se torna automaticamente um conector. Para que ela encaixe nas formas, use o tipo dedicado Connector e as APIs correspondentes para conexões.

O que devo fazer se as propriedades de uma linha forem herdadas do tema e for difícil determinar os valores finais?

Leia as propriedades efetivas através das interfaces ILineFormatEffectiveData/ILineFillFormatEffectiveData — elas já consideram herança e estilos de tema.

Posso bloquear uma linha contra edição (movimento, redimensionamento)?

Sim. As formas fornecem objetos de bloqueio que permitem impedir operações de edição.