Documentation – Управление содержимым презентации в C++

Cpp: Управление BLOB в презентациях на C++ для эффективного использования памяти

Mon, 01 Jan 0001 00:00:00 +0000

О BLOB

BLOB (Binary Large Object) обычно представляет собой большой объект (фото, презентацию, документ или медиа), сохранённый в бинарных форматах.

Aspose.Slides for C++ позволяет использовать BLOB для объектов таким образом, чтобы уменьшить потребление памяти при работе с крупными файлами.

Используйте BLOB для уменьшения потребления памяти

Добавить большой файл через BLOB в презентацию

Aspose.Slides for C++ позволяет добавить крупные файлы (в данном случае большой видеофайл) через процесс, использующий BLOB, чтобы уменьшить потребление памяти.

Этот код C++ показывает, как добавить большой видеофайл через процесс BLOB в презентацию:

const String pathToVeryLargeVideo = u"veryLargeVideo.avi";

// Создаёт новую презентацию, в которую будет добавлено видео
auto pres = System::MakeObject<Presentation>();

auto fileStream = System::MakeObject<FileStream>(pathToVeryLargeVideo, FileMode::Open);
// Добавим видео в презентацию - мы выбрали поведение KeepLocked, потому что мы
// не планируем получать доступ к файлу "veryLargeVideo.avi".
auto video = pres->get_Videos()->AddVideo(fileStream, LoadingStreamBehavior::KeepLocked);
pres->get_Slides()->idx_get(0)->get_Shapes()->AddVideoFrame(0.0f, 0.0f, 480.0f, 270.0f, video);

// Сохраняет презентацию. Пока выводится большая презентация, потребление памяти
// остается низким в течение жизненного цикла объекта pres
pres->Save(u"presentationWithLargeVideo.pptx", SaveFormat::Pptx);

Экспортировать большой файл через BLOB из презентации

Aspose.Slides for C++ позволяет экспортировать крупные файлы (в данном случае аудио‑ или видеофайл) через процесс, использующий BLOB, из презентаций. Например, вам может потребоваться извлечь большой медиафайл из презентации, но вы не хотите, чтобы файл загружался в память компьютера. При экспорте файла через процесс BLOB вы сохраняете низкое потребление памяти.

Этот код C++ демонстрирует описанную операцию:

const String hugePresentationWithAudiosAndVideosFile = u"Large  Video File Test1.pptx";

auto loadOptions = System::MakeObject<LoadOptions>();
loadOptions->get_BlobManagementOptions()->set_PresentationLockingBehavior(PresentationLockingBehavior::KeepLocked);

// Создаёт экземпляр Presentation и блокирует файл "hugePresentationWithAudiosAndVideos.pptx".

auto pres = System::MakeObject<Presentation>(hugePresentationWithAudiosAndVideosFile, loadOptions);
// Сохраним каждое видео в файл. Чтобы предотвратить высокое использование памяти, нам нужен буфер, который будет использоваться
// для передачи данных из видеопотока презентации в поток только что созданного видеофайла.
auto buffer = System::MakeArray<uint8_t>(8 * 1024, 0);

// Итерируется по видеоматериалам
for (int32_t index = 0; index < pres->get_Videos()->get_Count(); ++index)
{
	auto video = pres->get_Videos()->idx_get(index);

	// Открывает видеопоток презентации. Обратите внимание, что мы намеренно избегали обращения к методам
	// например video->get_BinaryData - потому что этот метод возвращает массив байтов, содержащий полное видео, что затем
	// вызывает загрузку байтов в память. Мы используем video->GetStream, который возвращает Stream и НЕ
	// требует от нас загрузки всего видео в память.
	
	auto presVideoStream = video->GetStream();

	auto outputFileStream = File::OpenWrite(String::Format(u"video{0}.avi", index));
	int32_t bytesRead;
	while ((bytesRead = presVideoStream->Read(buffer, 0, buffer->get_Length())) > 0)
	{
		outputFileStream->Write(buffer, 0, bytesRead);
	}
		
	// Потребление памяти останется низким независимо от размера видео или презентации,
}

// При необходимости вы можете применить те же шаги к аудиофайлам.

Добавить изображение как BLOB в презентацию

С помощью методов интерфейса IImageCollection и класса ImageCollection вы можете добавить большое изображение как поток, чтобы оно обрабатывалось как BLOB.

Этот код C++ показывает, как добавить большое изображение через процесс BLOB:

const String pathToLargeImage = u"large_image.jpg";

// создает новую презентацию, в которую будет добавлено изображение.
auto pres = System::MakeObject<Presentation>();

auto fileStream = System::MakeObject<FileStream>(pathToLargeImage, FileMode::Open);
// Добавим изображение в презентацию - мы выбираем поведение KeepLocked, потому что мы
// НЕ планируем обращаться к файлу "largeImage.png" file.
auto img = pres->get_Images()->AddImage(fileStream, LoadingStreamBehavior::KeepLocked);
pres->get_Slides()->idx_get(0)->get_Shapes()->AddPictureFrame(ShapeType::Rectangle, 0.0f, 0.0f, 300.0f, 200.0f, img);

// Сохраняет презентацию. Пока выводится большая презентация, потребление памяти 
// остается низким в течение жизненного цикла объекта pres
pres->Save(u"presentationWithLargeImage.pptx", SaveFormat::Pptx);

Память и крупные презентации

Обычно для загрузки большой презентации компьютерам требуется много временной памяти. Всё содержимое презентации загружается в память, а файл (из которого была загружена презентация) перестаёт использоваться.

Рассмотрим большую презентацию PowerPoint (large.pptx), содержащую 1,5 ГБ видеофайл. Стандартный метод загрузки презентации показан в этом коде C++:

auto pres = System::MakeObject<Presentation>(u"large.pptx");
pres->Save(u"large.pdf", SaveFormat::Pdf);

Но этот метод потребляет около 1,6 ГБ временной памяти.

Загрузить большую презентацию как BLOB

Через процесс, использующий BLOB, вы можете загрузить большую презентацию, используя мало памяти. Этот код C++ описывает реализацию, где процесс BLOB используется для загрузки большого файла презентации (large.pptx):

auto blobManagementOptions = System::MakeObject<BlobManagementOptions>();
blobManagementOptions->set_PresentationLockingBehavior(PresentationLockingBehavior::KeepLocked);
blobManagementOptions->set_IsTemporaryFilesAllowed(true);

auto loadOptions = System::MakeObject<LoadOptions>();
loadOptions->set_BlobManagementOptions(blobManagementOptions);

auto pres = System::MakeObject<Presentation>(u"large.pptx", loadOptions);
pres->Save(u"large.pdf", SaveFormat::Pdf);

Изменить папку для временных файлов

Когда используется процесс BLOB, ваш компьютер создаёт временные файлы в папке по умолчанию для временных файлов. Если вы хотите хранить временные файлы в другой папке, можно изменить настройки хранилища с помощью TempFilesRootPath:

auto blobManagementOptions = System::MakeObject<BlobManagementOptions>();
blobManagementOptions->set_PresentationLockingBehavior(PresentationLockingBehavior::KeepLocked);
blobManagementOptions->set_IsTemporaryFilesAllowed(true);
blobManagementOptions->set_TempFilesRootPath(u"temp");

auto loadOptions = System::MakeObject<LoadOptions>();
loadOptions->set_BlobManagementOptions(blobManagementOptions);

Info

При использовании TempFilesRootPath Aspose.Slides не создаёт автоматически папку для временных файлов. Вам необходимо создать папку вручную.

FAQ

Какие данные в презентации Aspose.Slides рассматриваются как BLOB и контролируются параметрами BLOB?

Крупные бинарные объекты, такие как изображения, аудио и видео, рассматриваются как BLOB. Сам файл презентации также участвует в обработке BLOB при загрузке или сохранении. На эти объекты распространяются политики BLOB, позволяющие управлять использованием памяти и переходом к временным файлам при необходимости.

Где я могу настроить правила обработки BLOB во время загрузки презентации?

Используйте LoadOptions вместе с BlobManagementOptions. Здесь задаётся предел объёма BLOB в памяти, разрешение или запрет временных файлов, корневой путь для временных файлов и поведение блокировки источника.

Влияют ли настройки BLOB на производительность и как найти баланс между скоростью и памятью?

Да. Хранение BLOB в памяти повышает скорость, но увеличивает использование ОЗУ; снижение предела памяти переносит больше работы во временные файлы, снижая ОЗУ за счёт дополнительного ввода‑вывода. Используйте метод set_MaxBlobsBytesInMemory для выбора оптимального баланса под вашу нагрузку и окружение.

Помогают ли параметры BLOB при открытии чрезвычайно больших презентаций (например, гигабайтных)?

Да. BlobManagementOptions предназначены для таких сценариев: включение временных файлов и использование блокировки источника может значительно снизить пиковое использование ОЗУ и стабилизировать процесс обработки очень больших наборов слайдов.

Можно ли использовать политики BLOB при загрузке из потоков вместо файлов на диске?

Да. Те же правила применяются к потокам: экземпляр презентации может владеть и блокировать входной поток (в зависимости от выбранного режима блокировки), а временные файлы используются, если это разрешено, обеспечивая предсказуемое использование памяти во время обработки.

Cpp: Управление гиперссылками презентации в C++

Mon, 01 Jan 0001 00:00:00 +0000

Гиперссылка — это ссылка на объект, данные или место в чем‑то. Ниже перечислены типичные гиперссылки в презентациях PowerPoint:

Ссылки на веб‑сайты внутри текста, фигур или медиа
Ссылки на слайды

Aspose.Slides for C++ позволяет выполнять множество задач, связанных с гиперссылками в презентациях.

Вы можете попробовать простой, бесплатный онлайн‑редактор PowerPoint.

Добавить URL‑гиперссылки

Добавить URL‑гиперссылки в текст

Этот код C++ показывает, как добавить гиперссылку на веб‑сайт в текст:

auto presentation = System::MakeObject<Presentation>();
auto shapes = presentation->get_Slides()->idx_get(0)->get_Shapes();
auto shape = shapes->AddAutoShape(ShapeType::Rectangle, 100.0f, 100.0f, 600.0f, 50.0f, false);
shape->AddTextFrame(u"Aspose: File Format APIs");

