Shape

Огляд

Shape — це клас у Aspose.Words FOSS для .NET. Наслідує від: ShapeBase, ITextBox, IStrokable.

Представляє об’єкт у шарі малювання, наприклад AutoShape, текстове поле, вільну форму, OLE-об’єкт, елемент керування ActiveX або зображення.

Цей клас надає 29 методів для роботи з об’єктами Shape у програмах .NET. Доступні методи включають: Accept, AcceptEnd, AcceptStart, AdjustWithEffects, AppendChild, Clone, CreateNavigator, GetAncestor, GetAncestorOf, GetChild, GetChildNodes, GetEnumerator та ще 17 методів. Усі публічні члени доступні будь-якій .NET-програмі після встановлення пакету Aspose.Words FOSS для .NET. Властивості: Adjustments, AllowOverlap, AlternativeText, AnchorLocked, AspectRatioLocked, BehindText та ще 93.

Властивості

Назва	Тип	Доступ	Опис
`NodeType`	`NodeType`	Читання	Повертає Shape.
`StoryType`	`StoryType`	Читання	Повертає Textbox.
`ExtrusionEnabled`	`bool`	Читання	Повертає true, якщо ефект екструзії ввімкнено.
`ShadowEnabled`	`bool`	Читання	Повертає true, якщо ефект тіні ввімкнено.
`Stroke`	`Stroke`	Читання	Визначає обвідку для форми.
`Stroked`	`bool`	Читання/Запис	Визначає, чи буде шлях обведений.
`StrokeWeight`	`double`	Читання/Запис	Визначає товщину пензля, якою обводиться шлях форми, у пунктах.
`StrokeColor`	`Color`	Читання/Запис	Визначає колір обведення.
`Filled`	`bool`	Читання/Запис	Визначає, чи буде заповнено замкнений контур форми.
`FillColor`	`Color`	Читання/Запис	Визначає колір пензля, яким заповнюється замкнений контур форми.
`HasImage`	`bool`	Читання	Повертає true, якщо форма містить байти зображення або посилається на зображення.
`ImageData`	`ImageData`	Читання	Надає доступ до зображення форми.
`OleFormat`	`OleFormat`	Читання	Надає доступ до даних OLE форми.
`TextBox`	`TextBox`	Читання	Визначає атрибути, які вказують, як текст відображається у формі.
`TextPath`	`TextPath`	Читання	Визначає текст текстового шляху (об’єкта WordArt).
`FirstParagraph`	`Paragraph`	Читання	Отримує перший абзац у shape.
`LastParagraph`	`Paragraph`	Читання	Отримує останній абзац у формі.
`HorizontalRuleFormat`	`HorizontalRuleFormat`	Читання	Надає доступ до властивостей форми горизонтальної лінії.
`Adjustments`	`AdjustmentCollection`	Читання	Надає доступ до сирих значень налаштувань форми.
`SignatureLine`	`SignatureLine`	Читання	Отримує об’єкт SignatureLine, якщо фігура є рядком підпису.
`HasChart`	`bool`	Читання	Повертає true, якщо цей Shape має Chart.
`HasSmartArt`	`bool`	Читання	Повертає true, якщо цей Shape має об’єкт SmartArt.
`Chart`	`Chart`	Читання	Надає доступ до властивостей chart, якщо ця shape має Chart.
`Fill`	`Fill`	Читання	Отримує форматування заповнення для форми.
`ShadowFormat`	`ShadowFormat`	Читання	Отримує форматування тіні для форми.
`Glow`	`GlowFormat`	Читання	Отримує форматування сяйва для форми.
`Reflection`	`ReflectionFormat`	Читання	Отримує формат відображення для форми.
`SoftEdge`	`SoftEdgeFormat`	Читання	Отримує форматування м’яких країв для форми.
`ScreenTip`	`string`	Читання/Запис	Визначає текст, що відображається, коли вказівник миші проходить над формою.
`HRef`	`string`	Читання/Запис	Отримує або задає повну адресу гіперпосилання для форми.
`Target`	`string`	Читання/Запис	Отримує або встановлює цільовий кадр для гіперпосилання форми.
`AlternativeText`	`string`	Читання/Запис	Визначає альтернативний текст, який відображається замість графічного елементу.
`IsDecorative`	`bool`	Читання/Запис	Отримує або встановлює прапорець, який вказує, чи є форма декоративною в документі.
`Title`	`string`	Читання/Запис	Отримує або задає заголовок (підпис) поточного об’єкта форми.
`Name`	`string`	Читання/Запис	Отримує або задає необов’язкову назву форми.
`IsInsertRevision`	`bool`	Читання	Отримує is insert revision.
`IsDeleteRevision`	`bool`	Читання	Отримує is delete revision.
`IsMoveFromRevision`	`bool`	Читання	Отримує is move з revision.
`IsMoveToRevision`	`bool`	Читання	Отримує is move to revision.
`IsTopLevel`	`bool`	Читання	Повертає true, якщо ця форма не є дочірньою у груповій формі.
`IsGroup`	`bool`	Читання	Повертає true, якщо це групова форма.
`IsImage`	`bool`	Читання	Повертає true, якщо ця фігура є image shape.
`IsHorizontalRule`	`bool`	Читання	Повертає true, якщо ця фігура є horizontal rule.
`IsWordArt`	`bool`	Читання	Повертає true, якщо ця форма є WordArt об’єктом.
`CanHaveImage`	`bool`	Читання	Повертає true, якщо тип форми дозволяє формі мати зображення.
`AnchorLocked`	`bool`	Читання/Запис	Вказує, чи зафіксовано якір форми.
`AspectRatioLocked`	`bool`	Читання/Запис	Вказує, чи заблоковано співвідношення сторін форми.
`AllowOverlap`	`bool`	Читання/Запис	Отримує або задає значення, яке вказує, чи може ця форма перекривати інші форми.
`BehindText`	`bool`	Читання/Запис	Вказує, чи розташована форма під текстом чи над ним.
`IsInline`	`bool`	Читання	Швидкий спосіб визначити, чи ця форма розташована в рядку з текстом.
`Left`	`double`	Читання/Запис	Отримує або встановлює позицію лівого краю блоку-контейнера форми.
`Top`	`double`	Читання/Запис	Отримує або встановлює позицію верхнього краю блоку-контейнера форми.
`Right`	`double`	Читання	Отримує позицію правого краю блоку-контейнера фігури.
`Bottom`	`double`	Читання	Отримує позицію нижнього краю блоку-контейнера фігури.
`Width`	`double`	Читання/Запис	Отримує або задає ширину блоку, що містить форму.
`Height`	`double`	Читання/Запис	Отримує або встановлює висоту блоку-контейнера форми.
`DistanceTop`	`double`	Читання/Запис	Повертає або встановлює відстань (у пунктах) між текстом документа та верхнім краєм форми.
`DistanceBottom`	`double`	Читання/Запис	Повертає або встановлює відстань (у пунктах) між текстом документа та нижнім краєм форми.
`DistanceLeft`	`double`	Читання/Запис	Повертає або встановлює відстань (у пунктах) між текстом документа та лівим краєм форми.
`DistanceRight`	`double`	Читання/Запис	Повертає або встановлює відстань (у пунктах) між текстом документа та правим краєм форми.
`Rotation`	`double`	Читання/Запис	Визначає кут (у градусах), на який повернуто форму.
`ZOrder`	`int`	Читання/Запис	Визначає порядок відображення перекриваючихся форм.
`ParentParagraph`	`Paragraph`	Читання	Повертає безпосередній батьківський абзац.
`Bounds`	`RectangleF`	Читання/Запис	Отримує або встановлює розташування та розмір контейнерного блоку форми.
`BoundsInPoints`	`RectangleF`	Читання	Отримує розташування та розмір контейнерного блоку форми у пунктах, відносно прив’язки найвищої форми.
`BoundsWithEffects`	`RectangleF`	Читання	Отримує остаточний розмір, який має цей об’єкт форми після застосування графічних ефектів.
`ShapeType`	`ShapeType`	Читання	Отримує тип форми.
`MarkupLanguage`	`ShapeMarkupLanguage`	Читання	Отримує MarkupLanguage, що використовується для цього графічного об’єкта.
`SizeInPoints`	`SizeF`	Читання	Отримує розмір форми у пунктах.
`FlipOrientation`	`FlipOrientation`	Читання/Запис	Змінює орієнтацію форми.
`RelativeHorizontalPosition`	`RelativeHorizontalPosition`	Читання/Запис	Вказує, відносно чого форма розташована горизонтально.
`RelativeVerticalPosition`	`RelativeVerticalPosition`	Читання/Запис	Вказує, відносно чого форма розташована вертикально.
`RelativeHorizontalSize`	`RelativeHorizontalSize`	Читання/Запис	Отримує або задає значення відносного розміру форми у горизонтальному напрямку.
`RelativeVerticalSize`	`RelativeVerticalSize`	Читання/Запис	Отримує або встановлює значення відносного розміру фігури у вертикальному напрямку.
`LeftRelative`	`float`	Читання/Запис	Отримує або встановлює значення, яке представляє відносну позицію фігури зліва у відсотках.
`TopRelative`	`float`	Читання/Запис	Отримує або задає значення, яке представляє відносну верхню позицію фігури у відсотках.
`HeightRelative`	`float`	Читання/Запис	Отримує або задає значення, яке представляє відсоток відносної висоти фігури.
`WidthRelative`	`float`	Читання/Запис	Отримує або задає значення, яке представляє відсоток відносної ширини фігури.
`HorizontalAlignment`	`HorizontalAlignment`	Читання/Запис	Визначає, як форма розташована горизонтально.
`VerticalAlignment`	`VerticalAlignment`	Читання/Запис	Визначає, як форма розташована вертикально.
`WrapType`	`WrapType`	Читання/Запис	Визначає, чи є форма вбудованою чи плаваючою.
`WrapSide`	`WrapSide`	Читання/Запис	Визначає, як текст обгортається навколо форми.
`CoordOrigin`	`Point`	Читання/Запис	Координати верхнього лівого кута блоку, що містить цю форму.
`CoordSize`	`Size`	Читання/Запис	Ширина та висота простору координат всередині блоку, що містить цю форму.
`Font`	`Font`	Читання	Надає доступ до форматування шрифту цього об’єкта.
`IsSignatureLine`	`bool`	Читання	Вказує, що форма є SignatureLine.
`IsLayoutInCell`	`bool`	Читання/Запис	Отримує або встановлює прапорець, що вказує, чи відображається форма всередині таблиці чи поза нею.
`Hidden`	`bool`	Читання/Запис	Отримує або встановлює булеве значення, яке вказує, чи форма видима.
`IsComposite`	`bool`	Читання	Повертає true, оскільки цей вузол може мати дочірні вузли.
`HasChildNodes`	`bool`	Читання	Повертає true, якщо у цього вузла є будь-які дочірні вузли.
`FirstChild`	`Node`	Читання	Отримує перший дочірній елемент вузла.
`LastChild`	`Node`	Читання	Отримує останній дочірній елемент вузла.
`Count`	`int`	Читання	Отримує кількість безпосередніх дочірніх елементів цього вузла.
`ParentNode`	`CompositeNode`	Читання	Отримує безпосереднього батька цього вузла.
`Document`	`DocumentBase`	Читання	Отримує документ, до якого належить цей вузол.
`PreviousSibling`	`Node`	Читання	Отримує вузол, який безпосередньо передує цьому вузлу.
`NextSibling`	`Node`	Читання	Отримує вузол, який безпосередньо слідує за цим вузлом.
`Range`	`Range`	Читання	Повертає об’єкт Range, який представляє частину документа, що міститься в цьому вузлі.
`CustomNodeId`	`int`	Читання/Запис	Вказує користувацький ідентифікатор вузла.

