Aplicar ou Alterar Layouts de Slide no Android

Sobre o que é esta página

Aplicar, criar e modificar layouts de slide no Aspose.Slides para Android via Java, adicionar marcadores de posição, remover layouts não usados e controlar a visibilidade do rodapé.

Visão geral

Um layout de slide define as posições e a formatação dos marcadores de posição, como títulos, texto, imagens, gráficos e tabelas. Aplicar um layout fornece aos slides uma estrutura consistente, ao mesmo tempo que permite que cada slide contenha seu próprio conteúdo.

Slide de Título: Contém marcadores de posição de título e subtítulo.
Título e Conteúdo: Contém um marcador de posição de título e um marcador de posição de conteúdo de uso geral.
Em branco: Não contém marcadores de posição de conteúdo e é útil quando cada forma será posicionada manualmente.

Compreender a herança de layout

Uma apresentação tem três níveis relacionados:

A slide mestre define o tema, a formatação compartilhada, os planos de fundo e os objetos comuns.
A slide de layout pertence a um mestre e define um arranjo específico de marcadores de posição.
A slide normal usa um layout e armazena o conteúdo inserido para esse slide.

Um slide normal herda o tema e a formatação do seu layout, e o layout herda do seu mestre. Um valor definido diretamente em um slide normal substitui o valor herdado naquele nível. Quando um slide normal é criado, suas formas de marcador de posição são geradas a partir do layout selecionado, enquanto o conteúdo inserido nesses marcadores pertence ao slide normal.

Adicione os marcadores de posição necessários a um layout antes de criar slides a partir dele. Adicionar outro marcador de posição a um layout posteriormente não adiciona automaticamente a forma de marcador correspondente aos slides normais existentes.

Essa relação tem duas consequências importantes:

Alterar a formatação herdada ou a geometria dos marcadores de posição existentes em um layout pode atualizar todos os slides que dependem dele. Antes de editar um layout que já está em uso, inspecione seus slides dependentes e revise a apresentação resultante.
Um layout que ainda é usado por um slide não pode ser removido. Reatribua seus slides dependentes a outro layout primeiro, ou remova apenas layouts não usados.

Para obter mais informações sobre o nível superior dessa hierarquia, veja Slide Mestre.

Para ocultar logotipos herdados ou formas decorativas do mestre em um slide ou por meio de um layout compartilhado, veja Controlar a Visibilidade de Gráficos do Mestre. O exemplo compara dois slides que usam o mesmo mestre.

Selecionar e aplicar um layout de slide

Use um tipo de layout quando a apresentação segue as definições padrão de layout do PowerPoint. Os nomes dos layouts podem ser editados pelo usuário e localizados, portanto a seleção baseada em nome é menos confiável a menos que você controle o modelo fonte.