auto portionFormat = shape->get_TextFrame()->get_Paragraphs()->idx_get(0)->get_Portions()->idx_get(0)->get_PortionFormat();
portionFormat->set_HyperlinkClick(MakeObject<Hyperlink>(u"https://www.aspose.com/"));
portionFormat->get_HyperlinkClick()->set_Tooltip(u"More than 70% Fortune 100 companies trust Aspose APIs");
portionFormat->set_FontHeight(32.0f);

presentation->Save(u"presentation-out.pptx", SaveFormat::Pptx);

Добавить URL‑гиперссылки в фигуры или кадры

Этот пример кода на C++ показывает, как добавить гиперссылку на веб‑сайт в форму:

auto pres = System::MakeObject<Presentation>();
auto shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
auto shape = shapes->AddAutoShape(ShapeType::Rectangle, 100.0f, 100.0f, 600.0f, 50.0f);

shape->set_HyperlinkClick(System::MakeObject<Hyperlink>(u"https://www.aspose.com/"));
shape->get_HyperlinkClick()->set_Tooltip(u"More than 70% Fortune 100 companies trust Aspose APIs");

pres->Save(u"pres-out.pptx", SaveFormat::Pptx);

Добавить URL‑гиперссылки к медиа

Aspose.Slides позволяет добавлять гиперссылки к изображениям, аудио и видеофайлам.

Этот пример кода показывает, как добавить гиперссылку к изображению:

auto pres = System::MakeObject<Presentation>();
auto shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
// Добавляет изображение в презентацию
auto image = pres->get_Images()->AddImage(File::ReadAllBytes(u"image.png"));
// Создает рамку изображения на слайде 1 на основе ранее добавленного изображения
auto pictureFrame = shapes->AddPictureFrame(ShapeType::Rectangle, 10.0f, 10.0f, 100.0f, 100.0f, image);

pictureFrame->set_HyperlinkClick(MakeObject<Hyperlink>(u"https://www.aspose.com/"));
pictureFrame->get_HyperlinkClick()->set_Tooltip(u"More than 70% Fortune 100 companies trust Aspose APIs");

pres->Save(u"pres-out.pptx", SaveFormat::Pptx);

Этот пример кода показывает, как добавить гиперссылку к аудиофайлу:

auto pres = System::MakeObject<Presentation>();
auto shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
auto audio = pres->get_Audios()->AddAudio(File::ReadAllBytes(u"audio.mp3"));
auto audioFrame = shapes->AddAudioFrameEmbedded(10.0f, 10.0f, 100.0f, 100.0f, audio);

audioFrame->set_HyperlinkClick(MakeObject<Hyperlink>(u"https://www.aspose.com/"));
audioFrame->get_HyperlinkClick()->set_Tooltip(u"More than 70% Fortune 100 companies trust Aspose APIs");

pres->Save(u"pres-out.pptx", SaveFormat::Pptx);

Этот пример кода показывает, как добавить гиперссылку к видео:

auto pres = System::MakeObject<Presentation>();
auto shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
auto video = pres->get_Videos()->AddVideo(File::ReadAllBytes(u"video.avi"));
auto videoFrame = shapes->AddVideoFrame(10.0f, 10.0f, 100.0f, 100.0f, video);

videoFrame->set_HyperlinkClick(MakeObject<Hyperlink>(u"https://www.aspose.com/"));
videoFrame->get_HyperlinkClick()->set_Tooltip(u"More than 70% Fortune 100 companies trust Aspose APIs");

pres->Save(u"pres-out.pptx", SaveFormat::Pptx);

Tip

Вы можете посмотреть Управление OLE.

Использовать гиперссылки для создания оглавления

Поскольку гиперссылки позволяют добавлять ссылки на объекты или места, их можно использовать для создания оглавления.

Этот пример кода показывает, как создать оглавление с гиперссылками:

auto presentation = System::MakeObject<Presentation>();
auto firstSlide = presentation->get_Slides()->idx_get(0);
auto secondSlide = presentation->get_Slides()->AddEmptySlide(firstSlide->get_LayoutSlide());

auto contentTable = firstSlide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 40.0f, 40.0f, 300.0f, 100.0f);
contentTable->get_FillFormat()->set_FillType(FillType::NoFill);
contentTable->get_LineFormat()->get_FillFormat()->set_FillType(FillType::NoFill);
contentTable->get_TextFrame()->get_Paragraphs()->Clear();

auto paragraph = System::MakeObject<Paragraph>();
auto paragraphFillFormat = paragraph->get_ParagraphFormat()->get_DefaultPortionFormat()->get_FillFormat();
paragraphFillFormat->set_FillType(FillType::Solid);
paragraphFillFormat->get_SolidFillColor()->set_Color(Color::get_Black());
paragraph->set_Text(u"Title of slide 2 .......... ");

auto linkPortion = System::MakeObject<Portion>();
linkPortion->set_Text(u"Page 2");
linkPortion->get_PortionFormat()->get_HyperlinkManager()->SetInternalHyperlinkClick(secondSlide);

paragraph->get_Portions()->Add(linkPortion);
contentTable->get_TextFrame()->get_Paragraphs()->Add(paragraph);

Форматировать гиперссылки

Цвет

С помощью методов set_ColorSource() и get_ColorSource() интерфейса IHyperlink вы можете установить цвет гиперссылок и также получить информацию о цвете из гиперссылок. Эта функция была впервые представлена в PowerPoint 2019, поэтому изменения свойства не применимы к более ранним версиям PowerPoint.

Этот пример кода демонстрирует операцию, в которой гиперссылки разных цветов были добавлены на один слайд:

auto presentation = System::MakeObject<Presentation>();
auto shapes = presentation->get_Slides()->idx_get(0)->get_Shapes();
auto shape1 = shapes->AddAutoShape(ShapeType::Rectangle, 100.0f, 100.0f, 450.0f, 50.0f, false);
shape1->AddTextFrame(u"This is a sample of colored hyperlink.");
auto shape1PortionFormat = shape1->get_TextFrame()->get_Paragraphs()->idx_get(0)->get_Portions()->idx_get(0)->get_PortionFormat();
shape1PortionFormat->set_HyperlinkClick(MakeObject<Hyperlink>(u"https://www.aspose.com/"));
shape1PortionFormat->get_HyperlinkClick()->set_ColorSource(HyperlinkColorSource::PortionFormat);
shape1PortionFormat->get_FillFormat()->set_FillType(FillType::Solid);
shape1PortionFormat->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Red());

auto shape2 = shapes->AddAutoShape(ShapeType::Rectangle, 100.0f, 200.0f, 450.0f, 50.0f, false);
shape2->AddTextFrame(u"This is a sample of usual hyperlink.");
auto shape2PortionFormat = shape2->get_TextFrame()->get_Paragraphs()->idx_get(0)->get_Portions()->idx_get(0)->get_PortionFormat();
shape2PortionFormat->set_HyperlinkClick(MakeObject<Hyperlink>(u"https://www.aspose.com/"));

presentation->Save(u"presentation-out-hyperlink.pptx", SaveFormat::Pptx);

Удалить гиперссылки из презентаций

Удалить гиперссылки из текста

Этот код C++ показывает, как удалить гиперссылку из текста на слайде презентации:

auto pres = System::MakeObject<Presentation>(u"pres.pptx");
auto slide = pres->get_Slides()->idx_get(0);
for (const auto& shape : slide->get_Shapes())
{
    auto autoShape = System::AsCast<IAutoShape>(shape);
    if (autoShape != nullptr)
    {
        for (const auto& paragraph : autoShape->get_TextFrame()->get_Paragraphs())
        {
            for (const auto& portion : paragraph->get_Portions())
            {
                auto hyperlinkManager = portion->get_PortionFormat()->get_HyperlinkManager();
                hyperlinkManager->RemoveHyperlinkClick();
            }
        }
    }
}

pres->Save(u"pres-removed-hyperlinks.pptx", SaveFormat::Pptx);

Удалить гиперсылки из фигур или рамок

Этот код C++ показывает, как удалить гиперссылку из формы на слайде презентации:

auto pres = System::MakeObject<Presentation>(u"demo.pptx");
auto slide = pres->get_Slides()->idx_get(0);
for (const auto& shape : slide->get_Shapes())
{
    shape->get_HyperlinkManager()->RemoveHyperlinkClick();
}
pres->Save(u"pres-removed-hyperlinks.pptx", SaveFormat::Pptx);

Изменяемая гиперссылка

Класс Hyperlink изменяемый. С помощью этого класса вы можете изменять значения следующих методов:

Этот фрагмент кода показывает, как добавить гиперссылку на слайд и позже изменить её всплывающую подсказку:

auto presentation = System::MakeObject<Presentation>();
auto shapes = presentation->get_Slides()->idx_get(0)->get_Shapes();
auto shape = shapes->AddAutoShape(ShapeType::Rectangle, 100.0f, 100.0f, 600.0f, 50.0f, false);

shape->AddTextFrame(u"Aspose: File Format APIs");

auto shapePortionFormat = shape->get_TextFrame()->get_Paragraphs()->idx_get(0)->get_Portions()->idx_get(0)->get_PortionFormat();
shapePortionFormat->set_HyperlinkClick(MakeObject<Hyperlink>(u"https://www.aspose.com/"));
shapePortionFormat->get_HyperlinkClick()->set_Tooltip(u"More than 70% Fortune 100 companies trust Aspose APIs");
shapePortionFormat->set_FontHeight(32.0f);

presentation->Save(u"presentation-out.pptx", SaveFormat::Pptx);

Поддерживаемые методы в IHyperlinkQueries

Вы можете получить доступ к IHyperlinkQueries из презентации, слайда или текста, для которого определена гиперссылка.

Класс IHyperlinkQueries поддерживает следующие методы:

FAQ

Как я могу создать внутреннюю навигацию не только к слайду, но и к “разделу” или к первому слайду раздела?

Разделы в PowerPoint — это группы слайдов; навигация технически ориентирована на конкретный слайд. Чтобы “перейти к разделу”, обычно создаётся ссылка на его первый слайд.

Можно ли привязать гиперссылку к элементам мастер‑слайда, чтобы она работала на всех слайдах?

Да. Элементы мастер‑слайда и шаблона поддерживают гиперссылки. Такие ссылки отображаются на дочерних слайдах и кликабельны во время показа.

Будут ли гиперссылки сохранены при экспорте в PDF, HTML, изображения или видео?

В PDF и HTML — да, ссылки обычно сохраняются. При экспорте в изображения и видео возможность нажать на ссылки не сохраняется из‑за характера этих форматов (растровые кадры/видео не поддерживают гиперссылки).

