Работа с формами
В этом разделе обсуждается, как программно работать с фигурами, используя Aspose.Words.
Фигуры в Aspose.Words представляют объект на уровне рисования, такой как AutoShape, текстовое поле, объект произвольной формы, OLE, элемент управления ActiveX или изображение. Документ Word может содержать одну или несколько различных фигур. Формы документа представлены классом Shape.
Вставка фигур с помощью конструктора документов
Вы можете вставить в документ встроенную фигуру с указанным типом и размером, а также свободно перемещающуюся фигуру с указанным положением, размером и типом переноса текста, используя метод insert_shape. Метод insert_shape позволяет вставить фигуру DML в модель документа. Документ должен быть сохранен в формате, поддерживающем формы DML, в противном случае такие узлы будут преобразованы в форму VML при сохранении документа.
В следующем примере кода показано, как вставить эти типы фигур в документ:
Установите фиксированное соотношение сторон
Используя Aspose.Words, вы можете указать, будет ли зафиксировано соотношение сторон фигуры с помощью свойства aspect_ratio_locked.
В следующем примере кода показано, как работать со свойством AspectRatioLocked:
Установите Расположение Фигуры В Ячейке
Вы также можете указать, будет ли фигура отображаться внутри таблицы или за ее пределами, используя свойство is_layout_in_cell.
В следующем примере кода показано, как работать со свойством IsLayoutInCell:
Создайте прямоугольник с отрезанным углом
Вы можете создать прямоугольник с отрезанным углом, используя Aspose.Words. Существуют следующие типы фигур SINGLE_CORNER_SNIPPED, TOP_CORNERS_SNIPPED, DIAGONAL_CORNERS_SNIPPED, TOP_CORNERS_ONE_ROUNDED_ONE_SNIPPED, SINGLE_CORNER_ROUNDED, TOP_CORNERS_ROUNDED, и DIAGONAL_CORNERS_ROUNDED.
Фигура DML создается с использованием метода insert_shape с этими типами фигур. Эти типы не могут быть использованы для создания фигур VML. Попытка создать фигуру с помощью открытого конструктора класса Shape приводит к возникновению исключения “NotSupportedException”.
В следующем примере кода показано, как вставить фигуры такого типа в документ:
Получите реальные точки границ формы
Используя Aspose.Words API, вы можете получить местоположение и размер фигуры, содержащей блок, в точках относительно привязки самой верхней фигуры. Для этого используйте свойство bounds_in_points.
В следующем примере кода показано, как работать со свойством BoundsInPoints:
Укажите вертикальную привязку
Вы можете задать выравнивание текста по вертикали внутри фигуры, используя свойство vertical_anchor.
В следующем примере кода показано, как работать со свойством VerticalAnchor:
Определить форму SmartArt
Aspose.Words также позволяет определить, есть ли у фигуры объект SmartArt. Для этого используйте свойство has_smart_art property.
В следующем примере кода показано, как работать со свойством HasSmartArt:
Вставить горизонтальную линейку в документ
Вы можете вставить горизонтальную линейчатую фигуру в документ, используя метод insert_horizontal_rule.
В следующем примере кода показано, как это сделать:
Aspose.Words API предоставляет свойство horizontal_rule_format для доступа к свойствам формы горизонтального правила. Класс HorizontalRuleFormat предоставляет базовые свойства, такие как height, color, no_shade и т.д. для форматирования горизонтального правила.
В следующем примере кода показано, как установить HorizontalRuleFormat:
Вставить объект OLE в качестве значка
Aspose.Words API предоставляет функцию Shape.insert_ole_object_as_icon для вставки встроенного или связанного объекта OLE в виде значка в документ. Эта функция позволяет указать файл значка и подпись к нему. Тип объекта OLE определяется по расширению файла.
В следующем примере кода показано, как установить объект insert OLE в качестве значка в документе:
Импортируйте фигуры с математикой XML в виде фигур в DOM
Вы можете использовать свойство convert_shape_to_office_math для преобразования фигур с уравнением EquationXML в объекты Office Math. Значение этого свойства по умолчанию соответствует MS поведению Word, т.е. фигуры с уравнением XML не преобразуются в объекты Office math.
В следующем примере кода показано, как преобразовать фигуры в объекты Office Math: