# Управление фигурами презентации в C++ > Узнайте, как идентифицировать, настраивать, клонировать, удалять, скрывать, переупорядочивать, экспортировать, выравнивать и отражать фигуры презентации с помощью Aspose.Slides для C++. Source: https://docs.aspose.com/slides/ru/cpp/shape-manipulations/ Updated: 2026-09-02 ## **Обзор** Aspose.Slides for C++ представляет фигуры на слайде как упорядоченную [IShapeCollection](https://reference.aspose.com/slides/ru/cpp/aspose.slides/ishapecollection/). Коллекция одновременно является местом, где вы находите и изменяете фигуры, и источником их порядка наложения: индекс `0` — самая задняя фигура, а последний индекс — самая передняя. В этой статье рассмотрена эта модель. Сначала объясняется, как надёжно определить фигуру и изменить предустановленные точки регулировки, затем показано, как клонировать, удалять, скрывать и переупорядочивать фигуры. В заключительных разделах рассматриваются форматирование уровня макета, экспорт в SVG, выравнивание и параметры отражения. Каждый пример независим, поэтому вы можете использовать только те операции, которые нужны вашему рабочему процессу. ## **Идентификация и поиск фигур** Индексы коллекции удобны при обработке известного файла, но они не являются стабильными идентификаторами. Добавление, удаление или переупорядочивание фигуры может изменить её индекс. Выбирайте идентификатор в зависимости от того, как презентация создаётся и поддерживается: - [Name](https://reference.aspose.com/slides/ru/cpp/aspose.slides/ishape/get_name/) полезно для шаблонов, контролируемых разработчиком, и легко просматривается в панели выбора PowerPoint. Имена можно изменять и они не гарантируются уникальными, поэтому задайте соглашение об именовании, если код зависит от них. - [AlternativeText](https://reference.aspose.com/slides/ru/cpp/aspose.slides/ishape/get_alternativetext/) удобно, когда доступное описание для людей с ограниченными возможностями или тег, добавленный автором, уже идентифицирует фигуру. Текст видим пользователям, может быть локализован или переписан для доступности и также не гарантирует уникальности. Не переиспользуйте осмысленный текст доступности в качестве ключа базы данных. - [OfficeInteropShapeId](https://reference.aspose.com/slides/ru/cpp/aspose.slides/ishape/get_officeinteropshapeid/) — идентификатор только для чтения, уникальный в пределах слайда и соответствующий ID фигуры, используемому в PowerPoint interop. Используйте его при интеграции с PowerPoint или когда нужен однозначный справочник в течение жизни фигуры. Клонированная или воссозданная фигура — другая фигура и получает собственный ID. Свойство [UniqueId](https://reference.aspose.com/slides/ru/cpp/aspose.slides/ishape/get_uniqueid/) имеет область действия презентации, но предназначено для надстроек и может быть переприсвоено. Его не следует рассматривать как постоянный внешний ключ. Если долговременная идентификация важна, храните сопоставление во внешних данных приложения и проверяйте, что требуемая фигура всё ещё существует. Следующий пример ищет по `Name` и сообщает ID interop в пределах слайда. Когда в шаблоне ожидаемая фигура отсутствует, код выводит этот результат вместо продолжения работы с неправильным объектом. ```cpp #include #include #include #include #include #include using namespace Aspose::Slides; using namespace System; auto presentation = MakeObject(u"input.pptx"); auto slide = presentation->get_Slide(0); SharedPtr targetShape; for (auto shape : slide->get_Shapes()) { if (shape->get_Name() == u"RevenueChart") { targetShape = shape; break; } } if (targetShape == nullptr) { Console::WriteLine(u"The shape 'RevenueChart' was not found on slide 1."); } else { Console::WriteLine(String::Format(u"Found {0}; interop ID: {1}", targetShape->get_Name(), targetShape->get_OfficeInteropShapeId())); } presentation->Dispose(); ``` Когда операция специфична для типа фигуры, проверьте интерфейс перед использованием членов, характерных для типа. Этот пример обновляет текст и альтернативный текст только если именованный объект является [IAutoShape](https://reference.aspose.com/slides/ru/cpp/aspose.slides/iautoshape/). ```cpp #include #include #include #include #include #include #include #include using namespace Aspose::Slides; using namespace Aspose::Slides::Export; using namespace System; auto presentation = MakeObject(u"input.pptx"); auto slide = presentation->get_Slide(0); SharedPtr candidate; for (auto shape : slide->get_Shapes()) { if (shape->get_Name() == u"StatusLabel") { candidate = shape; break; } } if (candidate != nullptr && ObjectExt::Is(candidate)) { auto autoShape = ExplicitCast(candidate); autoShape->get_TextFrame()->set_Text(u"Approved"); autoShape->set_AlternativeText(u"Approval status: approved"); presentation->Save(u"identified-shape.pptx", SaveFormat::Pptx); } else { Console::WriteLine(u"'StatusLabel' is missing or is not an AutoShape."); } presentation->Dispose(); ``` ## **Идентификация и изменение предустановленных регулировок фигур** Фигуры с предустановленной геометрией могут иметь точки регулировки, контролирующие такие параметры, как размер угла, пропорции стрелки или угол дуги. Доступ к ним осуществляется через только‑для‑чтения коллекцию [IGeometryShape::get_Adjustments](https://reference.aspose.com/slides/ru/cpp/aspose.slides/igeometryshape/get_adjustments/). Коллекцию поставляет сама фигура, а каждый [IAdjustValue](https://reference.aspose.com/slides/ru/cpp/aspose.slides/iadjustvalue/) содержит значение, которое можно изменить. Не полагайтесь только на фиксированный индекс в коллекции. Итерируйте регулировки и проверяйте свойство только‑для‑чтения [IAdjustValue::get_Type](https://reference.aspose.com/slides/ru/cpp/aspose.slides/iadjustvalue/get_type/), значение [ShapeAdjustmentType](https://reference.aspose.com/slides/ru/cpp/aspose.slides/shapeadjustmenttype/) которого описывает, что регулируется. Свойство только‑для‑чтения [IAdjustValue::get_Name](https://reference.aspose.com/slides/ru/cpp/aspose.slides/iadjustvalue/get_name/) даёт дополнительную идентификацию и особенно полезно, когда предустановка содержит более одной регулировки с одинаковым семантическим типом. Используйте свойство значения, соответствующее смыслу регулировки: | Тип регулировки | Назначение | Значение для изменения | |---|---|---| | `CornerSize` | Размер скруглённых углов | [RawValue](https://reference.aspose.com/slides/ru/cpp/aspose.slides/iadjustvalue/set_rawvalue/) | | `ArrowTailThickness` | Толщина хвоста стрелы | `RawValue` | | `ArrowheadLength` | Длина острия стрелы | `RawValue` | | `ArrowheadWidth` | Ширина острия стрелы | `RawValue` | | `StartAngle` | Начальный угол сектора или дуги | [AngleValue](https://reference.aspose.com/slides/ru/cpp/aspose.slides/iadjustvalue/set_anglevalue/) | | `EndAngle` | Конечный угол сектора или дуги | `AngleValue` | `Type` и `Name` нельзя назначать. `RawValue` — целочисленное значение, доступное для чтения и записи, в нативных единицах геометрии предустановки, тогда как `AngleValue` — угол в градусах, также читаемый и записываемый. Число, порядок, смысл и допустимый диапазон регулировок зависят от предустановленного [ShapeType](https://reference.aspose.com/slides/ru/cpp/aspose.slides/igeometryshape/get_shapetype/). Значение, допустимое для одной предустановки, может быть недопустимым или иметь иной эффект для другой. Когда `Type` равен `ShapeAdjustmentType::Custom`, API не распознаёт стандартный семантический смысл. Проверьте `Name`, тип предустановки и существующее значение, и оставьте регулировку без изменений, если ожидаемый смысл и диапазон неизвестны. Даже для распознанных типов проверяйте, встречается ли тот же тип более одного раза, прежде чем выбирать значение. Статья [Connector](/slides/ru/cpp/connector/) демонстрирует такой случай с регулировками изгиба соединителей. Следующий полный пример создаёт стандартные и изменённые версии трёх предустановленных фигур. Он проходит по каждой регулировке, выводит её `Name` и `Type`, изменяет значения, связанные с размером, через `RawValue`, изменяет углы через `AngleValue` и сохраняет результат. Левая колонка сохраняет исходную геометрию; правая показывает изменённый скруглённый прямоугольник, четырёхстороннюю стрелу и сектор. ```cpp #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include using namespace Aspose::Slides; using namespace Aspose::Slides::Export; using namespace System; auto presentation = MakeObject(); auto slide = presentation->get_Slide(0); // Добавляет заголовки для столбцов с фигурой по умолчанию и изменёнными значениями. auto defaultColumnLabel = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 40, 20, 250, 30); defaultColumnLabel->get_TextFrame()->set_Text(u"Default preset geometry"); auto adjustedColumnLabel = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 390, 20, 250, 30); adjustedColumnLabel->get_TextFrame()->set_Text(u"Modified adjustment values"); slide->get_Shapes()->AddAutoShape(ShapeType::RoundCornerRectangle, 80, 70, 160, 70); auto modifiedRoundedRectangle = slide->get_Shapes()->AddAutoShape(ShapeType::RoundCornerRectangle, 430, 70, 160, 70); modifiedRoundedRectangle->set_Name(u"ModifiedRoundedRectangle"); slide->get_Shapes()->AddAutoShape(ShapeType::QuadArrow, 80, 180, 160, 110); auto modifiedArrow = slide->get_Shapes()->AddAutoShape(ShapeType::QuadArrow, 430, 180, 160, 110); modifiedArrow->set_Name(u"ModifiedQuadArrow"); slide->get_Shapes()->AddAutoShape(ShapeType::Pie, 95, 330, 130, 130); auto modifiedPie = slide->get_Shapes()->AddAutoShape(ShapeType::Pie, 445, 330, 130, 130); modifiedPie->set_Name(u"ModifiedPie"); auto shapesToAdjust = MakeArray>({modifiedRoundedRectangle, modifiedArrow, modifiedPie}); for (auto shape : shapesToAdjust) { auto adjustments = shape->get_Adjustments(); for (int32_t adjustmentIndex = 0; adjustmentIndex < adjustments->get_Count(); ++adjustmentIndex) { auto adjustment = adjustments->idx_get(adjustmentIndex); Console::WriteLine(shape->get_Name() + u" / " + adjustment->get_Name() + u": " + ObjectExt::ToString(adjustment->get_Type())); switch (adjustment->get_Type()) { case ShapeAdjustmentType::CornerSize: adjustment->set_RawValue(5000); break; case ShapeAdjustmentType::ArrowTailThickness: adjustment->set_RawValue(25000); break; case ShapeAdjustmentType::ArrowheadLength: adjustment->set_RawValue(30000); break; case ShapeAdjustmentType::ArrowheadWidth: adjustment->set_RawValue(40000); break; case ShapeAdjustmentType::StartAngle: adjustment->set_AngleValue(30); break; case ShapeAdjustmentType::EndAngle: adjustment->set_AngleValue(300); break; case ShapeAdjustmentType::Custom: Console::WriteLine(u"Custom adjustment '" + adjustment->get_Name() + u"' was not changed."); break; } } } presentation->Save(u"preset-shape-adjustments.pptx", SaveFormat::Pptx); presentation->Dispose(); ``` Проверка семантического типа перед изменением значения делает код явным и избавляет от предположения, что конкретный индекс коллекции имеет одинаковый смысл в разных предустановках. ## **Изменение коллекции фигур** Методы добавления, клонирования, удаления и переупорядочивания работают с коллекцией немедленно. Если операция меняет количество или порядок фигур, не продолжайте пользоваться индексами, полученными до этой операции. ### **Клонирование фигуры** [AddClone](https://reference.aspose.com/slides/ru/cpp/aspose.slides/ishapecollection/addclone/) создаёт независимую копию и добавляет её в конец целевой коллекции. [InsertClone](https://reference.aspose.com/slides/ru/cpp/aspose.slides/ishapecollection/insertclone/) также создаёт копию, но размещает её по заданному индексу Z‑порядка. Перегрузки, принимающие координаты, перемещают клон без изменения размера; перегрузки с шириной и высотой могут изменять его размер. Пример создаёт целевой слайд, клонирует помеченный прямоугольник спереди и вставляет второй клон сзади. Изменения любого клона не влияют на исходную фигуру. ```cpp #include #include #include #include #include #include #include #include #include #include #include using namespace Aspose::Slides; using namespace Aspose::Slides::Export; using namespace System; auto presentation = MakeObject(); auto sourceSlide = presentation->get_Slide(0); auto sourceShape = sourceSlide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 40, 40, 180, 60); sourceShape->set_Name(u"SourceLabel"); sourceShape->get_TextFrame()->set_Text(u"Source"); auto blankLayout = presentation->get_LayoutSlides()->GetByType(SlideLayoutType::Blank); auto destinationSlide = presentation->get_Slides()->AddEmptySlide(blankLayout); auto frontCloneShape = destinationSlide->get_Shapes()->AddClone(sourceShape, 80, 80); frontCloneShape->set_Name(u"FrontClone"); if (ObjectExt::Is(frontCloneShape)) { auto frontClone = ExplicitCast(frontCloneShape); frontClone->get_TextFrame()->set_Text(u"Front clone"); } else { Console::WriteLine(u"The front clone is not an AutoShape; its text was not changed."); } auto backCloneShape = destinationSlide->get_Shapes()->InsertClone(0, sourceShape, 80, 180); backCloneShape->set_Name(u"BackClone"); if (ObjectExt::Is(backCloneShape)) { auto backClone = ExplicitCast(backCloneShape); backClone->get_TextFrame()->set_Text(u"Back clone"); } else { Console::WriteLine(u"The back clone is not an AutoShape; its text was not changed."); } presentation->Save(u"cloned-shapes.pptx", SaveFormat::Pptx); presentation->Dispose(); ``` Клонирование копирует содержимое и форматирование фигуры, включая её имя и альтернативный текст. Присвойте новые логические идентификаторы клону, если эти значения должны быть уникальными. Ресурсы, используемые комплексными фигурами, обрабатываются презентацией, но клон остаётся новым элементом коллекции с новой идентичностью фигуры. ### **Удаление фигур** [Remove](https://reference.aspose.com/slides/ru/cpp/aspose.slides/ishapecollection/remove/) удаляет конкретный объект фигуры из его коллекции. При удалении нескольких совпадений во время итерации по индексам проходите от конца, чтобы каждый оставшийся индекс оставался валидным. Этот пример удаляет каждую фигуру с заданным именем. Он читает текущую индексированную фигуру, а не фиксированный элемент коллекции, и не делает лишних привидений типа. ```cpp #include #include #include #include #include #include using namespace Aspose::Slides; using namespace Aspose::Slides::Export; using namespace System; auto presentation = MakeObject(); auto slide = presentation->get_Slide(0); auto keepShape = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 40, 40, 140, 60); keepShape->set_Name(u"Keep"); auto firstTemporaryShape = slide->get_Shapes()->AddAutoShape(ShapeType::Ellipse, 220, 40, 80, 80); firstTemporaryShape->set_Name(u"Temporary"); auto secondTemporaryShape = slide->get_Shapes()->AddAutoShape(ShapeType::Triangle, 340, 40, 100, 80); secondTemporaryShape->set_Name(u"Temporary"); for (int32_t i = slide->get_Shapes()->get_Count() - 1; i >= 0; --i) { auto shape = slide->get_Shape(i); if (shape->get_Name() == u"Temporary") { slide->get_Shapes()->Remove(shape); } } presentation->Save(u"removed-shapes.pptx", SaveFormat::Pptx); presentation->Dispose(); ``` После удаления меняются количество фигур и индексы последующих фигур. Ссылки на не затронутые фигуры остаются более надёжными, чем сохранённые индексы. Также учитывайте соединители, анимацию и другие элементы презентации, которые могут ссылаться на удалённый объект; удаление видимой фигуры может изменить не только внешний вид слайда. ### **Скрытие фигуры** Установка [Hidden](https://reference.aspose.com/slides/ru/cpp/aspose.slides/ishape/set_hidden/) в `true` оставляет фигуру в коллекции, но препятствует её отображению в обычной демонстрации. Её индекс, форматирование и содержимое остаются доступными коду, поэтому скрытие удобно для необязательных элементов, которые могут быть восстановлены позже. ```cpp #include #include #include #include #include #include using namespace Aspose::Slides; using namespace Aspose::Slides::Export; using namespace System; auto presentation = MakeObject(); auto slide = presentation->get_Slide(0); auto visibleShape = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 40, 40, 160, 60); visibleShape->set_Name(u"VisibleLabel"); auto optionalShape = slide->get_Shapes()->AddAutoShape(ShapeType::Moon, 240, 40, 100, 100); optionalShape->set_Name(u"OptionalDecoration"); for (auto shape : slide->get_Shapes()) { if (shape->get_Name() == u"OptionalDecoration") { shape->set_Hidden(true); } } presentation->Save(u"hidden-shape.pptx", SaveFormat::Pptx); presentation->Dispose(); ``` Скрытие — это не удаление и не защита. Объект всё ещё может быть обнаружен и сделан видимым пользователем или программой, и он остаётся частью файла презентации. ### **Изменение Z‑порядка** Перекрывающиеся фигуры рисуются в порядке коллекции. [Reorder](https://reference.aspose.com/slides/ru/cpp/aspose.slides/ishapecollection/reorder/) перемещает существующую фигуру к целевому индексу без её клонирования. Индекс `0` — задний; `Count - 1` — передний. ```cpp #include #include #include #include #include #include #include #include #include using namespace Aspose::Slides; using namespace Aspose::Slides::Export; using namespace System; using namespace System::Drawing; auto presentation = MakeObject(); auto slide = presentation->get_Slide(0); auto blueRectangle = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 100, 100, 220, 120); blueRectangle->set_Name(u"BlueRectangle"); blueRectangle->get_FillFormat()->set_FillType(FillType::Solid); blueRectangle->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_SteelBlue()); auto orangeEllipse = slide->get_Shapes()->AddAutoShape(ShapeType::Ellipse, 180, 140, 220, 120); orangeEllipse->set_Name(u"OrangeEllipse"); orangeEllipse->get_FillFormat()->set_FillType(FillType::Solid); orangeEllipse->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Orange()); slide->get_Shapes()->Reorder(slide->get_Shapes()->get_Count() - 1, blueRectangle); presentation->Save(u"reordered-shapes.pptx", SaveFormat::Pptx); presentation->Dispose(); ``` Прямоугольник создаётся первым и изначально находится позади эллипса. Перемещение его к последнему индексу помещает его вперёд. Завершайте упорядочивание Z‑порядка после добавления или клонирования всех связанных фигур, поскольку эти операции добавляют новые элементы в коллекцию и могут изменить желаемую стекацию. ## **Проверка фигур на макетных слайдах** Обычные слайды, макетные слайды и главный слайд имеют отдельные коллекции фигур. Фигура в коллекции макета — это не тот же объект, что аналогично расположенная фигура на обычном слайде. Проверяйте фигуры макета, когда нужно понять или изменить форматирование, задаваемое макетом. Следующий пример читает [FillFormat](https://reference.aspose.com/slides/ru/cpp/aspose.slides/ishape/get_fillformat/) и [LineFormat](https://reference.aspose.com/slides/ru/cpp/aspose.slides/ishape/get_lineformat/) каждой фигуры макета, не предполагая, что каждая фигура является `AutoShape`. ```cpp #include #include #include #include #include #include #include #include using namespace Aspose::Slides; using namespace System; auto presentation = MakeObject(u"input.pptx"); for (auto layoutSlide : presentation->get_LayoutSlides()) { for (auto shape : layoutSlide->get_Shapes()) { auto fillType = shape->get_FillFormat()->get_FillType(); auto lineWidth = shape->get_LineFormat()->get_Width(); Console::WriteLine(String::Format(u"{0} / {1}: fill={2}, line width={3}", layoutSlide->get_Name(), shape->get_Name(), fillType, lineWidth)); } } presentation->Dispose(); ``` Редактирование макета может затронуть несколько слайдов, которые его используют. Прежде чем менять фигуру макета, определите, наследует ли обычный слайд объект или содержит локальное переопределение, и проверьте каждый слайд, использующий этот макет. ## **Экспорт фигуры в SVG** [WriteAsSvg](https://reference.aspose.com/slides/ru/cpp/aspose.slides/ishape/writeassvg/) записывает отрендеренное содержимое одной фигуры в поток. Результат содержит только эту фигуру, а не фон всего слайда или соседние фигуры. ```cpp #include #include #include #include #include #include using namespace Aspose::Slides; using namespace System; using namespace System::IO; auto presentation = MakeObject(u"input.pptx"); auto slide = presentation->get_Slide(0); if (slide->get_Shapes()->get_Count() == 0) { Console::WriteLine(u"Slide 1 does not contain a shape to export."); } else { auto shape = slide->get_Shape(0); auto svgStream = File::Create(u"shape.svg"); shape->WriteAsSvg(svgStream); svgStream->Close(); } presentation->Dispose(); ``` Держите презентацию открытой во время рендеринга. Вывод зависит от форматирования фигуры и от ресурсов, таких как шрифты и изображения. Если нужен весь состав, экспортируйте слайд, а не отдельную фигуру. Поток принадлежит вызывающему коду и должен быть закрыт или освобождён. ## **Выравнивание фигур** Перегрузки [SlideUtil::AlignShapes](https://reference.aspose.com/slides/ru/cpp/aspose.slides.util/slideutil/alignshapes/) выравнивают либо все фигуры, либо выбранные индексы коллекции. [ShapesAlignmentType](https://reference.aspose.com/slides/ru/cpp/aspose.slides/shapesalignmenttype/) задаёт сторону, центральную линию или режим распределения. Установите `alignToSlide` в `true`, чтобы использовать края слайда; в `false` — чтобы выравнивать выбранные фигуры относительно друг друга. Этот пример выравнивает три фигуры по верхнему краю слайда. Ссылки на фигуры преобразуются в их текущие индексы непосредственно перед выравниванием. ```cpp #include #include #include #include #include #include #include #include using namespace Aspose::Slides; using namespace Aspose::Slides::Export; using namespace Aspose::Slides::Util; using namespace System; auto presentation = MakeObject(); auto slide = presentation->get_Slide(0); auto firstShape = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 60, 80, 120, 50); auto secondShape = slide->get_Shapes()->AddAutoShape(ShapeType::Ellipse, 240, 160, 120, 50); auto thirdShape = slide->get_Shapes()->AddAutoShape(ShapeType::Triangle, 420, 240, 120, 50); firstShape->set_Name(u"FirstAlignedShape"); secondShape->set_Name(u"SecondAlignedShape"); thirdShape->set_Name(u"ThirdAlignedShape"); auto shapeIndexes = MakeArray({slide->get_Shapes()->IndexOf(firstShape), slide->get_Shapes()->IndexOf(secondShape), slide->get_Shapes()->IndexOf(thirdShape)}); SlideUtil::AlignShapes(ShapesAlignmentType::AlignTop, true, slide, shapeIndexes); presentation->Save(u"aligned-shapes.pptx", SaveFormat::Pptx); presentation->Dispose(); ``` Выравнивание меняет положение, но не Z‑порядок. Относительное выравнивание обычно требует как минимум две фигуры, а горизонтальное или вертикальное распределение — достаточного количества фигур для определения интервалов. Пересчитайте индексы, если изменяете коллекцию перед вызовом метода. ## **Отзеркаливание фигуры** Класс [ShapeFrame](https://reference.aspose.com/slides/ru/cpp/aspose.slides/shapeframe/) хранит позицию, размер, настройки горизонтального и вертикального отражения и вращения. Его свойства `FlipH` и `FlipV` используют [NullableBool](https://reference.aspose.com/slides/ru/cpp/aspose.slides/nullablebool/): `True` включает отражение, `False` — отключает, а `NotDefined` — сохраняет неустановленное/по‑умолчанию состояние. Входная презентация ниже содержит одну неотражённую фигуру. ![The shape before flipping](shape_to_be_flipped.png) Пример сохраняет все остальные значения кадра и изменяет только два параметра отражения. Это важно, потому что назначение нового [Frame](https://reference.aspose.com/slides/ru/cpp/aspose.slides/ishape/set_frame/) заменяет весь кадр. ```cpp #include #include #include #include #include #include #include using namespace Aspose::Slides; using namespace Aspose::Slides::Export; using namespace System; auto presentation = MakeObject(u"sample.pptx"); auto shape = presentation->get_Slide(0)->get_Shape(0); auto frame = shape->get_Frame(); Console::WriteLine(String::Format(u"Horizontal flip before change: {0}", frame->get_FlipH())); Console::WriteLine(String::Format(u"Vertical flip before change: {0}", frame->get_FlipV())); shape->set_Frame(MakeObject(frame->get_X(), frame->get_Y(), frame->get_Width(), frame->get_Height(), NullableBool::True, NullableBool::True, frame->get_Rotation())); presentation->Save(u"flipped-shape.pptx", SaveFormat::Pptx); presentation->Dispose(); ``` Сохранённая фигура отражена горизонтально и вертикально, при этом сохраняются её позиция, размер и вращение. ![The shape after flipping](flipped_shape.png) ## **FAQ** **Следует ли использовать индекс коллекции как идентификатор фигуры?** Только для краткосрочной обработки, когда коллекция не будет изменяться до использования индекса. Предпочтительно использовать проверенный `Name` или `AlternativeText` в шаблонах, либо `OfficeInteropShapeId` для работы с interop‑сценариями. **Удаляет ли скрытие фигуры её из Z‑порядка?** Нет. Скрытая фигура остаётся в коллекции на том же индексе. Её можно находить, переупорядочивать, редактировать или вновь делать видимой. **Почему клонированная фигура оказалась перед другой фигурой?** `AddClone` добавляет клон в конец коллекции, что является передним положением в Z‑порядке. Используйте `InsertClone`, чтобы задать начальный индекс, или `Reorder` после добавления всех фигур. **Можно ли использовать фиксированный индекс для идентификации предустановленной регулировки фигуры?** Только после строгой проверки конкретной предустановки и расположения в коллекции. Предпочтительно итерировать `IGeometryShape::get_Adjustments` и проверять `IAdjustValue::get_Type`; при наличии нескольких одинаковых семантических типов используйте `IAdjustValue::get_Name` как дополнительную информацию.