Манипуляции с формами

Найти форму на слайде

Эта статья описывает простую технику, упрощающую разработчикам поиск конкретной формы на слайде без использования её внутреннего Id. Важно знать, что файлы презентаций PowerPoint не предоставляют способа идентифицировать формы на слайде, кроме внутреннего уникального Id. Для разработчиков часто сложно найти форму по её внутреннему уникальному Id. У всех форм, добавленных на слайды, есть некоторый альтернативный текст. Мы рекомендуем использовать альтернативный текст для поиска конкретной формы. Вы можете задать альтернативный текст объектам в MS PowerPoint, которые планируете менять в будущем.

После задания альтернативного текста нужной формы вы можете открыть эту презентацию с помощью Aspose.Slides for .NET и перебрать все формы, добавленные на слайд. При каждой итерации можно проверить альтернативный текст формы, и форма с совпадающим альтернативным текстом будет той, которую вы ищете. Чтобы продемонстрировать эту технику, мы создали метод FindShape, который позволяет находить конкретную форму на слайде и возвращать её.

public static void Run()
{
    // Создать экземпляр класса Presentation, представляющего файл презентации
    using (Presentation p = new Presentation("FindingShapeInSlide.pptx"))
    {

        ISlide slide = p.Slides[0];
        // Альтернативный текст формы, которую нужно найти
        IShape shape = FindShape(slide, "Shape1");
        if (shape != null)
        {
            Console.WriteLine("Shape Name: " + shape.Name);
        }
    }
}
        
// Реализация метода для поиска формы на слайде по её альтернативному тексту
public static IShape FindShape(ISlide slide, string alttext)
{
    // Перебор всех форм на слайде
    for (int i = 0; i < slide.Shapes.Count; i++)
    {
        // Если альтернативный текст формы совпадает с требуемым, тогда
        // Вернуть форму
        if (slide.Shapes[i].AlternativeText.CompareTo(alttext) == 0)
            return slide.Shapes[i];
    }
    return null;
}

Клонировать форму

Чтобы клонировать форму на слайде с помощью Aspose.Slides for .NET:

  1. Создайте экземпляр класса Presentation.
  2. Получите ссылку на слайд, используя его индекс.
  3. Получите коллекцию форм исходного слайда.
  4. Добавьте новый слайд в презентацию.
  5. Клонируйте формы из коллекции форм исходного слайда в новый слайд.
  6. Сохраните изменённую презентацию в файл PPTX.

Ниже приведён пример, добавляющий групповую форму на слайд.

 // Instantiate Presentation class
using (Presentation srcPres = new Presentation("Source Frame.pptx"))
{
    IShapeCollection sourceShapes = srcPres.Slides[0].Shapes;
    ILayoutSlide blankLayout = srcPres.Masters[0].LayoutSlides.GetByType(SlideLayoutType.Blank);
    ISlide destSlide = srcPres.Slides.AddEmptySlide(blankLayout);
    IShapeCollection destShapes = destSlide.Shapes;
    destShapes.AddClone(sourceShapes[1], 50, 150 + sourceShapes[0].Height);
    destShapes.AddClone(sourceShapes[2]);                 
    destShapes.InsertClone(0, sourceShapes[0], 50, 150);

    // Write the PPTX file to disk
    srcPres.Save("CloneShape_out.pptx", SaveFormat.Pptx);
}

Удалить форму

Aspose.Slides for .NET позволяет разработчикам удалять любые формы. Чтобы удалить форму с любого слайда, выполните следующие шаги:

  1. Создайте экземпляр класса Presentation.
  2. Получите доступ к первому слайду.
  3. Найдите форму с определённым AlternativeText.
  4. Удалите форму.
  5. Сохраните файл на диск.
// Создать объект Presentation
Presentation pres = new Presentation();

// Получить первый слайд
ISlide sld = pres.Slides[0];

