Здравствуйте читатели блога 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) — Обрезает процент от ширины полотна с левой или с правой стороны холста.