Методи

Сигнатура	Опис
`Shape(doc: DocumentBase, shapeType: ShapeType)`	Створює новий об’єкт shape.
`Accept(visitor: DocumentVisitor)`	Викликає VisitShapeStart, потім викликає Accept для всіх дочірніх вузлів shape і викликає VisitShapeEnd в кінці.
`AcceptStart(visitor: DocumentVisitor)`	Приймає відвідувача для відвідування початку форми.
`AcceptEnd(visitor: DocumentVisitor)`	Приймає відвідувача для відвідування кінця форми.
`LocalToParent(value: PointF)`	Перетворює значення з локального простору координат у простір координат батьківської форми.
`AdjustWithEffects(source: RectangleF)`	Додає до вихідного прямокутника значення розміру ефекту і повертає кінцевий прямокутник.
`GetText()`	Отримує текст цього вузла та всіх його дочірніх елементів.
`GetChildNodes(nodeType: NodeType, isDeep: bool)`	Повертає колекцію дочірніх вузлів, які відповідають вказаному типу.
`GetChild(nodeType: NodeType, index: int, isDeep: bool)`	Повертає N-й дочірній вузол, який відповідає вказаному типу.
`SelectNodes(xpath: string)`	Вибирає список вузлів, що відповідають виразу XPath.
`SelectSingleNode(xpath: string)`	Вибирає перший Node, який відповідає виразу XPath.
`GetEnumerator()`	Надає підтримку ітерації у стилі «for each» над дочірніми вузлами цього вузла.
`AppendChild(newChild: T)`	Додає вказаний вузол у кінець списку дочірніх вузлів цього вузла.
`PrependChild(newChild: T)`	Додає вказаний вузол на початок списку дочірніх вузлів цього вузла.
`InsertAfter(newChild: T, refChild: Node)`	Вставляє вказаний вузол одразу після вказаного вузла-посилання.
`InsertBefore(newChild: T, refChild: Node)`	Вставляє вказаний вузол безпосередньо перед вказаним опорним вузлом.
`RemoveChild(oldChild: T)`	Видаляє вказаний дочірній вузол.
`RemoveAllChildren()`	Видаляє всі дочірні вузли поточного вузла.
`RemoveSmartTags()`	Видаляє всі SmartTag нащадкові вузли поточного вузла.
`IndexOf(child: Node)`	Повертає індекс вказаного дочірнього вузла в масиві дочірніх вузлів.
`CreateNavigator()`	Створює навігатор, який можна використовувати для обходу та читання вузлів.
`Clone(isCloneChildren: bool)`	Вам слід використовувати перевантаження Clone(bool, INodeCloningListener), коли клонування вузла є частиною іншого (зазвичай складного) процесу клонування вузлів.
`GetAncestor(ancestorType: Type)`	Отримує першого предка вказаного типу об’єкта.
`GetAncestorOf()`	Викликає GetAncestorOf для цього екземпляра Shape.
`Remove()`	Видаляє себе з батьківського елемента.
`NextPreOrder(rootNode: Node)`	Отримує наступний вузол згідно алгоритму обходу дерева у порядку pre-order.
`PreviousPreOrder(rootNode: Node)`	Отримує попередній вузол згідно алгоритму обходу дерева у порядку pre-order.
`ToString(saveFormat: SaveFormat)`	Експортує вміст вузла у рядок у вказаному форматі.
`NodeTypeToString(nodeType: NodeType)`	Утилітний метод, який перетворює значення перерахування типу вузла у зручний для користувача рядок.

Дивіться також

Aspose.Words for .NET — Enterprise API Reference