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`	Чтение	Предоставляет доступ к необработанным (raw) значениям настройки формы.
`SignatureLine`	`SignatureLine`	Чтение	Получает объект SignatureLine, если shape является строкой подписи.
`HasChart`	`bool`	Чтение	Возвращает true, если у этой Shape есть Chart.
`HasSmartArt`	`bool`	Чтение	Возвращает true, если у этой Shape есть объект SmartArt.
`Chart`	`Chart`	Чтение	Обеспечивает доступ к свойствам chart, если у этой shape есть Chart.
`Fill`	`Fill`	Чтение	Получает формат заливки для фигуры.
`ShadowFormat`	`ShadowFormat`	Чтение	Получает форматирование тени для фигуры.
`Glow`	`GlowFormat`	Чтение	Получает формат свечения для shape.
`Reflection`	`ReflectionFormat`	Чтение	Получает формат отражения для фигуры.
`SoftEdge`	`SoftEdgeFormat`	Чтение	Получает форматирование мягкой кромки для фигуры.
`ScreenTip`	`string`	Чтение/запись	Определяет текст, отображаемый при наведении указателя мыши на фигуру.
`HRef`	`string`	Чтение/запись	Получает или задает полный адрес гиперссылки для shape.
`Target`	`string`	Чтение/запись	Получает или задает целевую рамку гиперссылки формы.
`AlternativeText`	`string`	Чтение/запись	Определяет альтернативный текст, который будет отображаться вместо графического элемента.
`IsDecorative`	`bool`	Чтение/запись	Получает или задает флаг, указывающий, является ли фигура декоративной в документе.
`Title`	`string`	Чтение/запись	Получает или задает заголовок (подпись) текущего объекта формы.
`Name`	`string`	Чтение/запись	Получает или задает необязательное имя shape name.
`IsInsertRevision`	`bool`	Чтение	Получает is insert revision.
`IsDeleteRevision`	`bool`	Чтение	Получает признак удаления ревизии.
`IsMoveFromRevision`	`bool`	Чтение	Получает перемещение из ревизии.
`IsMoveToRevision`	`bool`	Чтение	Получает значение is move to revision.
`IsTopLevel`	`bool`	Чтение	Возвращает true, если эта фигура не является дочерним элементом групповой фигуры.
`IsGroup`	`bool`	Чтение	Возвращает true, если это групповая фигура.
`IsImage`	`bool`	Чтение	Возвращает true, если эта фигура является фигурой изображения.
`IsHorizontalRule`	`bool`	Чтение	Возвращает true, если эта фигура является горизонтальной чертой.
`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`	Чтение	Указывает, что shape является 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)`	Создаёт новый объект формы.
`Accept(visitor: DocumentVisitor)`	Вызывает VisitShapeStart, затем вызывает Accept для всех дочерних узлов формы и вызывает 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)`	Выбирает первый узел, соответствующий выражению 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)`	Получает следующий узел согласно алгоритму обхода дерева в порядке предобхода.
`PreviousPreOrder(rootNode: Node)`	Получает предыдущий узел согласно алгоритму обхода дерева в порядке предобхода.
`ToString(saveFormat: SaveFormat)`	Экспортирует содержимое узла в строку в указанном формате.
`NodeTypeToString(nodeType: NodeType)`	Вспомогательный метод, который преобразует значение перечисления типа узла в человекочитаемую строку.

См. также:

Aspose.Words for .NET — Enterprise API Reference