Cpp: Управление медиафайлами

Mon, 01 Jan 0001 00:00:00 +0000

Cpp: Управление OLE в презентациях с помощью C++

Mon, 01 Jan 0001 00:00:00 +0000

Info

OLE (Object Linking & Embedding) – это технология Microsoft, позволяющая размещать данные и объекты, созданные в одном приложении, в другом приложении с помощью связывания или внедрения.

Рассмотрите диаграмму, созданную в MS Excel. Эта диаграмма затем помещается на слайд PowerPoint. Такая диаграмма Excel считается OLE‑объектом.

OLE‑объект может отображаться в виде значка. В этом случае при двойном щелчке по значку диаграмма открывается в связанном приложении (Excel) или появляется запрос выбрать приложение для открытия или редактирования объекта.
OLE‑объект может отображать своё фактическое содержимое, например содержимое диаграммы. В этом случае диаграмма активируется в PowerPoint, загружается её интерфейс, и вы можете изменять данные диаграммы непосредственно в PowerPoint.

Aspose.Slides for C++ позволяет вставлять OLE‑объекты на слайды в виде OLE‑кадров объектов (OleObjectFrame).

Добавление OLE‑кадров объектов на слайды

Предположим, что вы уже создали диаграмму в Microsoft Excel и хотите внедрить её на слайд в виде OLE‑кадра объекта с помощью Aspose.Slides for C++, вы можете сделать это так:

Создайте экземпляр класса Presentation.
Получите ссылку на слайд по его индексу.
Прочитайте файл Excel как массив байтов.
Добавьте OleObjectFrame на слайд, передав массив байтов и другую информацию об OLE‑объекте.
Сохраните изменённую презентацию в файл PPTX.

В примере ниже мы добавили диаграмму из файла Excel на слайд в виде OleObjectFrame с помощью Aspose.Slides for C++. Примечание: конструктор OleEmbeddedDataInfo принимает расширение внедряемого объекта в качестве второго параметра. Это расширение позволяет PowerPoint правильно определять тип файла и выбирать соответствующее приложение для открытия OLE‑объекта.

auto presentation = MakeObject<Presentation>();
auto slideSize = presentation->get_SlideSize()->get_Size();
auto slide = presentation->get_Slide(0);

// Prepare data for the OLE object.
auto fileData = File::ReadAllBytes(u"book.xlsx");
auto dataInfo = MakeObject<OleEmbeddedDataInfo>(fileData, u"xlsx");

// Add the OLE object frame to the slide.
slide->get_Shapes()->AddOleObjectFrame(0, 0, slideSize.get_Width(), slideSize.get_Height(), dataInfo);

presentation->Save(u"output.pptx", SaveFormat::Pptx);
presentation->Dispose();

Добавление связанных OLE‑кадров объектов

Aspose.Slides for C++ позволяет добавить OleObjectFrame без внедрения данных, а только со ссылкой на файл.

Этот C++‑код демонстрирует, как добавить OleObjectFrame со связанным файлом Excel на слайд:

auto presentation = MakeObject<Presentation>();
auto slide = presentation->get_Slide(0);

// Добавьте OLE‑кадр объекта со связанным файлом Excel.
slide->get_Shapes()->AddOleObjectFrame(20, 20, 200, 150, u"Excel.Sheet.12", u"book.xlsx");

presentation->Save(u"output.pptx", SaveFormat::Pptx);
presentation->Dispose();

Доступ к OLE‑кадрам объектов

Если OLE‑объект уже внедрён в слайд, вы можете легко найти или получить к нему доступ следующим способом:

Загрузите презентацию с внедрённым OLE‑объектом, создав экземпляр класса Presentation.
Получите ссылку на слайд, используя его индекс.
Получите форму OleObjectFrame. В нашем примере мы использовали предварительно созданный PPTX, содержащий только одну форму на первом слайде. Затем мы привели этот объект к типу IOleObjectFrame. Это был нужный OLE‑кадр объекта для доступа.
После получения доступа к OLE‑кадру объекта вы можете выполнять любые операции над ним.

В примере ниже доступен OLE‑кадр объекта (объект диаграммы Excel, внедрённый в слайд) и его файловые данные.

auto presentation = MakeObject<Presentation>(u"sample.pptx");
auto slide = presentation->get_Slide(0);
auto shape = slide->get_Shape(0);

if (ObjectExt::Is<IOleObjectFrame>(shape))
{ 
    auto oleFrame = ExplicitCast<IOleObjectFrame>(shape);

    // Получить данные встроенного файла.
    // Получить расширение встроенного файла.
    // ...
}

Доступ к свойствам связанных OLE‑кадров объектов

Aspose.Slides позволяет получать свойства связанных OLE‑кадров объектов.

Этот C++‑код показывает, как проверить, является ли OLE‑объект связанным, и затем получить путь к связанному файлу:

auto presentation = MakeObject<Presentation>(u"sample.ppt");
auto slide = presentation->get_Slide(0);
auto shape = slide->get_Shape(0);

if (ObjectExt::Is<IOleObjectFrame>(shape))
{
    auto oleFrame = ExplicitCast<IOleObjectFrame>(shape);

    // Проверить, является ли OLE объект связанным.
    if (oleFrame->get_IsObjectLink())
    {
        // Вывести полный путь к связанному файлу.
        std::wcout << L"OLE object frame is linked to: " << oleFrame->get_LinkPathLong() << std::endl;

        // Вывести относительный путь к связанному файлу, если он присутствует.
        // Только презентации PPT могут содержать относительный путь.
        if (!String::IsNullOrEmpty(oleFrame->get_LinkPathRelative()))
        {
            std::wcout << L"OLE object frame relative path: " << oleFrame->get_LinkPathRelative() << std::endl;
        }
    }
}

Изменение данных OLE‑объекта

В этом разделе пример кода ниже использует Aspose.Cells for C++.

Если OLE‑объект уже внедрён в слайд, вы можете легко получить к нему доступ и изменить его данные следующим образом:

Загрузите презентацию с внедрённым OLE‑объектом, создав экземпляр класса Presentation.
Получите ссылку на слайд по его индексу.
Получите форму OLEObjectFrame. В нашем примере мы использовали предварительно созданный PPTX, содержащий одну форму на первом слайде. Затем мы привели этот объект к типу IOleObjectFrame. Это был нужный OLE‑кадр объекта для доступа.
После получения доступа к OLE‑кадру объекта вы можете выполнять любые операции над ним.
Создайте объект Workbook и получите доступ к OLE‑данным.
Получите нужный Worksheet и измените данные.
Сохраните обновлённый Workbook в поток.
Измените данные OLE‑объекта из потока.

В примере ниже OLE‑кадр объекта (объект диаграммы Excel, внедрённый в слайд) доступен, и его файловые данные изменены для обновления данных диаграммы.

auto presentation = MakeObject<Presentation>(u"sample.pptx");
auto slide = presentation->get_Slide(0);

// Получить первую фигуру как OLE-кадр объекта.
auto oleFrame = AsCast<IOleObjectFrame>(slide->get_Shape(0));

if (oleFrame != nullptr)
{
    auto oleStream = MakeObject<MemoryStream>(oleFrame->get_EmbeddedData()->get_EmbeddedFileData());

    // Прочитать данные OLE-объекта как объект Workbook.
    auto oleArray = oleStream->ToArray();
    std::vector<uint8_t> workbookData(oleArray->data().begin(), oleArray->data().end());
    Aspose::Cells::Workbook workbook(Aspose::Cells::Vector<uint8_t>(workbookData.data(), workbookData.size()));

    // Изменить данные Workbook.
    auto worksheet = workbook.GetWorksheets().Get(0);
    worksheet.GetCells().Get(0, 4).PutValue(Aspose::Cells::U16String("E"));
    worksheet.GetCells().Get(1, 4).PutValue(12);
    worksheet.GetCells().Get(2, 4).PutValue(14);
    worksheet.GetCells().Get(3, 4).PutValue(15);

    Aspose::Cells::OoxmlSaveOptions fileOptions(Aspose::Cells::SaveFormat::Xlsx);
    auto newWorkbookData = workbook.Save(fileOptions);

    auto newOleStream = MakeObject<MemoryStream>();
    newOleStream->Write(
        MakeArray<uint8_t>(std::vector<uint8_t>(newWorkbookData.GetData(), newWorkbookData.GetData() + newWorkbookData.GetLength())),
        0, newWorkbookData.GetLength());

    // Изменить данные объекта OLE-кадра.
    auto newData = MakeObject<OleEmbeddedDataInfo>(newOleStream->ToArray(), oleFrame->get_EmbeddedData()->get_EmbeddedFileExtension());
    oleFrame->SetEmbeddedData(newData);
}

presentation->Save(u"output.pptx", SaveFormat::Pptx);

Встраивание других типов файлов в слайды

Помимо диаграмм Excel, Aspose.Slides for C++ позволяет встраивать в слайды и другие типы файлов. Например, можно вставлять HTML, PDF и ZIP‑файлы в виде объектов. При двойном щелчке пользователя по вставленному объекту он автоматически открывается в соответствующей программе, либо пользователю предлагается выбрать подходящую программу для его открытия.

Этот C++‑код показывает, как внедрить HTML и ZIP в слайд:

auto presentation = MakeObject<Presentation>();
auto slide = presentation->get_Slide(0);

auto htmlData = File::ReadAllBytes(u"sample.html");
auto htmlDataInfo = MakeObject<OleEmbeddedDataInfo>(htmlData, u"html");
auto htmlOleFrame = slide->get_Shapes()->AddOleObjectFrame(150, 120, 50, 50, htmlDataInfo);
htmlOleFrame->set_IsObjectIcon(true);

auto zipData = File::ReadAllBytes(u"sample.zip");
auto zipDataInfo = MakeObject<OleEmbeddedDataInfo>(zipData, u"zip");
auto zipOleFrame = slide->get_Shapes()->AddOleObjectFrame(150, 220, 50, 50, zipDataInfo);
zipOleFrame->set_IsObjectIcon(true);

presentation->Save(u"output.pptx", SaveFormat::Pptx);
presentation->Dispose();

Установка типов файлов для встроенных объектов

