ShapeBase

ShapeBase class

Базовый класс для объектов в слое чертежа, таких как автофигуры, произвольные формы, объекты OLE, элементы управления ActiveX или изображения.

Чтобы узнать больше, посетитеРабота с фигурами документальная статья.

public abstract class ShapeBase : CompositeNode

Характеристики

Имя	Описание
AllowOverlap { get; set; }	Возвращает или задает значение, указывающее, может ли эта фигура перекрывать другие фигуры.
AlternativeText { get; set; }	Определяет альтернативный текст, отображаемый вместо графики.
AnchorLocked { get; set; }	Указывает, заблокирована ли привязка фигуры.
AspectRatioLocked { get; set; }	Указывает, заблокировано ли соотношение сторон фигуры.
BehindText { get; set; }	Указывает, находится ли фигура под или над текстом.
Bottom { get; }	Получает положение нижнего края содержащего блока фигуры.
Bounds { get; set; }	Возвращает или задает местоположение и размер содержащего блока фигуры.
BoundsInPoints { get; }	Получает местоположение и размер содержащего блока фигуры в пунктах относительно точки привязки самой верхней фигуры.
BoundsWithEffects { get; }	Получает окончательную протяженность объекта-фигуры после применения эффектов рисования. Значение измеряется в точках.
CanHaveImage { get; }	Возвратистинный если тип фигуры позволяет фигуре иметь изображение.
CoordOrigin { get; set; }	Координаты в верхнем левом углу содержащего блока этой формы.
CoordSize { get; set; }	Ширина и высота координатного пространства внутри содержащего блока этой формы.
Count { get; }	Получает количество непосредственных потомков этого узла.
CustomNodeId { get; set; }	Указывает пользовательский идентификатор узла.
DistanceBottom { get; set; }	Возвращает или задает расстояние (в пунктах) между текстом документа и нижним краем фигуры.
DistanceLeft { get; set; }	Возвращает или задает расстояние (в пунктах) между текстом документа и левым краем фигуры.
DistanceRight { get; set; }	Возвращает или задает расстояние (в пунктах) между текстом документа и правым краем фигуры.
DistanceTop { get; set; }	Возвращает или задает расстояние (в пунктах) между текстом документа и верхним краем фигуры.
virtual Document { get; }	Получает документ, к которому принадлежит этот узел.
Fill { get; }	Получает форматирование заливки для фигуры.
FirstChild { get; }	Получает первый дочерний элемент узла.
FlipOrientation { get; set; }	Изменяет ориентацию фигуры.
Font { get; }	Предоставляет доступ к форматированию шрифта этого объекта.
Glow { get; }	Получает форматирование свечения для фигуры.
HasChildNodes { get; }	Возвратистинный если у этого узла есть дочерние узлы.
Height { get; set; }	Возвращает или задает высоту содержащего блока фигуры.
HeightRelative { get; set; }	Возвращает или задает значение, представляющее процент относительной высоты фигуры.
Hidden { get; set; }	Возвращает или задает логическое значение, указывающее, видна ли фигура.
HorizontalAlignment { get; set; }	Указывает, как фигура располагается по горизонтали.
HRef { get; set; }	Получает или задает полный адрес гиперссылки для фигуры.
override IsComposite { get; }	Возвратистинный так как этот узел может иметь дочерние узлы.
IsDecorative { get; set; }	Возвращает или задает флаг, указывающий, является ли фигура декоративной в документе.
IsDeleteRevision { get; }	Возвращает значение true, если этот объект был удален в Microsoft Word при включенном отслеживании изменений.
IsGroup { get; }	Возвратистинный если это групповая форма.
IsHorizontalRule { get; }	Возвратистинный если эта фигура является горизонтальной линейкой.
IsImage { get; }	Возвратистинный если эта форма является формой изображения.
IsInline { get; }	Быстрый способ определить, расположена ли эта фигура в одной строке с текстом.
IsInsertRevision { get; }	Возвращает значение true, если этот объект был вставлен в Microsoft Word при включенном отслеживании изменений.
IsLayoutInCell { get; set; }	Возвращает или задает флаг, указывающий, отображается ли фигура внутри таблицы или вне ее.
IsMoveFromRevision { get; }	Возвратистинный если этот объект был перемещен (удален) в Microsoft Word при включенном отслеживании изменений.
IsMoveToRevision { get; }	Возвратистинный если этот объект был перемещен (вставлен) в Microsoft Word при включенном отслеживании изменений.
IsSignatureLine { get; }	Указывает, что форма являетсяSignatureLine .
IsTopLevel { get; }	Возвратистинный если эта фигура не является дочерней по отношению к группе фигур.
IsWordArt { get; }	Возвратистинный если эта фигура является объектом WordArt.
LastChild { get; }	Получает последний дочерний элемент узла.
Left { get; set; }	Возвращает или задает положение левого края содержащего блока фигуры.
LeftRelative { get; set; }	Возвращает или задает значение, представляющее относительное левое положение фигуры в процентах.
MarkupLanguage { get; }	Получает MarkupLanguage, используемый для этого графического объекта.
Name { get; set; }	Получает или задает необязательное имя фигуры.
NextSibling { get; }	Получает узел, следующий сразу за данным узлом.
abstract NodeType { get; }	Получает тип этого узла.
ParentNode { get; }	Получает непосредственного родителя этого узла.
ParentParagraph { get; }	Возвращает непосредственный родительский абзац.
PreviousSibling { get; }	Получает узел, непосредственно предшествующий данному узлу.
Range { get; }	ВозвращаетRangeобъект, представляющий часть документа, содержащуюся в этом узле.
Reflection { get; }	Получает форматирование отражения для фигуры.
RelativeHorizontalPosition { get; set; }	Указывает, относительно чего фигура расположена горизонтально.
RelativeHorizontalSize { get; set; }	Возвращает или задает значение относительного размера фигуры в горизонтальном направлении.
RelativeVerticalPosition { get; set; }	Указывает, относительно чего фигура расположена по вертикали.
RelativeVerticalSize { get; set; }	Возвращает или задает значение относительного размера фигуры в вертикальном направлении.
Right { get; }	Получает положение правого края содержащего блока фигуры.
Rotation { get; set; }	Определяет угол (в градусах), на который поворачивается фигура. Положительное значение соответствует углу поворота по часовой стрелке.
ScreenTip { get; set; }	Определяет текст, отображаемый при перемещении указателя мыши по фигуре.
ShadowFormat { get; }	Получает форматирование тени для фигуры.
ShapeType { get; }	Получает тип фигуры.
SizeInPoints { get; }	Получает размер фигуры в точках.
SoftEdge { get; }	Получает мягкое форматирование краев для фигуры.
Target { get; set; }	Получает или задает целевой фрейм для гиперссылки формы.
Title { get; set; }	Возвращает или задает заголовок (подпись) текущего объекта фигуры.
Top { get; set; }	Возвращает или задает положение верхнего края содержащего блока фигуры.
TopRelative { get; set; }	Возвращает или задает значение, представляющее относительное верхнее положение фигуры в процентах.
VerticalAlignment { get; set; }	Указывает, как фигура располагается по вертикали.
Width { get; set; }	Возвращает или задает ширину содержащего блока фигуры.
WidthRelative { get; set; }	Возвращает или задает значение, представляющее процент относительной ширины фигуры.
WrapSide { get; set; }	Указывает, как текст обтекает фигуру.
WrapType { get; set; }	Определяет, является ли фигура встроенной или плавающей. Для плавающих фигур определяет режим обтекания текста вокруг фигуры.
ZOrder { get; set; }	Определяет порядок отображения перекрывающихся фигур.