// Добавить автофигуру типа прямоугольник
IShape shp1 = sld.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 40, 150, 50);
IShape shp2 = sld.Shapes.AddAutoShape(ShapeType.Moon, 160, 40, 150, 50);
String alttext = "User Defined";
int iCount = sld.Shapes.Count;
for (int i = 0; i < iCount; i++)
{
    AutoShape ashp = (AutoShape)sld.Shapes[0];
    if (String.Compare(ashp.AlternativeText, alttext, StringComparison.Ordinal) == 0)
    {
        sld.Shapes.Remove(ashp);
    }
}

// Сохранить презентацию на диск
pres.Save("RemoveShape_out.pptx", SaveFormat.Pptx);

Скрыть форму

Aspose.Slides for .NET позволяет разработчикам скрывать любые формы. Чтобы скрыть форму на любом слайде, выполните следующие шаги:

  1. Создайте экземпляр класса Presentation.
  2. Получите доступ к первому слайду.
  3. Найдите форму с определённым AlternativeText.
  4. Сскройте форму.
  5. Сохраните файл на диск.
// Создать объект Presentation, представляющего PPTX
Presentation pres = new Presentation();

// Получить первый слайд
ISlide sld = pres.Slides[0];

// Добавить автофигуру типа прямоугольник
IShape shp1 = sld.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 40, 150, 50);
IShape shp2 = sld.Shapes.AddAutoShape(ShapeType.Moon, 160, 40, 150, 50);
String alttext = "User Defined";
int iCount = sld.Shapes.Count;
for (int i = 0; i < iCount; i++)
{
	AutoShape ashp = (AutoShape)sld.Shapes[i];
	if (String.Compare(ashp.AlternativeText, alttext, StringComparison.Ordinal) == 0)
	{
		ashp.Hidden = true;
	}
}

// Сохранить презентацию на диск
pres.Save("Hiding_Shapes_out.pptx", SaveFormat.Pptx);

Изменить порядок форм

Aspose.Slides for .NET позволяет разработчикам менять порядок расположения форм. Переупорядочивание формы определяет, какая форма находится спереди, а какая — сзади. Чтобы переупорядочить формы на любом слайде, выполните следующие шаги:

  1. Создайте экземпляр класса Presentation.
  2. Получите доступ к первому слайду.
  3. Добавьте форму.
  4. Добавьте текст в текстовый фрейм формы.
  5. Добавьте другую форму с теми же координатами.
  6. Переупорядочьте формы.
  7. Сохраните файл на диск.
Presentation presentation1 = new Presentation("HelloWorld.pptx");
ISlide slide = presentation1.Slides[0];
IAutoShape shp3 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 200, 365, 400, 150);
shp3.FillFormat.FillType = FillType.NoFill;
shp3.AddTextFrame(" ");

ITextFrame txtFrame = shp3.TextFrame;
IParagraph para = txtFrame.Paragraphs[0];
IPortion portion = para.Portions[0];
portion.Text="Watermark Text Watermark Text Watermark Text";
shp3 = slide.Shapes.AddAutoShape(ShapeType.Triangle, 200, 365, 400, 150);
slide.Shapes.Reorder(2, shp3);
presentation1.Save( "Reshape_out.pptx", SaveFormat.Pptx);

Получить Interop Shape ID

Aspose.Slides for .NET позволяет разработчикам получить уникальный идентификатор формы в пределах слайда, в отличие от свойства UniqueId, которое возвращает уникальный идентификатор в пределах всей презентации. Свойство OfficeInteropShapeId было добавлено в интерфейсы IShape и класс Shape. Возвращаемое значение свойства OfficeInteropShapeId соответствует значению Id объекта Microsoft.Office.Interop.PowerPoint.Shape. Ниже приведён пример кода.