При работе с презентациями может потребоваться заменить старые OLE‑объекты новыми или заменить неподдерживаемый OLE‑объект поддерживаемым. Aspose.Slides for C++ позволяет установить тип файла для встроенного объекта, что даёт возможность обновлять данные OLE‑кадра или его расширение.

Этот C++‑код показывает, как установить тип файла для встроенного OLE‑объекта в zip:

auto presentation = MakeObject<Presentation>(u"sample.pptx");
auto slide = presentation->get_Slide(0);
auto oleFrame = ExplicitCast<IOleObjectFrame>(slide->get_Shape(0));

auto fileExtension = oleFrame->get_EmbeddedData()->get_EmbeddedFileExtension();
auto fileData = oleFrame->get_EmbeddedData()->get_EmbeddedFileData();

std::wcout << L"Current embedded file extension is: " << fileExtension << std::endl;

// Изменить тип файла на ZIP.
oleFrame->SetEmbeddedData(MakeObject<OleEmbeddedDataInfo>(fileData, u"zip"));

presentation->Save(u"output.pptx", SaveFormat::Pptx);
presentation->Dispose();

Установка изображений значков и заголовков для встроенных объектов

После встраивания OLE‑объекта автоматически добавляется предварительный просмотр в виде значка. Этот предварительный просмотр видят пользователи до доступа или открытия OLE‑объекта. Если вы хотите использовать конкретное изображение и текст в качестве элементов предварительного просмотра, вы можете установить изображение значка и заголовок с помощью Aspose.Slides for C++.

Этот C++‑код показывает, как установить изображение значка и заголовок для встроенного объекта:

auto presentation = MakeObject<Presentation>(u"sample.pptx");
auto slide = presentation->get_Slide(0);
auto oleFrame = ExplicitCast<IOleObjectFrame>(slide->get_Shape(0));

// Добавить изображение в ресурсы презентации.
auto imageData = File::ReadAllBytes(u"image.png");
auto oleImage = presentation->get_Images()->AddImage(imageData);

// Установить заголовок и изображение для предварительного просмотра OLE.
oleFrame->set_SubstitutePictureTitle(u"My title");
oleFrame->get_SubstitutePictureFormat()->get_Picture()->set_Image(oleImage);
oleFrame->set_IsObjectIcon(true);

presentation->Save(u"output.pptx", SaveFormat::Pptx);
presentation->Dispose();

Предотвращение изменения размера и перемещения OLE‑кадра объекта

После того как вы добавите связанный OLE‑объект на слайд презентации, при открытии презентации в PowerPoint вы можете увидеть сообщение с запросом обновить ссылки. Нажатие кнопки “Update Links” может изменить размер и позицию OLE‑кадра, поскольку PowerPoint обновляет данные из связанного OLE‑объекта и обновляет предварительный просмотр. Чтобы предотвратить запрос PowerPoint об обновлении данных объекта, установите метод set_UpdateAutomatic интерфейса IOleObjectFrame в значение false:

oleFrame->set_UpdateAutomatic(false);

Извлечение встроенных файлов

Aspose.Slides for C++ позволяет извлекать файлы, встроенные в слайды в виде OLE‑объектов, следующим образом:

Создайте экземпляр класса Presentation, содержащего OLE‑объекты, которые вы хотите извлечь.
Пройдитесь по всем формулам в презентации и получите доступ к формам OLEObjectFrame.
Получите данные встроенных файлов из OLE‑кадров объектов и запишите их на диск.

Этот C++‑код показывает, как извлечь файлы, встроенные в слайд, в виде OLE‑объектов:

auto presentation = MakeObject<Presentation>(u"sample.pptx");
auto slide = presentation->get_Slide(0);

for (int index = 0; index < slide->get_Shapes()->get_Count(); index++)
{
    auto shape = slide->get_Shape(index);

    if (ObjectExt::Is<IOleObjectFrame>(shape))
    { 
        auto oleFrame = ExplicitCast<IOleObjectFrame>(shape);

        auto fileData = oleFrame->get_EmbeddedData()->get_EmbeddedFileData();
        auto fileExtension = oleFrame->get_EmbeddedData()->get_EmbeddedFileExtension();

        auto fileName = String::Format(u"OLE_object_{0}{1}", index, fileExtension);
        File::WriteAllBytes(fileName, fileData);
    }
}

presentation->Dispose();

FAQ

Будет ли OLE‑содержание отрисовано при экспорте слайдов в PDF/изображения?

Отрисовывается то, что видно на слайде — значок/замещающее изображение (превью). «Живое» OLE‑содержание не выполняется при рендеринге. При необходимости задайте собственное изображение превью, чтобы обеспечить ожидаемый вид в экспортированном PDF.

Как заблокировать OLE‑объект на слайде, чтобы пользователи не могли перемещать/редактировать его в PowerPoint?

Заблокируйте форму: Aspose.Slides предоставляет блокировки на уровне формы. Это не шифрование, но эффективно препятствует случайным изменениям и перемещениям.

Почему связанный объект Excel «перепрыгивает» или меняет размер при открытии презентации?

PowerPoint может обновлять превью связанного OLE. Для стабильного отображения следуйте рекомендациям Working Solution for Worksheet Resizing — либо подгоните кадр под диапазон, либо масштабируйте диапазон до фиксированного кадра и задайте соответствующее замещающее изображение.

Будут ли относительные пути для связанных OLE‑объектов сохранены в формате PPTX?

В PPTX информация о «относительном пути» недоступна — сохраняется только полный путь. Относительные пути присутствуют в старом формате PPT. Для переносимости предпочтительнее использовать надёжные абсолютные пути/доступные URI или встраивание.

Cpp: Управление медиа

Mon, 01 Jan 0001 00:00:00 +0000

Экспорт медиафайла в HTML

Чтобы экспортировать медиафайлы в формате HTML, Aspose.Slides для C++ предоставляет простой API для управления данными диаграмм. Пожалуйста, следуйте приведённым ниже шагам:

Создайте экземпляр класса Presentation.
Получите ссылку на слайд.
Установите эффект перехода.
Запишите презентацию в файл PPTX.

В приведённом ниже примере мы экспортировали медиафайлы в HTML.

Cpp: Управление текстом

Mon, 01 Jan 0001 00:00:00 +0000

Cpp: Управление масштабированием презентации в C++

Mon, 01 Jan 0001 00:00:00 +0000

Обзор

Zoom в PowerPoint позволяет переходить к определённым слайдам, разделам и частям презентации и обратно. При представлении эта возможность быстро перемещаться по содержимому может оказаться очень полезной.

Чтобы суммировать всю презентацию на одном слайде, используйте Summary Zoom.
Чтобы показывать только выбранные слайды, используйте Slide Zoom.
Чтобы показывать только один раздел, используйте Section Zoom.

Zoom слайда

Zoom слайда может сделать вашу презентацию более динамичной, позволяя свободно перемещаться между слайдами в любом порядке без прерывания её потока. Zoom слайды отлично подходят для коротких презентаций без множества разделов, но их можно использовать и в других сценариях.

Zoom слайды помогают исследовать несколько блоков информации, будто вы работаете на едином холсте.

Для объектов Zoom слайда Aspose.Slides предоставляет перечисление ZoomImageType, интерфейс IZoomFrame и некоторые методы интерфейса IShapeCollection.

Создание Zoom Frames

Вы можете добавить Zoom‑кадр на слайд следующим образом:

Создайте экземпляр класса Presentation.
Создайте новые слайды, к которым планируете привязать Zoom‑кадры.
Добавьте идентификационный текст и фон к созданным слайдам.
Добавьте Zoom‑кадры (с содержащими ссылками на созданные слайды) к первому слайду.
Запишите изменённую презентацию в файл PPTX.

Этот код C++ показывает, как создать Zoom‑кадр на слайде:

void SetSlideBackground(SharedPtr<ISlide> slide, Color color)
{
    slide->get_Background()->get_FillFormat()->set_FillType(FillType::Solid);
    slide->get_Background()->get_FillFormat()->get_SolidFillColor()->set_Color(color);
    slide->get_Background()->set_Type(BackgroundType::OwnBackground);
}

auto pres = System::MakeObject<Presentation>();
auto slide0 = pres->get_Slides()->idx_get(0);

//Добавляет новые слайды в презентацию
auto slide2 = pres->get_Slides()->AddEmptySlide(slide0->get_LayoutSlide());
auto slide3 = pres->get_Slides()->AddEmptySlide(slide0->get_LayoutSlide());

//Создает фон для второго слайда
SetSlideBackground(slide2, Color::get_Cyan());

//Создает текстовое поле для второго слайда
auto autoshape = slide2->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 100.0f, 200.0f, 500.0f, 200.0f);
autoshape->get_TextFrame()->set_Text(u"Second Slide");

//Создает фон для третьего слайда
SetSlideBackground(slide3, Color::get_DarkKhaki());

//Создает текстовое поле для третьего слайда
autoshape = slide3->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 100.0f, 200.0f, 500.0f, 200.0f);
autoshape->get_TextFrame()->set_Text(u"Trird Slide");

//Добавляет объекты ZoomFrame
slide0->get_Shapes()->AddZoomFrame(20.0f, 20.0f, 250.0f, 200.0f, slide2);
slide0->get_Shapes()->AddZoomFrame(200.0f, 250.0f, 250.0f, 200.0f, slide3);

//Сохраняет презентацию
pres->Save(u"presentation.pptx", SaveFormat::Pptx);

Создание Zoom Frames с пользовательскими изображениями

С помощью Aspose.Slides for C++ вы можете создать Zoom‑кадр с другим изображением предварительного просмотра слайда следующим образом:

Создайте экземпляр класса Presentation.
Создайте новый слайд, к которому планируете привязать Zoom‑кадр.
Добавьте идентификационный текст и фон к слайду.
Создайте объект IPPImage, добавив изображение в коллекцию Images, связанную с объектом Presentation, которое будет использовано для заполнения кадра.
Добавьте Zoom‑кадры (с ссылкой на созданный слайд) к первому слайду.
Запишите изменённую презентацию в файл PPTX.

Этот код C++ показывает, как создать Zoom‑кадр с другим изображением:

auto pres = System::MakeObject<Presentation>();
auto slide0 = pres->get_Slides()->idx_get(0);

//Добавляет новый слайд в презентацию
auto slide = pres->get_Slides()->AddEmptySlide(slide0->get_LayoutSlide());

// Создаёт фон для второго слайда
SetSlideBackground(slide, Color::get_Cyan());

