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
