Работа с формами

В этом разделе обсуждается, как программно работать с фигурами, используя Aspose.Words.

Фигуры в Aspose.Words представляют объект на уровне рисования, такой как AutoShape, текстовое поле, произвольная форма, OLE-объект, элемент управления ActiveX или изображение. Документ Word может содержать одну или несколько различных фигур. Формы документа представлены классом Shape.

Вставка фигуры с помощью конструктора документов

Вы можете вставить в документ встроенную фигуру с указанным типом и размером, а также свободно перемещающуюся фигуру с указанным положением, размером и типом переноса текста, используя метод InsertShape. Метод InsertShape позволяет вставить фигуру DML в модель документа. Документ должен быть сохранен в формате, поддерживающем формы DML, в противном случае такие узлы будут преобразованы в форму VML при сохранении документа.

В следующем примере кода показано, как вставить эти типы фигур в документ:

Установите фиксированное соотношение сторон

Используя Aspose.Words, вы можете указать, будет ли зафиксировано соотношение сторон фигуры с помощью свойства AspectRatioLocked.

В следующем примере кода показано, как работать со свойством AspectRatioLocked:

Установите Расположение Фигуры В Ячейке

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

В следующем примере кода показано, как работать со свойством IsLayoutInCell:

Создайте прямоугольник с отрезанным углом

Вы можете создать прямоугольник с отрезанным углом, используя Aspose.Words. Типы фигур - SingleCornerSnipped, TopCornersSnipped, DiagonalCornersSnipped, TopCornersOneRoundedOneSnipped, SingleCornerRounded, TopCornersRounded, и DiagonalCornersRounded.

Форма DML создается с помощью метода InsertShape с использованием этих типов фигур. Эти типы нельзя использовать для создания фигур VML. Попытка создать форму с помощью открытого конструктора класса “Shape” приводит к возникновению исключения “NotSupportedException”.

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

Получите реальные точки границ формы

Используя Aspose.Words API, вы можете получить местоположение и размер фигуры, содержащей блок, в точках относительно привязки самой верхней фигуры. Для этого используйте свойство BoundsInPoints.

В следующем примере кода показано, как работать со свойством BoundsInPoints:

Формат горизонтального правила

Aspose.Words API предоставляет свойство HorizontalRuleFormat для доступа к свойствам формы горизонтального правила. Класс HorizontalRuleFormat предоставляет базовые свойства, такие как высота, цвет, оттенок и т.д. для форматирования горизонтального правила.

В следующем примере кода показано, как установить HorizontalRuleFormat:

Вставить OLE-объект в виде значка

Aspose.Words API предоставляет функцию ShapeInsertOleObjectAsIcon для вставки встроенного или связанного OLE-объекта в виде значка в документ. Эта функция позволяет указать файл значка и заголовок. Тип объекта OLE определяется с помощью расширения файла.

В следующем примере кода показано, как настроить вставку OLE-объекта в качестве значка в документ: