Cabeçalho e rodapé em apresentações do PowerPoint são usados para exibir informações adicionais, como número do slide, autor, data etc. Neste artigo, você aprenderá como adicionar e gerenciar o cabeçalho e o rodapé em apresentações do PowerPoint PPTX/PPT programaticamente usando C#.
- API .NET para gerenciar cabeçalho e rodapé no PowerPoint
- Adicionar cabeçalho e rodapé na apresentação do PowerPoint
- Gerenciar Cabeçalho e Rodapé no Folheto e Slide de Notas
API .NET para gerenciar cabeçalho e rodapé no PowerPoint
Para trabalhar com cabeçalho e rodapé em apresentações do PowerPoint, usaremos Aspose.Slides for .NET. É uma biblioteca de classes .NET que permite criar e manipular documentos PowerPoint e OpenOffice. Você pode baixar a DLL da API na seção downloads. Além disso, a API pode ser instalada via NuGet.
PM> Install-Package Aspose.Slides.NET
Adicionar cabeçalho e rodapé no PowerPoint usando C#
A seguir estão as etapas para adicionar cabeçalho e rodapé em uma apresentação do PowerPoint usando C#.
- Primeiro, crie uma nova apresentação ou carregue uma existente usando a classe Apresentação.
- Em seguida, defina o rodapé usando o método Presentation.HeaderFooterManager.SetAllFootersText(string).
- Acesse o slide de notas mestre em um objeto IMasterNotesSlide usando a propriedade Presentation.MasterNotesSlideManager.MasterNotesSlide.
- Faça um loop em cada forma na coleção IMasterNotesSlide.Shapes.
- Se IShape.Placeholder.Type for PlaceholderType.Header, defina o texto para o cabeçalho usando a propriedade ((IAutoShape)shape).TextFrame.Text.
- Finalmente, salve a apresentação usando o método Presentation.Save(string, SaveFormat).
O exemplo de código a seguir mostra como adicionar cabeçalho e rodapé em uma apresentação do PowerPoint.
// Carregar apresentação
Presentation pres = new Presentation("headerTest.pptx");
// Definir rodapé
pres.HeaderFooterManager.SetAllFootersText("My Footer text");
pres.HeaderFooterManager.SetAllFootersVisibility(true);
// Cabeçalho de acesso e atualização
IMasterNotesSlide masterNotesSlide = pres.MasterNotesSlideManager.MasterNotesSlide;
if (null != masterNotesSlide)
{
foreach (IShape shape in masterNotesSlide.Shapes)
{
if (shape.Placeholder != null)
{
if (shape.Placeholder.Type == PlaceholderType.Header)
{
((IAutoShape)shape).TextFrame.Text = "HI there new header";
}
}
}
}
// Salvar apresentação
pres.Save("HeaderFooter.pptx", SaveFormat.Pptx);
Gerenciar cabeçalho e rodapé no folheto e no slide de anotações usando C#
Aspose.Slides para .NET também permite que você defina o cabeçalho e rodapé em slides de notas e folhetos. Para isso, você pode aplicar alterações no slide de notas mestre ou em um slide individual. As seções a seguir cobrem os dois cenários.
Alterar as configurações de cabeçalho e rodapé para o Notes Master
- Primeiro, crie uma nova apresentação ou carregue uma existente usando a classe Apresentação.
- Em seguida, acesse o slide de notas mestre em um objeto IMasterNotesSlide usando a propriedade Presentation.MasterNotesSlideManager.MasterNotesSlide.
- Obtenha a referência de IMasterNotesSlideHeaderFooterManager da propriedade IMasterNotesSlide.HeaderFooterManager.
- Atualize o rodapé do cabeçalho usando o objeto IMasterNotesSlideHeaderFooterManager.
- Finalmente, salve a apresentação usando o método Presentation.Save(string, SaveFormat).
O exemplo de código a seguir mostra como alterar o cabeçalho e o rodapé no mestre de notas usando C#.
using (Presentation presentation = new Presentation("presentation.pptx"))
{
// Alterar as configurações de cabeçalho e rodapé para notas mestre e todos os slides de notas
IMasterNotesSlide masterNotesSlide = presentation.MasterNotesSlideManager.MasterNotesSlide;
if (masterNotesSlide != null)
{
IMasterNotesSlideHeaderFooterManager headerFooterManager = masterNotesSlide.HeaderFooterManager;
headerFooterManager.SetHeaderAndChildHeadersVisibility(true); // make the master notes slide and all child Footer placeholders visible
headerFooterManager.SetFooterAndChildFootersVisibility(true); // make the master notes slide and all child Header placeholders visible
headerFooterManager.SetSlideNumberAndChildSlideNumbersVisibility(true); // make the master notes slide and all child SlideNumber placeholders visible
headerFooterManager.SetDateTimeAndChildDateTimesVisibility(true); // make the master notes slide and all child Date and time placeholders visible
headerFooterManager.SetHeaderAndChildHeadersText("Header text"); // set text to master notes slide and all child Header placeholders
headerFooterManager.SetFooterAndChildFootersText("Footer text"); // set text to master notes slide and all child Footer placeholders
headerFooterManager.SetDateTimeAndChildDateTimesText("Date and time text"); // set text to master notes slide and all child Date and time placeholders
}
// Salvar apresentação
presentation.Save("testresult.pptx",SaveFormat.Pptx);
}
Alterar as configurações de cabeçalho e rodapé para o slide de notas
- Primeiro, crie uma nova apresentação ou carregue uma existente usando a classe Apresentação.
- Em seguida, acesse o objeto INotesSlide do slide desejado usando a propriedade Presentation.Slides[index].NotesSlideManager.NotesSlide.
- Obtenha a referência de INotesSlideHeaderFooterManager da propriedade INotesSlide.HeaderFooterManager.
- Atualize o rodapé do cabeçalho usando o objeto INotesSlideHeaderFooterManager.
- Finalmente, salve a apresentação usando o método Presentation.Save(string, SaveFormat).
O exemplo de código a seguir mostra como alterar o cabeçalho e o rodapé em slides de anotações usando C#.
// Carregar apresentação
using (Presentation presentation = new Presentation("presentation.pptx"))
{
// Alterar as configurações de cabeçalho e rodapé apenas para o primeiro slide de notas
INotesSlide notesSlide = presentation.Slides[0].NotesSlideManager.NotesSlide;
if (notesSlide != null)
{
INotesSlideHeaderFooterManager headerFooterManager = notesSlide.HeaderFooterManager;
if (!headerFooterManager.IsHeaderVisible)
headerFooterManager.SetHeaderVisibility(true); // make this notes slide Header placeholder visible
if (!headerFooterManager.IsFooterVisible)
headerFooterManager.SetFooterVisibility(true); // make this notes slide Footer placeholder visible
if (!headerFooterManager.IsSlideNumberVisible)
headerFooterManager.SetSlideNumberVisibility(true); // make this notes slide SlideNumber placeholder visible
if (!headerFooterManager.IsDateTimeVisible)
headerFooterManager.SetDateTimeVisibility(true); // make this notes slide Date-time placeholder visible
headerFooterManager.SetHeaderText("New header text"); // set text to notes slide Header placeholder
headerFooterManager.SetFooterText("New footer text"); // set text to notes slide Footer placeholder
headerFooterManager.SetDateTimeText("New date and time text"); // set text to notes slide Date-time placeholder
}
// Salvar apresentação
presentation.Save("testresult.pptx",SaveFormat.Pptx);
}
Obtenha uma licença de API gratuita
Obtenha uma licença temporária gratuita para usar o Aspose.Slides para .NET sem limitações de avaliação.
Conclusão
Neste artigo, você aprendeu como adicionar cabeçalho e rodapé em apresentações do PowerPoint usando C#. Além disso, você viu como alterar o cabeçalho e o rodapé em slides de notas programaticamente. Além disso, você pode explorar a documentação para saber mais sobre o Aspose.Slides para .NET. Além disso, você pode fazer suas perguntas através do nosso fórum.