Aplicar ou Alterar Layouts de Slides no .NET

Sobre o que é esta página

Aplique, crie e modifique layouts de slides no Aspose.Slides para .NET, adicione marcadores de posição, remova layouts não utilizados e controle a visibilidade do rodapé.

Visão geral

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

Os layouts mais comuns incluem:

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 todas as formas serão posicionadas manualmente.

Compreender a Herança de Layouts

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

Um master slide define o tema, a formatação compartilhada, os fundos e os objetos comuns.
Um layout slide pertence a um master e define um arranjo específico de marcadores de posição.
Um normal slide usa um layout e armazena o conteúdo inserido naquele slide.

Um slide normal herda tema e formatação do seu layout, e o layout herda do seu master. Um valor definido diretamente em um slide normal substitui o valor herdado nesse 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. Inserir outro marcador de posição em um layout posteriormente não adiciona automaticamente uma forma de marcador correspondente aos slides normais existentes.

Esse relacionamento tem duas consequências importantes:

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

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

Para ocultar logotipos herdados ou formas de master decorativas em um slide ou por meio de um layout compartilhado, veja Control the Visibility of Master Graphics. O exemplo compara dois slides que usam o mesmo master.

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 de layout são editáveis pelo usuário e podem ser localizados, portanto a seleção baseada em nome é menos confiável a menos que você controle o modelo de origem.

O exemplo a seguir procura Título e Conteúdo no primeiro master. Caso esse layout não esteja disponível, ele recai deliberadamente para Em branco. A segunda verificação de nulo é necessária porque uma apresentação pode conter apenas layouts personalizados. O layout selecionado é então aplicado ao primeiro slide normal por meio da propriedade ISlide.LayoutSlide.

using System;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("input.pptx");

var layoutSlides = presentation.Masters[0].LayoutSlides;
var targetLayout = layoutSlides.GetByType(SlideLayoutType.TitleAndObject) ?? layoutSlides.GetByType(SlideLayoutType.Blank);

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

presentation.Slides[0].LayoutSlide = targetLayout;
presentation.Save("output-with-new-layout.pptx", SaveFormat.Pptx);

Alterar o layout de um slide não remove as formas normais adicionadas diretamente ao slide. Contudo, as posições dos marcadores, a formatação herdada e a correspondência entre os marcadores existentes e o novo layout podem mudar, portanto inspecione a saída ao trocar entre layouts substancialmente diferentes.

Adicionar um Layout Slide

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

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

using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("input.pptx");

var masterSlide = presentation.Masters[0];
var reportLayout = masterSlide.LayoutSlides.Add(SlideLayoutType.TitleAndObject, "Report Title and Content");
presentation.Slides.AddEmptySlide(reportLayout);

presentation.Save("output-with-report-layout.pptx", SaveFormat.Pptx);

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

Adicionar Marcadores de Posição a um Layout Slide

A propriedade ILayoutSlide.PlaceholderManager fornece um ILayoutPlaceholderManager para adicionar formas de marcador de posição a um layout.

Placeholder 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 a ele e, em seguida, cria um slide normal que usa o layout modificado. A ordem é intencional: os marcadores são adicionados antes da criação do slide normal, permitindo que o Aspose.Slides gere as formas de marcador correspondentes naquele slide.

using System;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation();

var blankLayout = presentation.LayoutSlides.GetByType(SlideLayoutType.Blank);

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

var placeholderManager = blankLayout.PlaceholderManager;
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.Slides.AddEmptySlide(blankLayout);
presentation.Save("output-with-placeholders.pptx", SaveFormat.Pptx);

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 alterações de layout em uma cópia da apresentação e inspecione cada slide dependente.

Remover Layout Slides Não Utilizados

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.

using Aspose.Slides;
using Aspose.Slides.Export;
using Aspose.Slides.LowCode;

using var presentation = new Presentation("input.pptx");

Compress.RemoveUnusedLayoutSlides(presentation);
presentation.Save("output-without-unused-layouts.pptx", SaveFormat.Pptx);

Para remover um layout específico, primeiro use sua propriedade HasDependingSlides ou o método 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 Layout Slide

Um layout possui seus próprios marcadores de rodapé, número do slide e data/hora. Use a propriedade ILayoutSlide.HeaderFooterManager para controlar esses marcadores em um layout. Isso é útil quando, por exemplo, os layouts de conteúdo devem mostrar rodapés, mas os layouts de título não.

O exemplo a seguir seleciona um layout com segurança e torna seus elementos de rodapé visíveis:

using System;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("input.pptx");

var layoutSlide = presentation.LayoutSlides.GetByType(SlideLayoutType.TitleAndObject) ?? presentation.LayoutSlides.GetByType(SlideLayoutType.Blank);

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

var headerFooterManager = layoutSlide.HeaderFooterManager;
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);

Controlar a Visibilidade do Rodapé em um Master e Seus Layouts Filhos

Para aplicar definições consistentes de rodapé em toda a hierarquia de masters, use a propriedade IMasterSlide.HeaderFooterManager. Os métodos de propagação de IMasterSlideHeaderFooterManager atuam no master, nos seus slides de layout dependentes e nos slides normais; não visam apenas um slide normal.

using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("input.pptx");

var headerFooterManager = presentation.Masters[0].HeaderFooterManager;
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);

FAQ

Qual é a diferença entre um Master Slide e um Layout Slide?

Um master slide define o tema da apresentação e a formatação compartilhada. Um layout slide pertence a um master 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 Layout Slide 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 se eu modificar um layout que já está em uso?

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

O que ocorre 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 layouts não referenciados.

Comparar Slides de Apresentação em .NET Alterar o tamanho do slide da apresentação no .NET