O exemplo a seguir procura Título e Conteúdo no primeiro mestre. Se esse layout não estiver disponível, ele recai deliberadamente para Em branco. A segunda verificação de nulidade é necessária porque uma apresentação pode conter apenas layouts personalizados. O layout selecionado é então aplicado ao primeiro slide normal através do método ISlide.setLayoutSlide.

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    IMasterLayoutSlideCollection layoutSlides = presentation.getMasters().get_Item(0).getLayoutSlides();
    ILayoutSlide targetLayout = layoutSlides.getByType(SlideLayoutType.TitleAndObject);

    if (targetLayout == null) {
        targetLayout = layoutSlides.getByType(SlideLayoutType.Blank);
    }

    if (targetLayout == null) {
        throw new IllegalStateException("The first master does not contain a suitable layout slide.");
    }

    presentation.getSlides().get_Item(0).setLayoutSlide(targetLayout);
    presentation.save("output-with-new-layout.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Alterar o layout de um slide não remove as formas ordinárias adicionadas diretamente ao slide. Contudo, as posições dos marcadores de posição, a formatação herdada e a correspondência entre marcadores existentes e o novo layout podem mudar, portanto inspecione o resultado ao alternar entre layouts substancialmente diferentes.

Adicionar um slide de layout

Seleção e criação são operações separadas. O exemplo anterior seleciona um layout existente; ele não cria um. Para criar um layout, chame o método IMasterLayoutSlideCollection.add na coleção de layouts do mestre de destino.

O exemplo a seguir sempre adiciona um novo layout Título e Conteúdo chamado Report Title and Content, depois adiciona um slide normal baseado nele. Os nomes dos layouts devem ser exclusivos dentro da coleção.

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    IMasterSlide masterSlide = presentation.getMasters().get_Item(0);
    ILayoutSlide reportLayout = masterSlide.getLayoutSlides().add(SlideLayoutType.TitleAndObject, "Report Title and Content");
    presentation.getSlides().addEmptySlide(reportLayout);

    presentation.save("output-with-report-layout.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Adicione um layout apenas quando o modelo realmente precisar de outra estrutura reutilizável. Se um layout adequado já existir, selecione‑o e reutilize‑o em vez de criar um duplicado.

Adicionar marcadores de posição a um slide de layout

O método ILayoutSlide.getPlaceholderManager fornece um ILayoutPlaceholderManager para adicionar formas de marcador de posição a um layout.

Marcador de posição do PowerPoint	Método `ILayoutPlaceholderManager`
	`addContentPlaceholder(float x, float y, float width, float height)`
	`addVerticalContentPlaceholder(float x, float y, float width, float height)`
	`addTextPlaceholder(float x, float y, float width, float height)`
	`addVerticalTextPlaceholder(float x, float y, float width, float height)`
	`addPicturePlaceholder(float x, float y, float width, float height)`
	`addChartPlaceholder(float x, float y, float width, float height)`
	`addTablePlaceholder(float x, float y, float width, float height)`
	`addSmartArtPlaceholder(float x, float y, float width, float height)`
	`addMediaPlaceholder(float x, float y, float width, float height)`
	`addOnlineImagePlaceholder(float x, float y, float width, float height)`

O exemplo a seguir verifica se o layout Em branco existe, adiciona quatro marcadores de posição a ele e, em seguida, cria um slide normal que usa o layout modificado. A ordem é intencional: os marcadores de posição são adicionados antes da criação do slide normal, para que o Aspose.Slides possa gerar as formas de marcador correspondentes nesse slide.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ILayoutSlide blankLayout = presentation.getLayoutSlides().getByType(SlideLayoutType.Blank);

    if (blankLayout == null) {
        throw new IllegalStateException("The presentation does not contain a Blank layout slide.");
    }

    ILayoutPlaceholderManager placeholderManager = blankLayout.getPlaceholderManager();
    placeholderManager.addContentPlaceholder(20, 20, 310, 270);
    placeholderManager.addVerticalTextPlaceholder(350, 20, 350, 270);
    placeholderManager.addChartPlaceholder(20, 310, 310, 180);
    placeholderManager.addTablePlaceholder(350, 310, 350, 180);

    presentation.getSlides().addEmptySlide(blankLayout);
    presentation.save("output-with-placeholders.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

O resultado:

Os marcadores de posição no slide de layout

Aviso

Alterar a formatação herdada ou a geometria dos marcadores de posição existentes em um layout pode afetar os slides dependentes. Um marcador de posição de layout recém‑adicionado não é preenchido retroativamente em slides normais existentes. Teste as alterações de layout em uma cópia da apresentação e inspecione cada slide dependente.

Remover slides de layout não usados

Use o método Compress.removeUnusedLayoutSlides para remover layouts que nenhum slide normal referencia. O método deixa intactos os layouts que ainda estão em uso.

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    Compress.removeUnusedLayoutSlides(presentation);
    presentation.save("output-without-unused-layouts.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Para remover um layout específico, primeiro use seu método hasDependingSlides ou getDependingSlides. Reatribua quaisquer slides dependentes antes de chamar ILayoutSlide.remove. Tentar remover um layout em uso gera uma PptxEditException.

Controlar a visibilidade do rodapé em um slide de layout

Um layout possui seu próprio rodapé, número de slide e marcadores de posição de data/hora. Use o método ILayoutSlide.getHeaderFooterManager para controlar esses marcadores de posição em um único layout. Isso é útil quando, por exemplo, layouts de conteúdo devem exibir rodapés, mas layouts de título não devem.

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    ILayoutSlide layoutSlide = presentation.getLayoutSlides().getByType(SlideLayoutType.TitleAndObject);

    if (layoutSlide == null) {
        layoutSlide = presentation.getLayoutSlides().getByType(SlideLayoutType.Blank);
    }

    if (layoutSlide == null) {
        throw new IllegalStateException("The presentation does not contain a suitable layout slide.");
    }

    ILayoutSlideHeaderFooterManager headerFooterManager = layoutSlide.getHeaderFooterManager();
    headerFooterManager.setFooterVisibility(true);
    headerFooterManager.setSlideNumberVisibility(true);
    headerFooterManager.setDateTimeVisibility(true);
    headerFooterManager.setFooterText("Footer text");
    headerFooterManager.setDateTimeText("Date and time text");

    presentation.save("output-with-layout-footers.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Controlar a visibilidade do rodapé em um mestre e seus layouts filhos

Para aplicar configurações de rodapé consistentes em toda a hierarquia de mestres, use o método IMasterSlide.getHeaderFooterManager. Os métodos de propagação de IMasterSlideHeaderFooterManager atuam no mestre e em seus slides de layout e slides normais dependentes; eles não visam apenas um slide normal.

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    IMasterSlideHeaderFooterManager headerFooterManager = presentation.getMasters().get_Item(0).getHeaderFooterManager();
    headerFooterManager.setFooterAndChildFootersVisibility(true);
    headerFooterManager.setSlideNumberAndChildSlideNumbersVisibility(true);
    headerFooterManager.setDateTimeAndChildDateTimesVisibility(true);
    headerFooterManager.setFooterAndChildFootersText("Footer text");
    headerFooterManager.setDateTimeAndChildDateTimesText("Date and time text");

    presentation.save("output-with-master-footers.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Perguntas frequentes

Qual é a diferença entre um slide mestre e um slide de layout?

Um slide mestre define o tema da apresentação e a formatação compartilhada. Um slide de layout pertence a um mestre e define um arranjo reutilizável de marcadores de posição. Slides normais utilizam esses layouts e armazenam o conteúdo específico de cada slide.

Posso copiar um slide de layout de uma apresentação para outra?

Sim. Adicione uma cópia à coleção de destino com o método addClone. Ao copiar entre apresentações, verifique também fontes, temas, imagens e outros recursos usados pelo layout de origem.

O que acontece quando modifico um layout que já está em uso?

Slides dependentes herdam as alterações do layout, a menos que sobrescrevam localmente a formatação ou os objetos afetados. A geometria dos marcadores de posição e o estilo herdado podem, portanto, mudar em muitos slides de uma só vez. Use getDependingSlides para identificar os slides afetados antes de editar o layout.

O que acontece se eu remover um layout que ainda está em uso?

O Aspose.Slides lança uma PptxEditException. Reatribua primeiro os slides dependentes ou use removeUnusedLayoutSlides para remover apenas os layouts não referenciados.

Comparar Slides de Apresentação no Android Gerenciar Mestres de Slides de Apresentação no Android