public static void Run()
{
	using (Presentation presentation = new Presentation("Presentation.pptx"))
	{
		// Получение уникального идентификатора формы в области слайда
		long officeInteropShapeId = presentation.Slides[0].Shapes[0].OfficeInteropShapeId;
	}
}

Установить альтернативный текст для формы

Aspose.Slides for .NET позволяет разработчикам задавать AlternateText любой формы. Формы в презентации могут отличаться по свойству AlternativeText или имени формы (Shape Name). Свойство AlternativeText можно читать и задавать как в Aspose.Slides, так и в Microsoft PowerPoint. С помощью этого свойства вы можете пометить форму и выполнять различные операции, такие как удаление формы, скрытие формы или переупорядочивание форм на слайде. Чтобы задать AlternateText формы, выполните следующие шаги:

  1. Создайте экземпляр класса Presentation.
  2. Получите доступ к первому слайду.
  3. Добавьте любую форму на слайд.
  4. Выполните необходимые действия с только что добавленной формой.
  5. Переберите формы, чтобы найти нужную форму.
  6. Задайте AlternativeText.
  7. Сохраните файл на диск.
// Создать объект Presentation, представляющий PPTX
Presentation pres = new Presentation();

// Получить первый слайд
ISlide sld = pres.Slides[0];

// Добавить автофигуру типа прямоугольник
IShape shp1 = sld.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 40, 150, 50);
IShape shp2 = sld.Shapes.AddAutoShape(ShapeType.Moon, 160, 40, 150, 50);
shp2.FillFormat.FillType = FillType.Solid;
shp2.FillFormat.SolidFillColor.Color = Color.Gray;

for (int i = 0; i < sld.Shapes.Count; i++)
{
    var shape = sld.Shapes[i] as AutoShape;
    if (shape != null)
    {
        AutoShape ashp = shape;
        ashp.AlternativeText = "User Defined";
    }
}

// Сохранить презентацию на диск
pres.Save("Set_AlternativeText_out.pptx", SaveFormat.Pptx);

Доступ к форматам компоновки для формы

Aspose.Slides for .NET предоставляет простой API для доступа к форматам компоновки формы. В этой статье показано, как получить доступ к форматам компоновки.

Ниже приведён пример кода.

using (Presentation pres = new Presentation("pres.pptx"))
{
	foreach (ILayoutSlide layoutSlide in pres.LayoutSlides)
	{
		IFillFormat[] fillFormats = layoutSlide.Shapes.Select(shape => shape.FillFormat).ToArray();
		ILineFormat[] lineFormats = layoutSlide.Shapes.Select(shape => shape.LineFormat).ToArray();
	}
}

Отрисовка формы как SVG

Теперь Aspose.Slides for .NET поддерживает отрисовку формы в формате SVG. Метод WriteAsSvg (и его перегрузка) был добавлен в класс Shape и интерфейс IShape. Этот метод позволяет сохранять содержимое формы в файл SVG. Пример кода ниже показывает, как экспортировать форму со слайда в файл SVG.

public static void Run()
{
	string outSvgFileName = "SingleShape.svg";
	using (Presentation pres = new Presentation("TestExportShapeToSvg.pptx"))
	{
		using (Stream stream = new FileStream(outSvgFileName, FileMode.Create, FileAccess.Write))
		{
			pres.Slides[0].Shapes[0].WriteAsSvg(stream);
		}
	}
}

Выровнять форму

С помощью перегруженного метода SlidesUtil.AlignShape() можно

  • выравнивать формы относительно полей слайда. Смотрите пример 1.
  • выравнивать формы относительно друг друга. Смотрите пример 2.

Перечисление ShapesAlignmentType определяет доступные варианты выравнивания.

Пример 1

Этот код C# показывает, как выровнять формы с индексами 1,2 и 4 вдоль верхней границы слайда: Исходный код ниже выравнивает формы с индексами 1,2 и 4 вдоль верхней границы слайда.