Методы

Имя	Описание
abstract Accept(DocumentVisitor)	Принимает посетителя.
abstract AcceptEnd(DocumentVisitor)	При реализации в производном классе вызывает метод VisitXXXEnd указанного посетителя документа.
abstract AcceptStart(DocumentVisitor)	При реализации в производном классе вызывает метод VisitXXXStart указанного посетителя документа.
AdjustWithEffects(RectangleF)	Добавляет к исходному прямоугольнику значения степени эффекта и возвращает конечный прямоугольник.
AppendChild<T>(T)	Добавляет указанный узел в конец списка дочерних узлов для данного узла.
Clone(bool)	Создает дубликат узла.
CreateNavigator()	Создает навигатор, который можно использовать для перемещения и чтения узлов.
GetAncestor(NodeType)	Получает первого предка указанногоNodeType .
GetAncestor(Type)	Получает первого предка указанного типа объекта.
GetChild(NodeType, int, bool)	Возвращает N-й дочерний узел, соответствующий указанному типу.
GetChildNodes(NodeType, bool)	Возвращает живую коллекцию дочерних узлов, соответствующих указанному типу.
GetEnumerator()	Обеспечивает поддержку для каждой итерации стиля по дочерним узлам этого узла.
GetShapeRenderer()	Создает и возвращает объект, который можно использовать для преобразования этой фигуры в изображение.
override GetText()	Получает текст этого узла и всех его дочерних узлов.
IndexOf(Node)	Возвращает индекс указанного дочернего узла в массиве дочерних узлов.
InsertAfter<T>(T, Node)	Вставляет указанный узел сразу после указанного ссылочного узла.
InsertBefore<T>(T, Node)	Вставляет указанный узел непосредственно перед указанным ссылочным узлом.
LocalToParent(PointF)	Преобразует значение из локального координатного пространства в координатное пространство родительской фигуры.
NextPreOrder(Node)	Получает следующий узел в соответствии с алгоритмом обхода дерева предварительного порядка.
PrependChild<T>(T)	Добавляет указанный узел в начало списка дочерних узлов для данного узла.
PreviousPreOrder(Node)	Получает предыдущий узел в соответствии с алгоритмом обхода дерева предварительного порядка.
Remove()	Удаляет себя из родителя.
RemoveAllChildren()	Удаляет все дочерние узлы текущего узла.
RemoveChild<T>(T)	Удаляет указанный дочерний узел.
RemoveSmartTags()	Удаляет всеSmartTag узлы-потомки текущего узла.
SelectNodes(string)	Выбирает список узлов, соответствующих выражению XPath.
SelectSingleNode(string)	Выбирает первыйNode что соответствует выражению XPath.
ToString(SaveFormat)	Экспортирует содержимое узла в строку указанного формата.
ToString(SaveOptions)	Экспортирует содержимое узла в строку, используя указанные параметры сохранения.