// Создаёт текстовое поле для третьего слайда
auto autoshape = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 100.0f, 200.0f, 500.0f, 200.0f);
autoshape->get_TextFrame()->set_Text(u"Second Slide");

// Создаёт новое изображение для объекта Zoom
auto image = pres->get_Images()->AddImage(Images::FromFile(u"image.png"));

//Добавляет объект ZoomFrame
slide0->get_Shapes()->AddZoomFrame(20.0f, 20.0f, 300.0f, 200.0f, slide, image);

// Сохраняет презентацию
pres->Save(u"presentation.pptx", SaveFormat::Pptx);

Форматирование Zoom Frames

В предыдущих разделах мы показывали, как создать простые Zoom‑кадры. Чтобы создать более сложные Zoom‑кадры, необходимо изменить их форматирование. Существует несколько вариантов форматирования, которые можно применить к Zoom‑кадру.

Вы можете управлять форматированием Zoom‑кадра на слайде следующим образом:

Создайте экземпляр класса Presentation.
Создайте новые слайды, к которым планируете привязать Zoom‑кадр.
Добавьте некоторый идентификационный текст и фон к созданным слайдам.
Добавьте Zoom‑кадры (с содержащими ссылки на созданные слайды) к первому слайду.
Создайте объект IPPImage, добавив изображение в коллекцию Images, связанную с объектом Presentation, которое будет использовано для заполнения кадра.
Установите пользовательское изображение для первого объекта Zoom‑кадра.
Измените формат линии для второго объекта Zoom‑кадра.
Удалите фон у изображения второго объекта Zoom‑кадра.
Запишите изменённую презентацию в файл PPTX.

Этот код C++ показывает, как изменить форматирование Zoom‑кадра на слайде:

auto pres = System::MakeObject<Presentation>();
auto slide1 = pres->get_Slides()->idx_get(0);
//Добавляет новые слайды в презентацию
auto slide2 = pres->get_Slides()->AddEmptySlide(slide1->get_LayoutSlide());
auto slide3 = pres->get_Slides()->AddEmptySlide(slide1->get_LayoutSlide());

// Создаёт фон для второго слайда
SetSlideBackground(slide2, Color::get_Cyan());

// Создаёт текстовое поле для второго слайда
auto autoshape = slide2->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 100.0f, 200.0f, 500.0f, 200.0f);
autoshape->get_TextFrame()->set_Text(u"Second Slide");

// Создаёт фон для третьего слайда
SetSlideBackground(slide3, Color::get_DarkKhaki());

// Создаёт текстовое поле для третьего слайда
autoshape = slide3->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 100.0f, 200.0f, 500.0f, 200.0f);
autoshape->get_TextFrame()->set_Text(u"Trird Slide");

//Добавляет объекты ZoomFrame
auto zoomFrame1 = slide1->get_Shapes()->AddZoomFrame(20.0f, 20.0f, 250.0f, 200.0f, slide2);
auto zoomFrame2 = slide1->get_Shapes()->AddZoomFrame(200.0f, 250.0f, 250.0f, 200.0f, slide3);

// Создаёт новое изображение для объекта zoom
auto image = pres->get_Images()->AddImage(Images::FromFile(u"image.png"));
// Устанавливает пользовательское изображение для объекта zoomFrame1
zoomFrame1->set_Image(image);

// Устанавливает формат рамки зума для объекта zoomFrame2
zoomFrame2->get_LineFormat()->set_Width(5);
zoomFrame2->get_LineFormat()->get_FillFormat()->set_FillType(FillType::Solid);
zoomFrame2->get_LineFormat()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_HotPink());
zoomFrame2->get_LineFormat()->set_DashStyle(LineDashStyle::DashDot);

// Настройка: не показывать фон для объекта zoomFrame2
zoomFrame2->set_ShowBackground(false);

// Сохраняет презентацию
pres->Save(u"presentation.pptx", SaveFormat::Pptx);

Section Zoom

Section Zoom — это ссылка на раздел в вашей презентации. Вы можете использовать Section Zoom, чтобы возвращаться к разделам, которые хотите особенно подчеркнуть, или чтобы показать, как отдельные части презентации связаны друг с другом.

Для объектов Section Zoom Aspose.Slides предоставляет интерфейс ISectionZoomFrame и некоторые методы интерфейса IShapeCollection.

Создание Section Zoom Frames

Вы можете добавить Section Zoom‑кадр на слайд следующим образом:

Создайте экземпляр класса Presentation.
Создайте новый слайд.
Добавьте идентификационный фон к созданному слайду.
Создайте новый раздел, к которому планируете привязать Zoom‑кадр.
Добавьте Section Zoom‑кадр (с ссылками на созданный раздел) к первому слайду.
Запишите изменённую презентацию в файл PPTX.

Этот код C++ показывает, как создать Zoom‑кадр на слайде:

auto pres = System::MakeObject<Presentation>();
auto slide0 = pres->get_Slides()->idx_get(0);

//Добавляет новый слайд в презентацию
auto slide = pres->get_Slides()->AddEmptySlide(slide0->get_LayoutSlide());
SetSlideBackground(slide, Color::get_YellowGreen());

// Добавляет новый раздел в презентацию
pres->get_Sections()->AddSection(u"Section 1", slide);

// Добавляет объект SectionZoomFrame
auto sectionZoomFrame = slide0->get_Shapes()->AddSectionZoomFrame(20.0f, 20.0f, 300.0f, 200.0f, pres->get_Sections()->idx_get(1));

// Сохраняет презентацию
pres->Save(u"presentation.pptx", SaveFormat::Pptx);

Создание Section Zoom Frames с пользовательскими изображениями

С помощью Aspose.Slides for C++ вы можете создать Section Zoom‑кадр с другим изображением предварительного просмотра слайда следующим образом:

Создайте экземпляр класса Presentation.
Создайте новый слайд.
Добавьте идентификационный фон к созданному слайду.
Создайте новый раздел, к которому планируете привязать Zoom‑кадр.
Создайте объект IPPImage, добавив изображение в коллекцию Images, связанную с объектом Presentation, которое будет использовано для заполнения кадра.
Добавьте Section Zoom‑кадр (с ссылкой на созданный раздел) к первому слайду.
Запишите изменённую презентацию в файл PPTX.

Этот код C++ показывает, как создать Zoom‑кадр с другим изображением:

auto pres = System::MakeObject<Presentation>();
auto slide0 = pres->get_Slides()->idx_get(0);

//Добавляет новый слайд в презентацию
auto slide = pres->get_Slides()->AddEmptySlide(slide0->get_LayoutSlide());
SetSlideBackground(slide, Color::get_YellowGreen());

// Adds a new Section to the presentation
pres->get_Sections()->AddSection(u"Section 1", slide);

// Создает новое изображение для объекта zoom
auto image = pres->get_Images()->AddImage(Images::FromFile(u"image.png"));

// Adds SectionZoomFrame object
auto sectionZoomFrame = slide0->get_Shapes()->AddSectionZoomFrame(20.0f, 20.0f, 300.0f, 200.0f, pres->get_Sections()->idx_get(1), image);

// Saves the presentation
pres->Save(u"presentation.pptx", SaveFormat::Pptx);

Форматирование Section Zoom Frames

Чтобы создать более сложные Section Zoom‑кадры, необходимо изменить их форматирование. Существует несколько вариантов форматирования, которые можно применить к Section Zoom‑кадру.

Вы можете управлять форматированием Section Zoom‑кадра на слайде следующим образом:

Создайте экземпляр класса Presentation.
Создайте новый слайд.
Добавьте идентификационный фон к созданному слайду.
Создайте новый раздел, к которому планируете привязать Zoom‑кадр.
Добавьте Section Zoom‑кадр (с ссылками на созданный раздел) к первому слайду.
Измените размер и положение созданного объекта Section Zoom.
Создайте объект IPPImage, добавив изображение в коллекцию Images, связанную с объектом Presentation, которое будет использовано для заполнения кадра.
Установите пользовательское изображение для созданного Section Zoom‑кадра.
Установите возможность возврата к оригинальному слайду из связанного раздела.
Удалите фон у изображения объекта Section Zoom‑кадра.
Измените формат линии для второго Zoom‑кадра.
Измените длительность перехода.
Запишите изменённую презентацию в файл PPTX.

Этот код C++ показывает, как изменить форматирование Section Zoom‑кадра:

auto pres = System::MakeObject<Presentation>();
auto slide0 = pres->get_Slides()->idx_get(0);

//Добавляет новый слайд в презентацию
auto slide = pres->get_Slides()->AddEmptySlide(slide0->get_LayoutSlide());
SetSlideBackground(slide, Color::get_YellowGreen());

// Добавляет новый раздел в презентацию
pres->get_Sections()->AddSection(u"Section 1", slide);

// Добавляет объект SectionZoomFrame
auto sectionZoomFrame = slide0->get_Shapes()->AddSectionZoomFrame(20.0f, 20.0f, 300.0f, 200.0f, pres->get_Sections()->idx_get(1));

// Форматирование для SectionZoomFrame
sectionZoomFrame->set_X(100.0f);
sectionZoomFrame->set_Y(300.0f);
sectionZoomFrame->set_Width(100.0f);
sectionZoomFrame->set_Height(75.0f);

auto image = pres->get_Images()->AddImage(Images::FromFile(u"image.png"));
sectionZoomFrame->set_Image(image);

sectionZoomFrame->set_ReturnToParent(true);
sectionZoomFrame->set_ShowBackground(false);

auto sectionZoomLineFormat = sectionZoomFrame->get_LineFormat();
sectionZoomLineFormat->get_FillFormat()->set_FillType(FillType::Solid);
sectionZoomLineFormat->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Brown());
sectionZoomLineFormat->set_DashStyle(LineDashStyle::DashDot);
sectionZoomLineFormat->set_Width(2.5f);

sectionZoomFrame->set_TransitionDuration(1.5f);

// Сохраняет презентацию
pres->Save(u"presentation.pptx", SaveFormat::Pptx);

Summary Zoom

Summary Zoom — это как целевая страница, на которой одновременно отображаются все части вашей презентации. При представлении вы можете использовать Zoom, чтобы перемещаться от одного места к другому в любом порядке, проявляя креативность, пропуская части или возвращаясь к предыдущим слайдам без нарушения потока презентации.

Для объектов Summary Zoom Aspose.Slides предоставляет интерфейсы ISummaryZoomFrame, ISummaryZoomSection и ISummaryZoomSectionCollection, а также некоторые методы интерфейса IShapeCollection.

