Вы можете использовать разделы верхнего и нижнего колонтитула в слайдах PowerPoint для отображения дополнительной информации, такой как номер слайда, дата, автор и т. д. Вы также можете управлять этими разделами программно в своих приложениях C++. С этой целью в этой статье вы узнаете, как добавлять верхний и нижний колонтитулы в презентации PowerPoint с помощью C++.
- C++ API для добавления верхнего и нижнего колонтитула в презентации PowerPoint
- Добавление верхнего и нижнего колонтитула в презентации PowerPoint с помощью C++
- Управление верхним и нижним колонтитулами в Notes Master и Notes Slides с помощью C++
C++ API для добавления верхнего и нижнего колонтитула в презентации PowerPoint
Мы будем использовать API Aspose.Slides for C++ для добавления верхнего и нижнего колонтитула в презентации PowerPoint. Это надежный API, предоставляющий множество функций для работы с файлами PowerPoint PPTX/PPT. Вы можете либо установить API через NuGet, либо загрузить его напрямую из раздела Загрузки.
PM> Install-Package Aspose.Slides.Cpp
Добавление верхнего и нижнего колонтитула в презентации PowerPoint с помощью C++
Ниже приведены шаги для добавления верхнего и нижнего колонтитула в презентации PowerPoint.
- Во-первых, загрузите файл PowerPoint с помощью класса Presentation.
- Задайте текст нижнего колонтитула с помощью метода Presentation->getHeaderFooterManager()->SetAllFootersText(System::String text).
- Покажите нижний колонтитул, установив его видимость с помощью метода Presentation->getHeaderFooterManager()->SetAllFootersVisibility(bool isVisible).
- Получите доступ к слайду основных заметок, используя метод Presentation->getMasterNotesSlideManager()->getMasterNotesSlide().
- Прокрутите формы слайда основных заметок.
- Если фигура имеет тип PlaceholderType::Header, установите текст заголовка с помощью метода IAutoShape->getTextFrame()->setText(System::String value).
- Наконец, сохраните презентацию с помощью метода Презентация->Сохранить(System::String fname, Export::SaveFormat format).
В следующем примере кода показано, как добавить верхний и нижний колонтитулы в презентацию PowerPoint с помощью C++.
// Пути к файлам
const String sourceFilePath = u"SourceDirectory\\Slides\\Presentation2.pptx";
const String outputFilePath = u"OutputDirectory\\AddHeaderFooter_out.pptx";
// Загрузите файл презентации
SharedPtr<Presentation> presentation = MakeObject<Presentation>(sourceFilePath);
// Настройка нижнего колонтитула
presentation->get_HeaderFooterManager()->SetAllFootersText(u"My Footer text");
presentation->get_HeaderFooterManager()->SetAllFootersVisibility(true);
// Доступ и обновление заголовка
auto masterNotesSlide = presentation->get_MasterNotesSlideManager()->get_MasterNotesSlide();
if (nullptr != masterNotesSlide)
{
for (const auto& shape : System::IterateOver(masterNotesSlide->get_Shapes()))
{
if (shape->get_Placeholder() != nullptr)
{
if (shape->get_Placeholder()->get_Type() == PlaceholderType::Header)
{
(System::DynamicCast<IAutoShape>(shape))->get_TextFrame()->set_Text(u"HI there new header");
}
}
}
}
// Сохранить презентацию
presentation->Save(outputFilePath, Aspose::Slides::Export::SaveFormat::Pptx);
Управление верхним и нижним колонтитулами в Notes Master и Notes Slides с помощью C++
С помощью Aspose.Slides для C++ вы можете легко управлять верхним и нижним колонтитулами как мастер-заметок, так и слайдов-заметок. В следующих разделах описано, как управлять верхним и нижним колонтитулами в мастере заметок и слайдах заметок.
Изменить настройки верхнего и нижнего колонтитула для Notes Master
Ниже приведены шаги по изменению настроек верхнего и нижнего колонтитула для мастера заметок.
- Во-первых, загрузите файл PowerPoint с помощью класса Presentation.
- Получите доступ к слайду основных заметок, используя метод Presentation->getMasterNotesSlideManager()->getMasterNotesSlide().
- Получите доступ к IMasterNotesSlideHeaderFooterManager с помощью метода IMasterNotesSlide->getHeaderFooterManager().
- Используйте объект IMasterNotesSlideHeaderFooterManager, чтобы обновить верхний и нижний колонтитулы.
- Наконец, сохраните презентацию, используя метод Презентация->Сохранить(System::String fname, Export::SaveFormat format).
В следующем примере кода показано, как изменить верхний и нижний колонтитулы в мастере заметок с помощью C++.
// Пути к файлам
const String sourceFilePath = u"OutputDirectory\\AddHeaderFooter_out.pptx";
const String outputFilePath = u"OutputDirectory\\ChangeHeaderFooterNotesMaster_out.pptx";
// Загрузите файл презентации
SharedPtr<Presentation> presentation = MakeObject<Presentation>(sourceFilePath);
// Изменение настроек верхнего и нижнего колонтитула для мастер-заметок и всех слайдов заметок
auto masterNotesSlide = presentation->get_MasterNotesSlideManager()->get_MasterNotesSlide();
if (masterNotesSlide != nullptr)
{
auto headerFooterManager = masterNotesSlide->get_HeaderFooterManager();
// Сделать основные заметки скользящими, а все дочерние заполнители нижнего колонтитула видимыми
headerFooterManager->SetHeaderAndChildHeadersVisibility(true);
// Сделайте так, чтобы основные заметки скользили, а все дочерние заполнители заголовков были видны
headerFooterManager->SetFooterAndChildFootersVisibility(true);
// Сделать основные заметки скользящими, а все дочерние заполнители SlideNumber видимыми
headerFooterManager->SetSlideNumberAndChildSlideNumbersVisibility(true);
// Сделать основные заметки скользящими, а все дочерние заполнители даты и времени видимыми
headerFooterManager->SetDateTimeAndChildDateTimesVisibility(true);
// Установить текст для основного слайда заметок и всех дочерних заполнителей заголовков
headerFooterManager->SetHeaderAndChildHeadersText(u"Header text");
// Установите текст для основного слайда заметок и всех дочерних заполнителей нижнего колонтитула
headerFooterManager->SetFooterAndChildFootersText(u"Footer text");
// Установить текст для основного слайда заметок и всех дочерних заполнителей даты и времени
headerFooterManager->SetDateTimeAndChildDateTimesText(u"Date and time text");
}
// Сохранить презентацию
presentation->Save(outputFilePath, Aspose::Slides::Export::SaveFormat::Pptx);
Изменить настройки верхнего и нижнего колонтитула для слайда Notes
Ниже приведены шаги по изменению настроек верхнего и нижнего колонтитула для слайдов с заметками.
- Во-первых, загрузите файл PowerPoint с помощью класса Presentation.
- Получите доступ к слайду заметок, используя метод Presentation->getSlides()->idxget(0)->getNotesSlideManager()->getNotesSlide().
- Получите доступ к INotesSlideHeaderFooterManager с помощью метода INotesSlide->getHeaderFooterManager().
- Используйте объект INotesSlideHeaderFooterManager, чтобы обновить верхний и нижний колонтитулы.
- Наконец, сохраните презентацию с помощью метода Presentation->Save(System::String fname, Export::SaveFormat format).
В следующем примере кода показано, как изменить верхний и нижний колонтитулы на слайде с заметками с помощью C++.
// Пути к файлам
const String sourceFilePath = u"OutputDirectory\\ChangeHeaderFooterNotesMaster_out.pptx";
const String outputFilePath = u"OutputDirectory\\ChangeHeaderFooterNotesSlide_out.pptx";
// Загрузите файл презентации
SharedPtr<Presentation> presentation = MakeObject<Presentation>(sourceFilePath);
// Изменение настроек верхнего и нижнего колонтитула только для слайда с первыми заметками
auto notesSlide = presentation->get_Slides()->idx_get(0)->get_NotesSlideManager()->get_NotesSlide();
if (notesSlide != nullptr)
{
auto headerFooterManager = notesSlide->get_HeaderFooterManager();
if (!headerFooterManager->get_IsHeaderVisible())
{
// Сделать этот слайд заметок Заполнитель заголовка видимым
headerFooterManager->SetHeaderVisibility(true);
}
if (!headerFooterManager->get_IsFooterVisible())
{
// Сделать эти заметки слайдом Заполнитель нижнего колонтитула видимым
headerFooterManager->SetFooterVisibility(true);
}
if (!headerFooterManager->get_IsSlideNumberVisible())
{
// Сделать этот слайд заметок заполнителем SlideNumber видимым
headerFooterManager->SetSlideNumberVisibility(true);
}
if (!headerFooterManager->get_IsDateTimeVisible())
{
// Сделать эти заметки слайдом Заполнитель даты и времени видимым
headerFooterManager->SetDateTimeVisibility(true);
}
// Установить текст для заметок слайда Заполнитель заголовка
headerFooterManager->SetHeaderText(u"New header text");
// Установить текст для заметок на слайде Заполнитель нижнего колонтитула
headerFooterManager->SetFooterText(u"New footer text");
// Установить текст для заметок на слайде Заполнитель даты и времени
headerFooterManager->SetDateTimeText(u"New date and time text");
}
// Сохранить презентацию
presentation->Save(outputFilePath, Aspose::Slides::Export::SaveFormat::Pptx);
Получить бесплатную лицензию
Чтобы попробовать API без ограничений на пробную версию, вы можете запросить бесплатную временную лицензию.
Вывод
В этой статье вы узнали, как добавить верхний и нижний колонтитулы в презентации PowerPoint с помощью C++. Кроме того, вы увидели, как изменить верхний и нижний колонтитулы в мастере заметок и слайде заметок с помощью Aspose.Slides for C++ API. Это мощный API, предоставляющий множество дополнительных функций для работы с файлами PowerPoint PPTX/PPT. Вы можете подробно изучить API, посетив официальную документацию. Если у вас возникнут какие-либо вопросы, обращайтесь к нам на наш бесплатный форум поддержки.