Примечания

Это абстрактный класс. Два производных класса, которые вы можете инстанцировать , этоShape иGroupShape.

Фигура — это узел в дереве документа.

Если форма является потомкомParagraph объект, то говорят, что фигура «верхнего уровня». Фигуры верхнего уровня измеряются и позиционируются в точках.

Форма также может быть потомкомGroupShape объект, когда несколько shape сгруппированы. Дочерние фигуры групповой фигуры располагаются в координатном пространстве, а units определяютсяCoordSize иCoordOrigin свойства групповой формы parent .

Фигура может быть расположена в строке с текстом или плавающей. Метод позиционирования — controled с использованиемWrapType свойство.

Когда фигура плавающая, она позиционируется относительно чего-либо (например, текущего абзаца, поля или страницы). Относительное позиционирование фигуры указывается с помощью RelativeHorizontalPosition иRelativeVerticalPosition характеристики.

Плавающая фигура может быть позиционирована явно с помощьюLeft иTop свойства или выровнены относительно какого-либо другого объекта с помощьюHorizontalAlignment иVerticalAlignment характеристики.

Примеры

Показывает, как вставить плавающее изображение в центр страницы.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Вставьте плавающее изображение, которое будет отображаться за перекрывающимся текстом, и выровняйте его по центру страницы.
Shape shape = builder.InsertImage(ImageDir + "Logo.jpg");
shape.WrapType = WrapType.None;
shape.BehindText = true;
shape.RelativeHorizontalPosition = RelativeHorizontalPosition.Page;
shape.RelativeVerticalPosition = RelativeVerticalPosition.Page;
shape.HorizontalAlignment = HorizontalAlignment.Center;
shape.VerticalAlignment = VerticalAlignment.Center;

doc.Save(ArtifactsDir + "Image.CreateFloatingPageCenter.docx");

Смотрите также

• class CompositeNode
• пространство имен Aspose.Words.Drawing
• сборка Aspose.Words