Создание Summary Zoom

Вы можете добавить Summary Zoom‑кадр на слайд следующим образом:

Создайте экземпляр класса Presentation.
Создайте новые слайды с идентификационным фоном и новые разделы для созданных слайдов.
Добавьте Summary Zoom‑кадр к первому слайду.
Запишите изменённую презентацию в файл PPTX.

Этот код C++ показывает, как создать Summary Zoom‑кадр на слайде:

auto pres = System::MakeObject<Presentation>();
auto slide0 = pres->get_Slides()->idx_get(0);

// Добавляет новый слайд в презентацию
auto slide = pres->get_Slides()->AddEmptySlide(slide0->get_LayoutSlide());
SetSlideBackground(slide, Color::get_Brown());

// Добавляет новый раздел в презентацию
pres->get_Sections()->AddSection(u"Section 1", slide);

// Добавляет новый слайд в презентацию
slide = pres->get_Slides()->AddEmptySlide(slide0->get_LayoutSlide());
SetSlideBackground(slide, Color::get_Aqua());

// Добавляет новый раздел в презентацию
pres->get_Sections()->AddSection(u"Section 2", slide);

// Добавляет новый слайд в презентацию
slide = pres->get_Slides()->AddEmptySlide(slide0->get_LayoutSlide());
SetSlideBackground(slide, Color::get_Chartreuse());

// Добавляет новый раздел в презентацию
pres->get_Sections()->AddSection(u"Section 3", slide);

// Добавляет новый слайд в презентацию
slide = pres->get_Slides()->AddEmptySlide(slide0->get_LayoutSlide());
SetSlideBackground(slide, Color::get_DarkGreen());

// Добавляет новый раздел в презентацию
pres->get_Sections()->AddSection(u"Section 4", slide);

// Добавляет объект SummaryZoomFrame
auto summaryZoomFrame = slide0->get_Shapes()->AddSummaryZoomFrame(150.0f, 50.0f, 300.0f, 200.0f);

// Сохраняет презентацию
pres->Save(u"presentation.pptx", SaveFormat::Pptx);

Добавление и удаление раздела Summary Zoom

Все разделы в Summary Zoom‑кадре представлены объектами ISummaryZoomSection, которые хранятся в объекте ISummaryZoomSectionCollection. Вы можете добавить или удалить объект раздела Summary Zoom через интерфейс [ISummaryZoomSectionCollection] следующим образом:

Создайте экземпляр класса Presentation.
Создайте новые слайды с идентификационным фоном и новые разделы для созданных слайдов.
Добавьте Summary Zoom‑кадр в первый слайд.
Добавьте новый слайд и раздел в презентацию.
Добавьте созданный раздел в Summary Zoom‑кадр.
Удалите первый раздел из Summary Zoom‑кадра.
Запишите изменённую презентацию в файл PPTX.

Этот код C++ показывает, как добавить и удалить разделы в Summary Zoom‑кадре:

auto pres = System::MakeObject<Presentation>();
auto slide0 = pres->get_Slides()->idx_get(0);

// Добавляет новый слайд в презентацию
auto slide = pres->get_Slides()->AddEmptySlide(slide0->get_LayoutSlide());
SetSlideBackground(slide, Color::get_Brown());

// Добавляет новый раздел в презентацию
pres->get_Sections()->AddSection(u"Section 1", slide);

// Добавляет новый слайд в презентацию
slide = pres->get_Slides()->AddEmptySlide(slide0->get_LayoutSlide());
SetSlideBackground(slide, Color::get_Aqua());

// Добавляет новый раздел в презентацию
pres->get_Sections()->AddSection(u"Section 2", slide);

// Добавляет объект SummaryZoomFrame
auto summaryZoomFrame = slide0->get_Shapes()->AddSummaryZoomFrame(150.0f, 50.0f, 300.0f, 200.0f);

// Добавляет новый слайд в презентацию
slide = pres->get_Slides()->AddEmptySlide(slide0->get_LayoutSlide());
SetSlideBackground(slide, Color::get_Chartreuse());

// Добавляет новый раздел в презентацию
auto section3 = pres->get_Sections()->AddSection(u"Section 3", slide);

// Добавляет раздел в Summary Zoom
summaryZoomFrame->get_SummaryZoomCollection()->AddSummaryZoomSection(section3);

// Удаляет раздел из Summary Zoom
summaryZoomFrame->get_SummaryZoomCollection()->RemoveSummaryZoomSection(pres->get_Sections()->idx_get(1));

// Сохраняет презентацию
pres->Save(u"presentation.pptx", SaveFormat::Pptx);

Форматирование разделов Summary Zoom

Чтобы создать более сложные объекты разделов Summary Zoom, необходимо изменить их форматирование. Существует несколько вариантов форматирования, которые можно применить к объекту раздела Summary Zoom.

Вы можете управлять форматированием объекта раздела Summary Zoom в Summary Zoom‑кадре следующим образом:

Создайте экземпляр класса Presentation.
Создайте новые слайды с идентификационным фоном и новые разделы для созданных слайдов.
Добавьте Summary Zoom‑кадр к первому слайду.
Получите объект раздела Summary Zoom из ISummaryZoomSectionCollection для первого элемента.
Создайте объект IPPImage, добавив изображение в коллекцию images, связанную с объектом Presentation, которое будет использовано для заполнения кадра.
Установите пользовательское изображение для созданного объекта раздела Zoom.
Установите возможность возврата к оригинальному слайду из связанного раздела.
Измените формат линии для второго Zoom‑кадра.
Измените длительность перехода.
Запишите изменённую презентацию в файл PPTX.

Этот код C++ показывает, как изменить форматирование объекта раздела Summary Zoom:

auto pres = System::MakeObject<Presentation>();
auto slide0 = pres->get_Slides()->idx_get(0);

//Adds a new slide to the presentation
// Добавляет новый раздел в презентацию
pres->get_Sections()->AddSection(u"Section 1", slide);

//Adds a new slide to the presentation
// Adds a new section to the presentation
pres->get_Sections()->AddSection(u"Section 2", slide);

// Adds a SummaryZoomFrame object
auto summaryZoomFrame = slide0->get_Shapes()->AddSummaryZoomFrame(150.0f, 50.0f, 300.0f, 200.0f);

// Gets the first SummaryZoomSection object
auto summarySection = summaryZoomFrame->get_SummaryZoomCollection()->idx_get(0);

// Formatting for SummaryZoomSection object
auto image = pres->get_Images()->AddImage(Images::FromFile(u"image.png"));
summarySection->set_Image(image);

summarySection->set_ReturnToParent(false);

summarySection->get_LineFormat()->get_FillFormat()->set_FillType(FillType::Solid);
summarySection->get_LineFormat()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Black());
summarySection->get_LineFormat()->set_DashStyle(LineDashStyle::DashDot);
summarySection->get_LineFormat()->set_Width(1.5f);

summarySection->set_TransitionDuration(1.5f);

// Saves the presentation
pres->Save(u"presentation.pptx", SaveFormat::Pptx);

FAQ

Могу ли я контролировать возврат к «родительскому» слайду после показа цели?

Да. У объекта Zoom frame или section есть метод set_ReturnToParent, который возвращает зрителя к исходному слайду после просмотра целевого содержимого.

Можно ли регулировать «скорость» или длительность перехода Zoom?

Да. Zoom поддерживает установку длительности перехода, что позволяет контролировать, как долго длится анимация прыжка.

Есть ли ограничения на количество объектов Zoom в презентации?

Жёсткого ограничения API не задокументировано. Практические ограничения зависят от сложности презентации и производительности устройства просмотра. Можно добавить много Zoom‑кадров, но следует учитывать размер файла и время рендеринга.

Cpp: Диаграммы PowerPoint

Mon, 01 Jan 0001 00:00:00 +0000

Cpp: Добавить математические уравнения в презентации PowerPoint на С++

Mon, 01 Jan 0001 00:00:00 +0000

Обзор

В PowerPoint можно написать математическое уравнение или формулу и отобразить её в презентации. Для этого в PowerPoint представлены различные математические символы, которые можно добавить в текст или уравнение. Для создания сложных формул, таких как:

Дробь
Радикал
Функция
Пределы и логарифмические функции
N-арные операции
Матрица
Большие операторы
Функции sin, cos

используется конструктор математических уравнений в PowerPoint.

Для добавления математического уравнения в PowerPoint используется меню Insert → Equation:

Это создаёт математический текст в XML, который может быть отображён в PowerPoint следующим образом:

PowerPoint поддерживает множество математических символов для создания уравнений. Однако создание сложных уравнений в PowerPoint часто не даёт хорошего и профессионального результата. Пользователи, которым часто требуется создавать математические презентации, прибегают к сторонним решениям для получения красиво оформленных формул.

Используя Aspose.Slide API, вы можете программно работать с математическими уравнениями в презентациях PowerPoint на C++. Создавать новые математические выражения или редактировать уже созданные. Экспорт математических структур в изображения также поддерживается частично.

Как создать математическое уравнение

Математические элементы используются для построения любых математических конструкций любой степени вложенности. Последовательность математических элементов образует математический блок, представленный классом MathBlock. Класс MathBlock по сути представляет отдельное математическое выражение, формулу или уравнение. Класс MathPortion — это математическая часть, используемая для хранения математического текста (не путать с Portion). Класс MathParagraph позволяет управлять набором математических блоков. Указанные классы являются ключом к работе с математическими уравнениями PowerPoint через Aspose.Slides API.

Рассмотрим, как создать следующее математическое уравнение с помощью Aspose.Slides API:

Чтобы добавить математическое выражение на слайд, сначала добавьте фигуру, в которой будет содержаться математический текст:

auto pres = System::MakeObject<Presentation>();
auto mathShape = pres->get_Slides()->idx_get(0)->get_Shapes()->AddMathShape(0.0f, 0.0f, 720.0f, 150.0f);

После создания фигура уже содержит один абзац с математической частью по умолчанию. Класс MathPortion — это часть, содержащая математический текст. Чтобы получить доступ к содержимому внутри MathPortion, обратитесь к переменной MathParagraph:

 auto mathParagraph = (System::AsCast<MathPortion>(mathShape->get_TextFrame()->get_Paragraphs()->idx_get(0)->get_Portions()->idx_get(0)))->get_MathParagraph();

