Здравствуйте читатели блога scriptcoding.ru. Сегодня мы рассмотрим работу с классом Shape, который представляет фигуры для ворда.
Объекты Shape показывают как в ворде сделать фигуру заданного типа, например, как авто-фигуры, элементы WordArt, линии, выноски и так далее. Фактически, Shape является переходным звеном между коллекцией Shapes, которая предоставляет методы для вставки в документ графических фигур ворд, которые позволяют форматировать конкретный тип.
В прошлой статье мы рассмотрели коллекцию Shapes и ее методы, теперь настало время разобраться с классами Shape. Данный класс содержит в своем составе много методов и свойств, которые позволяют или форматировать конкретную фигуру ворд (размер, положение и так далее), или получить ссылку на другой объект (коллекцию), который позволяет более тщательно обработать графическую ворд фигуру.
В этой статье мы рассмотрим только описание методов и свойств класса Shape, а самим программированием займемся в следующих статьях.
Shape – фигуры для word
Свойства – как в ворде сделать фигуру
AlternativeText - Вернет или задает альтернативный текст, связанный с фигурой в ворд.
AutoShapeType - Вернет или задает тип фигуры для указанного Shape, который должен представлять другие автофигуры. Значение константы MsoAutoShapeType.
BackgroundStyle - Устанавливает или возвращает стиль фона для заданной фигуры в ворд. Значения константы MsoBackgroundStyleIndex.
Child - True, если фигура является дочерней или, если все фигуры в диапазоне являются дочерними одного и того же родителя. Только чтение.
HasChart - True, если указанная фигура ворд является диаграммой. Только чтение.
HasSmartArt - True, если ворд фигура является схемой SmartArt. Только чтение.
Height и Width - Вернет или задает высоту или ширину.
HeightRelative и WidthRelativ - Возвращает или определяет процент относительной высоты или ширины.
HorizontalFlip и VerticalFlip – True – если форма переворачивалась вокруг горизонтальной или вертикальной оси. Только чтение.
RelativeHorizontalPosition – Задает или вернет относительное горизонтальное положение фигуры в ворд. Значение константы WdRelativeHorizontalPosition.
RelativeVerticalPosition - Определяет относительное вертикальное положение формы. Значение константы WdRelativeVerticalPosition.
ID - Идентификатор заданной ворд фигуры. Только чтение.
LayoutInCell - True - указывает, что заданная фигура для ворда отображается внутри таблицы. False - вне таблицы.
Left - Горизонтальное положение в пунктах, для заданной фигуры или диапазона фигур. Чтение и запись. Может также быть любым допустимым значением константы WdShapePosition.
Top - Вертикальное положение заданной фигуры для Word или диапазона фигур в пунктах. Чтение и запись.
TopRelative и LeftRelative – Относительная верхняя или левая позиция. Запись и чтение.
Name - Имя фигуры для word. Запись и чтение.
RelativeHorizontalSize - Возвращает или задает значение константы WdRelativeHorizontalSize, представляющей объект, к которому относится диапазон фигур.
RelativeVerticalSize - Возвращает или задает значение константы WdRelativeVerticalSize, представляющей относительный вертикальный размер.
Rotation - Возвращает или устанавливает число градусов для поворота.
ShapeStyle - Возвращает или задает стиль. Значение константы MsoShapeStyleIndex.
Title - Возвращает или задает строку, содержащую название заголовка.
Type - Возвращает тип фигуры для Word. Только чтение, значение константы MsoShapeType.
Vertices - Возвращает координаты вершин и контрольные точки для кривых Безье в виде ряда координатных пар. Только чтение.
Visible – Включить (true) или отключить (false) видимость.
ZOrderPosition - Позиция заданной фигуры в ворд. Только чтение.
LockAspectRatio – True - если указанная фигура сохраняет свои исходные пропорции при изменении размеров. False - если вы можете изменить высоту и ширину независимо друг от друга. Чтение и запись.
Свойства-объекты и свойства-коллекции – как сгруппировать фигуры в ворде
Данные свойства возвращают коллекции или другие классы.
Adjustments - Adjustments, который содержит значения, настроенные для всех корректировок заданной ворд фигуры, которая представляет собой авто-фигуру или WordArt.
Anchor - Range, представляющий диапазон для заданного элемента или диапазона элементов.
Application - Application, представляющий приложение Microsoft Word.
Callout - CalloutFormat, содержащий свойства форматирования выноски для заданной фигуры ворд.
CanvasItems - CanvasShapes, представляющий коллекцию фигур ворд в указанном полотне.
Chart - Chart, определяющий диаграмму.
Fill - FillFormat, содержащий свойства заполнения.
Glow - GlowFormat, определяющий форматирование свечения.
GroupItems - GroupShapes, который представляет отдельные фигуры в указанной группе.
Hyperlink - Hyperlink, определяющий гиперссылку, связанную с объектом Shape.
Line - LineFormat, который содержит параметры форматирования для линии.
LinkFormat - LinkFormat, представляющий параметры связи.
Nodes - ShapeNodes, определяющую геометрическое описание заданной фигуры для Word.
OLEFormat - OLEFormat, представляющий характеристики OLE.
ParentGroup - Shape, который определяет общую родительскую фигуру ворд дочернего элемента или диапазон дочерних элементов.
PictureFormat - PictureFormat, содержащий свойства форматирования изображения.
Reflection - ReflectionFormat, определяющий форматирование отражения.
Script - Script, который представляет собой блок скрипта или кода для изображения на веб-странице.
Shadow - ShadowFormat, представляющий форматирование тени.
SmartArt - SmartArt, который позволяет работать со схемами SmartArt.
SoftEdge - SoftEdgeFormat, представляющий форматирование края.
TextEffect - TextEffectFormat, который содержит форматирование эффектов для текста WordArt.
TextFrame - TextFrame, содержащий текст в фигуре Word.
ThreeD - ThreeDFormat, содержащий форматирование 3D свойств.
WrapFormat - WrapFormat, содержащий параметры обтекания текста вокруг заданной фигуры ворд.
Методы – как вставить фигуру в ворде
Apply() - Применяет форматирование, которое было скопировано с помощью метода PickUp.
ConvertToInlineShape() - Преобразует указанную фигуру для ворда, которая не зависит от текста, в элемент, который зависит от текста. Вы можете конвертировать только элементы, которые представляют фотографии, объекты OLE, или элементы управления ActiveX. Этот метод возвращает класс InlineShape, представляющий рисунок или объект OLE.
Delete(index) - Удаляет указанный узел (index) фигуры.
Duplicate() - Создает дубликат указанного объекта Shape, добавляет новую фигуру ворд в коллекцию Shapes на уровне смещения от оригинальной фигуры, а затем возвращает новый объект Shape.
Flip(FlipCmd) - Переворачивает фигуру для Word горизонтально или вертикально.
FlipCmd – Ориентация, значение константы MsoFlipCmd:
- msoFlipHorizontal - 0 - Отразить горизонтально.
- msoFlipVertical - 1 - Отразить вертикально.
IncrementLeft(Increment) и IncrementTop(Increment) - Перемещение элемента горизонтально или вертикально на указанное число пунктов. Направление регулируется знаком передаваемого числа, например, 5 или -5.
IncrementRotation(Increment) - Вращение заданного элемента вокруг оси на указанное количество градусов. Параметр принимает число градусов, направление зависит от знака.
PickUp() - Копирует форматирование заданной фигуры в ворд.
ScaleHeight(Factor, RelativeToOriginalSize, Scale) - Масштабирование высоты с помощью заданного коэффициента.
Factor - Указывает соотношение между высотой фигуры после изменения ее размера и текущей или исходной высотой. Например, чтобы сделать прямоугольник на 50 процентов больше, надо указать значение в 1,5.
RelativeToOriginalSize - True - масштабировать относительно первоначального размера. False - масштабировать по отношению к текущему размеру. Вы можете задать True для этого аргумента, только если указанный фигура является изображением или объектом OLE.
Scale - Часть фигуры, которая сохраняет свои позиции, когда фигура изменяет свои размеры. Значение константы MsoScaleFrom:
- msoScaleFromTopLeft - 0 – Фигуры в левом верхнем углу сохраняют свои позиции.
- msoScaleFromMiddle - 1 – Фигуры в середине сохраняют свои позиции.
- msoScaleFromBottomRight - 2 - Фигуры в правом нижнем углу сохраняют свои позиции.
ScaleWidth(Factor, RelativeToOriginalSize, Scale) - Масштабирование ширины фигуры в ворд с помощью заданного коэффициента.
Select(Replace) – Выбор фигуры.
Replace - При добавлении фигуры, True - заменяет выбор, False - добавляет новую фигуру к выбору.
SetShapesDefaultProperties() - Применяет форматирование по умолчанию.
Ungroup() - Разгруппировать любые сгруппированные фигуры для Word в заданном объекте Shape.
ZOrder(ZOrderCmd) – Метод определяет порядок размещения.
ZorderCmd – Значения константы MsoZOrderCmd:
- msoBringToFront - 0 - На передний план.
- msoSendToBack - 1 - На задний план.
- msoBringForward - 2 - Переместить вперед вперед.
- msoSendBackward - 3 - Переместить назад.
- msoBringInFrontOfText - 4 - Переместить перед текстом.
- msoSendBehindText - 5 - Переместить за текстом.
CanvasCropBottom(Increment) и CanvasCropTop(Increment) - Обрезает процент от высоты полотна из нижней или верхней части холста.
CanvasCropLeft(Increment) и CanvasCropRight(Increment) - Обрезает процент от ширины полотна с левой или с правой стороны холста.
Спасибо за внимание. Автор блога Владимир Баталий