Привіт читачі блогу scriptcoding.ru. Сьогодні ми розглянемо роботу з класом Shape, який представляє фігури для Ворда.
Об'єкти Shape показують як в ворде зробити фігуру заданого типу, наприклад, як авто-фігури, елементи WordArt, лінії, винесення і так далі. Фактично, Shape є перехідною ланкою між колекцією Shapes. яка надає методи для вставки в документ графічних фігур ворд, які дозволяють форматувати конкретний тип.
У минулій статті ми розглянули колекцію Shapes і її методи, тепер настав час розібратися з класами 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) - Обрізає відсоток від ширини полотна з лівого або з правого боку полотна.