Класс MathParagraph позволяет читать, добавлять, редактировать и удалять математические блоки (MathBlock), состоящие из комбинации математических элементов. Например, создать дробь и разместить её в презентации:

auto fraction = System::MakeObject<MathematicalText>(u"x")->Divide(u"y");
mathParagraph->Add(System::MakeObject<MathBlock>(fraction));

Каждый математический элемент представлен классом, реализующим интерфейс IMathElement. Этот интерфейс предоставляет множество методов для простого создания математических выражений. Можно создать достаточно сложное выражение одной строкой кода. Например, теорема Пифагора будет выглядеть так:

auto mathBlock = System::MakeObject<MathematicalText>(u"c")
  ->SetSuperscript(u"2")
  ->Join(u"=")
  ->Join(System::MakeObject<MathematicalText>(u"a")->SetSuperscript(u"2"))
  ->Join(u"+")
  ->Join(System::MakeObject<MathematicalText>(u"b")->SetSuperscript(u"2"));

Операции интерфейса IMathElement реализованы во всех типах элементов, включая MathBlock.

Полный пример кода:

auto pres = System::MakeObject<Presentation>();
auto mathShape = pres->get_Slides()->idx_get(0)->get_Shapes()->AddMathShape(0.0f, 0.0f, 720.0f, 150.0f);
auto mathParagraph = (System::AsCast<MathPortion>(mathShape->get_TextFrame()->get_Paragraphs()->idx_get(0)->get_Portions()->idx_get(0)))->get_MathParagraph();

auto fraction = System::MakeObject<MathematicalText>(u"x")->Divide(u"y");
mathParagraph->Add(System::MakeObject<MathBlock>(fraction));

auto mathBlock = System::MakeObject<MathematicalText>(u"c")
  ->SetSuperscript(u"2")
  ->Join(u"=")
  ->Join(System::MakeObject<MathematicalText>(u"a")->SetSuperscript(u"2"))
  ->Join(u"+")->Join(System::MakeObject<MathematicalText>(u"b")->SetSuperscript(u"2"));
mathParagraph->Add(mathBlock);

pres->Save(u"math.pptx", SaveFormat::Pptx);

Типы математических элементов

Математические выражения формируются из последовательностей математических элементов. Последовательность элементов представлена математическим блоком, а аргументы элементов образуют древовидную вложенность.

Существует множество типов математических элементов, которые можно использовать для построения математического блока. Каждый такой элемент может быть включён (агрегирован) в другой элемент. Таким образом, элементы выступают контейнерами для других, образуя древовидную структуру. Самый простой тип элемента не содержит других элементов математического текста.

Каждый тип элемента реализует интерфейс IMathElement, позволяя использовать общий набор математических операций для разных типов элементов.

Класс MathematicalText

Класс MathematicalText представляет математический текст — базовый элемент всех математических конструкций. Математический текст может представлять операнды и операторы, переменные и любой линейный текст.

Пример: 𝑎=𝑏+𝑐

Класс MathFraction

Класс MathFraction определяет объект дроби, состоящий из числителя и знаменателя, разделённых чертой. Черта может быть горизонтальной или диагональной в зависимости от свойств дроби. Объект дроби также используется для представления функции стека, размещающей один элемент над другим без черты.

Пример:

Класс MathRadical

Класс MathRadical определяет радикальную функцию (корень), состоящую из основания и, при желании, степени.

Пример:

Класс MathFunction

Класс MathFunction определяет функцию от аргумента. Содержит методы: get_Name() — имя функции и get_Base() — аргумент функции.

Пример:

Класс MathNaryOperator

Класс MathNaryOperator определяет N‑арный математический объект, такой как сумма или интеграл. Он состоит из оператора, основания (или операнда) и опциональных верхних и нижних пределов. Примеры N‑арных операторов: сумма, объединение, пересечение, интеграл.

Этот класс не включает простые операторы вроде сложения или вычитания; они представлены одним текстовым элементом MathematicalText.

Пример:

Класс MathLimit

Класс MathLimit создаёт верхний или нижний предел. Он состоит из текста на базовой линии и уменьшенного текста непосредственно над или под ним. Этот элемент не включает слово “lim”, но позволяет разместить текст сверху или снизу выражения. Таким образом, выражение

создаётся комбинацией элементов MathFunction и MathLimit:

auto funcName = System::MakeObject<MathLimit>(System::MakeObject<MathematicalText>(u"lim"), System::MakeObject<MathematicalText>(u"𝑥→∞"));
auto mathFunc = System::MakeObject<MathFunction>(funcName, System::MakeObject<MathematicalText>(u"𝑥"));

Классы MathSubscriptElement, MathSuperscriptElement, MathRightSubSuperscriptElement, MathLeftSubSuperscriptElement

Перечисленные классы задают нижний или верхний индекс. Можно одновременно задавать и подпись, и надпись слева или справа от аргумента, но одиночный нижний или верхний индекс поддерживается только справа. Класс MathSubscriptElement может также использоваться для задания степени числа.

Пример:

Класс MathMatrix

Класс MathMatrix определяет объект матрицы, состоящий из дочерних элементов, расположенных в одной или нескольких строках и столбцах. Важно отметить, что у матриц нет встроенных разделителей. Чтобы поместить матрицу в скобки, следует использовать объект‑разделитель IMathDelimiter. Null‑аргументы можно использовать для создания пробелов в матрице.

Пример:

Класс MathArray

Класс MathArray определяет вертикальный массив уравнений или любых математических объектов.

Пример:

Форматирование математических элементов

Класс MathBorderBox рисует прямоугольную или иную рамку вокруг IMathElement.
Пример:
Класс MathBox определяет логическое обрамление (упаковку) математического элемента. Например, объект‑коробка может выступать в роли эмулятора оператора с или без точки выравнивания, служить разрывом строки или группировать элементы, чтобы запретить разрывы внутри. Например, оператор “==” следует упаковать, чтобы предотвратить разрыв строки.
Класс MathDelimiter определяет объект‑разделитель, состоящий из открывающего и закрывающего символов (скобки, фигурные скобки, квадратные скобки, вертикальные черты) и одного или нескольких математических элементов внутри, разделённых указанным символом. Примеры: (𝑥2); [𝑥2|𝑦2].
Пример:
Класс MathAccent определяет функцию акцента, состоящую из основания и комбинируемого диакритического знака.
Пример: 𝑎́.
Класс MathBar определяет функцию черты, состоящую из базового аргумента и надчерты или подчёркивания.
Пример:
Класс MathGroupingCharacter определяет группирующий символ над или под выражением, обычно для подчёркивания взаимосвязей между элементами.
Пример:

Математические операции

Каждый математический элемент и математическое выражение (через MathBlock) реализует интерфейс IMathElement. Он позволяет применять операции к существующей структуре и формировать более сложные математические выражения. Все операции имеют два набора параметров: либо IMathElement, либо строку. При использовании строковые аргументы автоматически преобразуются в экземпляры MathematicalText. Ниже перечислены доступные в Aspose.Slides математические операции.

Метод Join

Объединяет математический элемент и формирует математический блок. Пример:

auto element1 = System::MakeObject<MathematicalText>(u"x");
    
auto element2 = System::MakeObject<MathematicalText>(u"y");

auto block = element1->Join(element2);

Метод Divide

Создаёт дробь указанного типа с текущим числителем и заданным знаменателем. Пример:

auto numerator = System::MakeObject<MathematicalText>(u"x");
auto fraction = numerator->Divide(u"y", MathFractionTypes::Linear);

Метод Enclose

Оборачивает элемент в указанные символы, такие как скобки или другие символы.

/// <summary>
/// Encloses a math element in parenthesis
/// </summary>
virtual System::SharedPtr<IMathDelimiter> Enclose() = 0;

/// <summary>
/// Encloses this element in specified characters such as parenthesis or another characters as framing
/// </summary>
virtual System::SharedPtr<IMathDelimiter> Enclose(char16_t beginningCharacter, char16_t endingCharacter) = 0;

Пример:

auto delimiter = System::MakeObject<MathematicalText>(u"x")->Enclose(u'[', u']');
auto delimiter2 = System::ExplicitCast<IMathElement>(System::MakeObject<MathematicalText>(u"elem1")->Join(u"elem2"))->Enclose();

Метод Function

Создаёт функцию от аргумента, используя текущий объект в качестве имени функции.

/// <summary>
/// Takes a function of an argument using this instance as the function name
/// </summary>
/// <param name="functionArgument">An argument of the function</param>

virtual System::SharedPtr<IMathFunction> Function(System::SharedPtr<IMathElement> functionArgument) = 0;

virtual System::SharedPtr<IMathFunction> Function(System::String functionArgument) = 0;

Пример:

auto func = System::MakeObject<MathematicalText>(u"sin")->Function(u"x");

Метод AsArgumentOfFunction

Принимает указанный метод функции, используя текущий объект в качестве аргумента. Можно:

указать строку как имя функции, например “cos”;
выбрать одно из предопределённых значений перечислений MathFunctionsOfOneArgument или MathFunctionsOfTwoArguments, например MathFunctionsOfOneArgument.ArcSin;
передать экземпляр IMathElement.

Пример:

auto funcName = System::MakeObject<MathLimit>(System::MakeObject<MathematicalText>(u"lim"), System::MakeObject<MathematicalText>(u"𝑛→∞"));
    
auto func1 = System::MakeObject<MathematicalText>(u"2x")->AsArgumentOfFunction(funcName);

auto func2 = System::MakeObject<MathematicalText>(u"x")->AsArgumentOfFunction(u"sin");

auto func3 = System::MakeObject<MathematicalText>(u"x")->AsArgumentOfFunction(MathFunctionsOfOneArgument::Sin);

auto func4 = System::MakeObject<MathematicalText>(u"x")->AsArgumentOfFunction(MathFunctionsOfTwoArguments::Log, u"3");

Методы SetSubscript, SetSuperscript, SetSubSuperscriptOnTheRight, SetSubSuperscriptOnTheLeft

Устанавливает нижний и верхний индексы. Можно задать их одновременно слева или справа от аргумента, но одиночный нижний или верхний индекс поддерживается только справа. Superscript также может использоваться для задания степени числа.

Пример:

auto script = System::MakeObject<MathematicalText>(u"y")->SetSubSuperscriptOnTheLeft(u"2x", u"3z");

Метод Radical

Задаёт радикал (корень) указанной степени от аргумента.

Пример:

auto radical = System::MakeObject<MathematicalText>(u"x")->Radical(u"3");

Методы SetUpperLimit и SetLowerLimit

Задаёт верхний или нижний предел. Здесь верхний и нижний просто указывают расположение аргумента относительно основания.

Рассмотрим выражение:

Такое выражение можно создать комбинацией классов MathFunction и MathLimit, а также операций интерфейса IMathElement:

auto mathExpression = System::MakeObject<MathematicalText>(u"lim")->SetLowerLimit(u"x→∞")->Function(u"x");

Методы Nary и Integral

Оба метода Nary и Integral создают и возвращают N‑арный оператор типа IMathNaryOperator. В методе Nary перечисление MathNaryOperatorTypes определяет тип оператора: сумма, объединение и т.д., но не включает интегралы. В методе Integral используется специализированный оператор интеграла с перечислением MathIntegralTypes.

Пример:

auto baseArg = System::MakeObject<MathematicalText>(u"x")->Join(System::MakeObject<MathematicalText>(u"dx")->ToBox());
auto integral = baseArg->Integral(MathIntegralTypes::Simple, u"0", u"1");

Метод ToMathArray

ToMathArray размещает элементы в вертикальном массиве. Если вызвать эту операцию у экземпляра MathBlock, все дочерние элементы будут помещены в возвращаемый массив.

Пример:

auto arrayFunction = System::MakeObject<MathematicalText>(u"x")->Join(u"y")->ToMathArray();

Операции форматирования: Accent, Overbar, Underbar, Group, ToBorderBox, ToBox

Метод Accent добавляет надстрочный диакритический знак (акцент).
Методы Overbar и Underbar добавляют черту сверху или снизу.
Метод Group размещает элементы в группе, используя группирующий символ, например нижнюю фигурную скобку.
Метод ToBorderBox помещает элемент в рамку.
Метод ToBox помещает элемент в логическую (не визуальную) коробку.

Примеры:

auto accent = System::MakeObject<MathematicalText>(u"x")->Accent(u'\u0303');
    
auto bar = System::MakeObject<MathematicalText>(u"x")->Overbar();

auto groupChr = System::MakeObject<MathematicalText>(u"x")->Join(u"y")->Join(u"z")->Group(u'\u23E1', MathTopBotPositions::Bottom, MathTopBotPositions::Top);

auto borderBox = System::MakeObject<MathematicalText>(u"x+y+z")->ToBorderBox();

auto boxedOperator = System::MakeObject<MathematicalText>(u":=")->ToBox();

FAQ

Как добавить математическое уравнение на слайд PowerPoint?

Чтобы добавить уравнение, необходимо создать объект математической фигуры, который автоматически содержит математическую часть. Затем получить объект MathParagraph из MathPortion и добавить в него объекты MathBlock.

Можно ли создавать сложные вложенные математические выражения?

Да, Aspose.Slides позволяет создавать сложные выражения, вкладывая MathBlocks. Каждый математический элемент реализует интерфейс IMathElement, что позволяет применять операции (Join, Divide, Enclose и др.) для комбинирования элементов в более сложные структуры.

Как обновить или изменить существующее математическое уравнение?

Чтобы обновить уравнение, нужно получить доступ к существующим MathBlocks через MathParagraph. Затем с помощью методов Join, Divide, Enclose и других изменить отдельные элементы уравнения. После редактирования сохранить презентацию, чтобы изменения вступили в силу.

Cpp: Фигуры PowerPoint

Mon, 01 Jan 0001 00:00:00 +0000

Cpp: Управление объектами чернил в презентации на C++

Mon, 01 Jan 0001 00:00:00 +0000

PowerPoint предоставляет функцию чернил, позволяющую рисовать нестандартные фигуры, которые можно использовать для выделения других объектов, отображения связей и процессов, а также привлечения внимания к конкретным элементам на слайде.

Aspose.Slides предоставляет интерфейс Aspose.Slides.Ink, который содержит типы, необходимые для создания и управления объектами чернил.

Различия между обычными объектами и объектами чернил

Объекты на слайде PowerPoint обычно представлены объектами shape. Объект shape в своей простейшей форме представляет собой контейнер, определяющий область самого объекта (его рамку) вместе с его свойствами. Последние включают размер области контейнера, форму контейнера, фон контейнера и т.д. Для справки см. Shape Layout Format.

Однако когда PowerPoint работает с объектом чернил, он игнорирует все свойства рамки объекта (контейнера), кроме его размера. Размер области контейнера определяется стандартными значениями width и height:

Трассы Inkshape

Трасса — базовый элемент или стандарт, используемый для записи траектории пера, когда пользователь пишет цифровые чернила. Трасы — это записи, описывающие последовательности соединённых точек.

Самая простая форма кодирования указывает координаты X и Y каждой точки выборки. Когда все соединённые точки отрисовываются, они образуют изображение, похожее на это:

Свойства кисти для рисования

Вы можете использовать кисть для рисования линий, соединяющих точки элементов трассы. Кисть имеет собственный цвет и размер, соответствующие свойствам Brush.Color и Brush.Size.

Установка цвета кисти чернил

Этот C++ код показывает, как установить цвет кисти:

System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(u"pres.pptx");

System::SharedPtr<IInk> ink = System::ExplicitCast<IInk>(pres->get_Slide(0)->get_Shape(0));
System::ArrayPtr<System::SharedPtr<IInkTrace>> traces = ink->get_Traces();
System::SharedPtr<IInkBrush> brush = traces[0]->get_Brush();
System::Drawing::Color brushColor = brush->get_Color();
brush->set_Color(System::Drawing::Color::get_Red());

Установка размера кисти чернил

Этот C++ код показывает, как установить размер кисти:

System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(u"pres.pptx");

System::SharedPtr<IInk> ink = System::ExplicitCast<IInk>(pres->get_Slide(0)->get_Shape(0));
System::ArrayPtr<System::SharedPtr<IInkTrace>> traces = ink->get_Traces();
System::SharedPtr<IInkBrush> brush = traces[0]->get_Brush();
System::Drawing::SizeF brushSize = brush->get_Size();
brush->set_Size(System::Drawing::SizeF(5.0f, 10.0f));

Как правило, ширина и высота кисти не совпадают, поэтому PowerPoint не отображает размер кисти (раздел данных серый). Но когда ширина и высота кисти совпадают, PowerPoint отображает её размер так:

Для наглядности увеличим высоту объекта чернил и рассмотрим важные размеры:

Контейнер (рамка) не учитывает размер кистей — он всегда предполагает, что толщина линии равна нулю (см. последнее изображение).

Следовательно, чтобы определить видимую область всего объекта чернил, необходимо учитывать размер кисти объектов трассы. Здесь целевой объект (трасса рукописного текста) масштабирован до размера контейнера (рамки). Когда размер контейнера (рамки) изменяется, размер кисти остаётся постоянным и наоборот.

PowerPoint демонстрирует аналогичное поведение при работе с текстом:

Дополнительные материалы

Чтобы ознакомиться с фигурами в целом, см. раздел PowerPoint Shapes.
Для получения более подробной информации о эффективных значениях см. Shape Effective Properties.

Cpp: Смарт-объекты PowerPoint

Mon, 01 Jan 0001 00:00:00 +0000

Cpp: Таблица PowerPoint

Mon, 01 Jan 0001 00:00:00 +0000

Cpp: Управление тегами и пользовательскими данными в презентациях с использованием C++

Mon, 01 Jan 0001 00:00:00 +0000

Хранение данных в файлах презентаций

Файлы PPTX — объекты с расширением .pptx — хранятся в формате PresentationML, который является частью спецификации Office Open XML. Формат Office Open XML определяет структуру данных, содержащихся в презентациях.

Поскольку слайд является одним из элементов презентации, часть слайда содержит содержимое отдельного слайда. Части слайда могут иметь явные связи со многими другими частями — например, с пользовательскими тегами — определёнными в ISO/IEC 29500.

Пользовательские данные (специфичные для презентации) могут существовать в виде тегов (ITagCollection) и CustomXmlParts (ICustomXmlPartCollection).

Теги представляют собой пары значений строка‑ключ.

Получение значений тегов

В слайдах тег соответствует свойству IDocumentProperties.Keywords. Ниже приведён пример кода, показывающий, как получить значение тега с помощью Aspose.Slides для C++ для Presentation:

auto pres = System::MakeObject<Presentation>(u"pres.pptx");
System::String keywords = pres->get_DocumentProperties()->get_Keywords();

Добавление тегов в презентации

Aspose.Slides позволяет добавлять теги в презентации. Тег обычно состоит из двух элементов:

имя пользовательского свойства — MyTag
значение пользовательского свойства — My Tag Value

Если необходимо классифицировать некоторые презентации по определённому правилу или свойству, вы можете воспользоваться тегами. Например, если хотите собрать все презентации из стран Северной Америки, создайте тег «North American» и задайте в качестве значений соответствующие страны (США, Мексика и Канада).

Ниже показан пример кода, демонстрирующий, как добавить тег к Presentation с помощью Aspose.Slides для C++:

auto pres = System::MakeObject<Presentation>(u"pres.pptx");

System::SharedPtr<ITagCollection> tags = pres->get_CustomData()->get_Tags();
pres->get_CustomData()->get_Tags()->idx_set(u"MyTag", u"My Tag Value");

Теги также можно задать для Slide:

auto pres = System::MakeObject<Presentation>();

auto slide = pres->get_Slides()->idx_get(0);
slide->get_CustomData()->get_Tags()->idx_set(u"tag", u"value");

Или для любого отдельного Shape:

auto pres = System::MakeObject<Presentation>();

auto slide = pres->get_Slides()->idx_get(0);
auto shape = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 10.0f, 10.0f, 100.0f, 50.0f);
shape->get_TextFrame()->set_Text(u"My text");
shape->get_CustomData()->get_Tags()->idx_set(u"tag", u"value");

Часто задаваемые вопросы

Можно ли удалить все теги из презентации, слайда или фигуры одной операцией?

Да. Коллекция тегов поддерживает операцию clear, которая удаляет все пары ключ‑значение сразу.

Как удалить один тег по его имени без перебора всей коллекции?

Используйте операцию Remove(name) у TagCollection для удаления тега по его ключу.

Как получить полный список имён тегов для аналитики или фильтрации?

Вызовите GetNamesOfTags у коллекции тегов; она вернёт массив всех имён тегов.