using (Presentation pres = new Presentation("example.pptx"))
{
     ISlide slide = pres.Slides[0];
     IShape shape1 = slide.Shapes[1];
     IShape shape2 = slide.Shapes[2];
     IShape shape3 = slide.Shapes[4];
     SlideUtil.AlignShapes(ShapesAlignmentType.AlignTop, true, pres.Slides[0], new int[]
     {
          slide.Shapes.IndexOf(shape1),
          slide.Shapes.IndexOf(shape2),
          slide.Shapes.IndexOf(shape3)
     });
}

Пример 2

Этот код C# показывает, как выровнять всю коллекцию форм относительно нижней формы в коллекции:

using (Presentation pres = new Presentation("example.pptx"))
{
    SlideUtil.AlignShapes(ShapesAlignmentType.AlignBottom, false, pres.Slides[0].Shapes);
}

Свойства отражения

В Aspose.Slides класс ShapeFrame предоставляет управление горизонтальным и вертикальным отражением форм через свойства FlipH и FlipV. Оба свойства имеют тип NullableBool, позволяя использовать значение True для отражения, False — без изменения, либо NotDefined для использования поведения по умолчанию. Эти значения доступны через свойство Frame формы.

Чтобы изменить настройки отражения, создаётся новый экземпляр ShapeFrame с текущими позицией и размером формы, желаемыми значениями FlipH и FlipV и углом вращения. Присвоив этот экземпляр свойству Frame формы и сохранив презентацию, вы примените зеркальные трансформации и запишете их в выходной файл.

Предположим, у нас есть файл sample.pptx, в котором первый слайд содержит одну форму с настройками отражения по умолчанию, как показано ниже.

The shape to be flipped

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

using (Presentation presentation = new Presentation("sample.pptx"))
{
    IShape shape = presentation.Slides[0].Shapes[0];

    // Получить свойство горизонтального отражения формы.
    NullableBool horizontalFlip = shape.Frame.FlipH;
    Console.WriteLine($"Horizontal flip: {horizontalFlip}");

    // Получить свойство вертикального отражения формы.
    NullableBool verticalFlip = shape.Frame.FlipV;
    Console.WriteLine($"Vertical flip: {verticalFlip}");

    float x = shape.Frame.X;
    float y = shape.Frame.Y;
    float width = shape.Frame.Width;
    float height = shape.Frame.Height;
    NullableBool flipH = NullableBool.True; // Отразить горизонтально.
    NullableBool flipV = NullableBool.True; // Отразить вертикально.
    float rotation = shape.Frame.Rotation;

    shape.Frame = new ShapeFrame(x, y, width, height, flipH, flipV, rotation);

    presentation.Save("output.pptx", SaveFormat.Pptx);
}

Результат:

The flipped shape

FAQ

Можно ли объединять формы (union/intersect/subtract) на слайде, как в настольном редакторе?

Встроенного API для булевых операций нет. Можно приблизительно реализовать это, построив желаемый контур вручную — например, вычислив результирующую геометрию (через GeometryPath) и создав новую форму с этим контуром, при необходимости удалив исходные.

Как контролировать порядок наложения (z-order), чтобы форма всегда оставалась «поверх»?

Изменяйте порядок вставки/перемещения внутри коллекции shapes слайда. Для предсказуемого результата окончательный z‑order следует устанавливать после всех остальных изменений слайда.

Можно ли «заблокировать» форму, чтобы пользователи не могли её редактировать в PowerPoint?

Да. Установите флаги защиты на уровне формы (например, блокировку выбора, перемещения, изменения размера, редактирования текста). При необходимости примените ограничения к мастеру или разметке. Обратите внимание, что это защита на уровне UI, а не безопасность; для более надёжной защиты комбинируйте её с ограничениями уровня файла, такими как рекомендации «только для чтения» или пароли [/slides/net/password-protected-presentation/].

Применение эффектов фигур в PowerPoint с помощью C# Эффективные свойства фигур