Shape Интерфейс

Определение

Пространство имен:

Microsoft.Office.Interop.Word

Сборка:

Microsoft.Office.Interop.Word.dll

Представляет объект на слое рисования, например автофигуру, свободную форму, объект OLE, элемент ActiveX или рисунок.

public interface class Shape

[System.Runtime.InteropServices.Guid("000209A0-0000-0000-C000-000000000046")]
public interface Shape

type Shape = interface

Public Interface Shape

Атрибуты

GuidAttribute

Комментарии

Объект Shape является членом Shapes коллекции, которая включает все фигуры в main истории документа или во всех верхних и нижних колонтитулах документа.

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

Существует три объекта, которые представляют фигуры: Shapes коллекция, представляющая все фигуры в документе; ShapeRange коллекция, представляющая указанное подмножество фигур в документе (например, ShapeRange объект может представлять фигуры один и четыре в документе или может представлять все выбранные фигуры в документе Shape ); объект . представляет одну фигуру в документе. Если вы хотите работать с несколькими фигурами одновременно или с фигурами в выделенном фрагменте, используйте коллекцию ShapeRange .

Используйте Shapes(index), где index — это имя или номер индекса, чтобы вернуть один Shape объект.

Каждой фигуре присваивается имя по умолчанию при ее создании. Например, если добавить в документ три различные фигуры, они могут называться "Прямоугольник 2", "TextBox 3" и "Овал 4". Чтобы придать фигуре более понятное имя, задайте Name свойство .

Используйте Selection.ShapeRange(index), где index — это имя или номер индекса, чтобы вернуть Shape объект, представляющий фигуру в выделенном фрагменте.

Чтобы добавить Shape объект в коллекцию фигур для указанного документа и вернуть Shape объект, представляющий только что созданную фигуру, используйте один из следующих методов Shapes коллекции: AddCallout(MsoCalloutType, Single, Single, Single, Single, Object), AddCurve(Object, Object), AddLabel(MsoTextOrientation, Single, Single, Single, Single, Object), AddLine(Single, Single, Single, Single, Object), AddOLEControl(Object, Object, Object, Object, Object, Object), , AddOLEObject(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object), AddTextbox(MsoTextOrientation, Single, Single, Single, Single, Object)AddTextEffect(MsoPresetTextEffect, String, String, Single, MsoTriState, MsoTriState, Single, Single, Object)AddPolyline(Object, Object)AddShape(Int32, Single, Single, Single, Single, Object)или .BuildFreeform(MsoEditingType, Single, Single)

Используйте GroupItems(index), где index — это имя фигуры или номер индекса в группе, чтобы вернуть объект Shape , представляющий одну фигуру в сгруппированной фигуре.

Group() Используйте метод или Regroup() для группировки диапазона фигур и возврата одного Shape объекта, представляющего только что сформированную группу. После формирования группы вы можете работать с ней так же, как с любой другой фигурой.

Каждый Shape объект привязан к диапазону текста. Фигура привязана к началу первого абзаца, содержащего диапазон привязки. Фигура всегда будет оставаться на той же странице, что и ее привязка.

Саму привязку можно просмотреть, задав для ShowObjectAnchors свойства значение True. Свойства фигуры Top и Left определяют ее вертикальное и горизонтальное положение. Свойства фигуры RelativeHorizontalPosition и RelativeVerticalPosition определяют, измеряется ли позиция из закрепляющего абзаца, столбца, содержащего абзац привязки, поля или края страницы.

LockAnchor Если для свойства фигуры задано значение True, вы не сможете перетащить привязку из ее положения на странице.

Используйте свойство , Fill чтобы вернуть FillFormat объект , который содержит все свойства и методы для форматирования заливки закрытой фигуры. Свойство Shadow возвращает ShadowFormat объект , который используется для форматирования тени. Используйте свойство , Line чтобы вернуть LineFormat объект , который содержит свойства и методы для форматирования линий и стрелок. Свойство TextEffect возвращает TextEffectFormat объект , который используется для форматирования Объекта WordArt. Свойство Callout возвращает CalloutFormat объект , который используется для форматирования выносок строк. Свойство WrapFormat возвращает WrapFormat объект , который используется для определения способа переноса текста вокруг фигур. Свойство ThreeD возвращает ThreeDFormat объект , который используется для создания трехмерных фигур. Методы и Apply() можно использовать PickUp() для передачи форматирования из одной фигуры в другую.

SetShapesDefaultProperties() Используйте метод для объекта, Shape чтобы задать форматирование фигуры по умолчанию для документа. Новые фигуры наследуют многие из своих атрибутов от фигуры по умолчанию.

Используйте свойство , Type чтобы указать тип фигуры: свободная форма, Автофигура, объект OLE, выноска или связанное изображение. Используйте свойство , AutoShapeType чтобы указать тип AutoShape: овальный, прямоугольник или воздушный шар, например.

Width Используйте свойства иHeight, чтобы указать размер фигуры.

Свойство TextFrame возвращает TextFrame объект , который содержит все свойства и методы для присоединения текста к фигурам и связывания текста между текстовыми кадрами.

Shape объекты привязаны к диапазону текста, но являются свободно плавающими и могут размещаться в любом месте страницы. InlineShape объекты обрабатываются как символы и позиционируются как символы в строке текста. Метод и ConvertToShape() метод можно использовать ConvertToInlineShape() для преобразования фигур из одного типа в другой. В встроенные фигуры можно преобразовывать только рисунки, объекты OLE и элементы ActiveX.

Свойства

Adjustments	Adjustments Возвращает объект , содержащий значения корректировки для всех корректировок в указанном Shape объекте, представляющего автофигуру или Объект WordArt.
AlternativeText	Возвращает или задает альтернативный текст, связанный с фигурой на веб-странице.
Anchor	Range Возвращает объект , представляющий диапазон привязки для указанной фигуры.
AnchorID	Представляет объект на слое рисования, например автофигуру, свободную форму, объект OLE, элемент ActiveX или рисунок.
Application	Application Возвращает объект , представляющий приложение Microsoft Word.
AutoShapeType	Возвращает или задает тип фигуры для указанного Shape объекта, который должен представлять автофигуру, отличный от линии или рисунка свободной формы.
BackgroundStyle	Возвращает или задает стиль фона указанной фигуры.
Callout	CalloutFormat Возвращает объект , содержащий свойства форматирования выноски для указанной фигуры.
CanvasItems	CanvasShapes Возвращает объект , представляющий коллекцию фигур на холсте рисования.
Chart	Chart Возвращает объект , представляющий диаграмму в коллекции фигур в документе. Только для чтения.
Child	Определяет, является ли фигура дочерней фигурой.
ConnectionSiteCount	Зарезервировано для внутреннего использования.
Connector	Зарезервировано для внутреннего использования.
ConnectorFormat	Зарезервировано для внутреннего использования.
Creator	Возвращает 32-разрядное целое число, указывающее приложение, в котором был создан указанный объект.
Diagram	Diagram Возвращает объект, которому принадлежит узел схемы.
DiagramNode	DiagramNode Возвращает объект , представляющий узел на схеме.
EditID	Представляет объект на слое рисования, например автофигуру, свободную форму, объект OLE, элемент ActiveX или рисунок.
Fill	FillFormat Возвращает объект , содержащий свойства форматирования заливки для указанной фигуры.
Glow	GlowFormat Возвращает объект, представляющий форматирование свечения для фигуры. Только для чтения.
GroupItems	GroupShapes Возвращает объект , представляющий отдельные фигуры в указанной группе.
HasChart	Значение true , если указанная фигура содержит диаграмму. Только для чтения.
HasDiagram	Определяет, является ли фигура схемой.
HasDiagramNode	Определяет, является ли фигура узлом схемы.
HasSmartArt	Возвращает значение True , если на фигуре присутствует схема SmartArt.
Height	Возвращает или задает высоту указанной фигуры в точках.
HeightRelative	Возвращает или задает объект Single , представляющий процент относительной высоты фигуры. Для чтения и записи.
HorizontalFlip	Указывает, что фигура была перевернута по горизонтали.
Hyperlink	Hyperlink Возвращает объект , представляющий гиперссылку, связанную с указанной фигурой.
ID	Возвращает тип для указанного объекта.
LayoutInCell	Возвращает целое число , представляющее, отображается ли фигура в таблице или за ее пределами.
Left	Возвращает или задает значение Single , представляющее горизонтальное положение заданной фигуры или диапазона фигур, измеряемое в точках.
LeftRelative	Возвращает или задает значение Single , представляющее относительное левое положение фигуры. Для чтения и записи.
Line	LineFormat Возвращает объект , содержащий свойства форматирования линий для указанной фигуры.
LinkFormat	LinkFormat Возвращает объект , представляющий параметры связи указанной фигуры, связанной с файлом.
LockAnchor	Определяет, заблокирована ли привязка указанного Shape объекта в диапазоне привязки.
LockAspectRatio	Определяет, можно ли изменять высоту и ширину фигуры независимо друг от друга при изменении размера фигуры или при сохранении исходных пропорций.
Name	Возвращает или задает имя указанного объекта.
Nodes	Возвращает коллекцию ShapeNodes , представляющую геометрическое описание указанной фигуры.
OLEFormat	OLEFormat Возвращает объект , представляющий характеристики OLE (кроме связывания) для указанной фигуры.
Parent	Возвращает объект , представляющий родительский объект указанного объекта.
ParentGroup	Shape Возвращает объект , представляющий общую родительскую форму дочерней фигуры.
PictureFormat	PictureFormat Возвращает объект , содержащий свойства форматирования рисунка для указанного объекта.
Reflection	ReflectionFormat Возвращает объект , представляющий форматирование отражения для фигуры. Только для чтения.
RelativeHorizontalPosition	Указывает, к какому горизонтальному положению фигуры относится.
RelativeHorizontalSize	Возвращает или задает константу WdRelativeHorizontalSize , представляющую объект, к которому относится диапазон фигур. Для чтения и записи.
RelativeVerticalPosition	Указывает, к какому вертикальному положению фигуры относится.
RelativeVerticalSize	Возвращает или задает константу WdRelativeVerticalSize , представляющую относительный вертикальный размер фигуры. Для чтения и записи.
Rotation	Возвращает или задает количество градусов, в которых указанная фигура повернута вокруг оси Z.
RTF	Зарезервировано для внутреннего использования.
Script	Script Возвращает объект , представляющий блок скрипта или кода на указанной веб-странице.
Shadow	ShadowFormat Возвращает объект , представляющий форматирование тени для указанной фигуры.
ShapeStyle	Возвращает или задает стиль фигуры для указанной фигуры.
SmartArt	SmartArt Возвращает объект , предоставляющий способ работы с элементом SmartArt, связанным с указанной фигурой.
SoftEdge	SoftEdgeFormat Возвращает объект , представляющий форматирование мягких краев для фигуры. Только для чтения.
TextEffect	TextEffectFormat Возвращает объект , содержащий свойства форматирования текстовых эффектов для указанной фигуры.
TextFrame	TextFrame Возвращает объект , содержащий текст для указанной фигуры.
TextFrame2	TextFrame2 Возвращает объект , содержащий текст для указанной фигуры. Только для чтения.
ThreeD	ThreeDFormat Возвращает объект , содержащий свойства форматирования трехмерного эффекта для указанной фигуры.
Title	Возвращает или задает строку, содержащую заголовок для указанной фигуры.
Top	Возвращает или задает вертикальное положение указанной фигуры в точках.
TopRelative	Возвращает или задает объект Single , представляющий относительную верхнюю позицию фигуры. Для чтения и записи.
Type	Возвращает тип фигуры.
VerticalFlip	Определяет, перевернута ли указанная фигура вокруг вертикальной оси.
Vertices	Возвращает координаты вершин указанного рисунка свободной формы (и контрольных точек для кривых Безье) в виде ряда пар координат.
Visible	Определяет, является ли указанный объект или примененное к нему форматирование видимым.
Width	Возвращает или задает ширину указанного объекта в точках.
WidthRelative	Возвращает или задает объект Single , представляющий относительную ширину фигуры. Для чтения и записи.
WrapFormat	WrapFormat Возвращает объект , содержащий свойства для упаковки текста вокруг указанной фигуры.
ZOrderPosition	Возвращает положение указанной фигуры в порядке z.

Методы

Activate()	Активирует указанный объект.
Apply()	Применяется к указанному форматированию фигуры, скопированной с помощью PickUp() метода .
CanvasCropBottom(Single)	Обрезает процент от высоты холста от нижней части холста.
CanvasCropLeft(Single)	Обрезает процент ширины холста с левой стороны холста.
CanvasCropRight(Single)	Обрезает процент ширины холста с правой стороны холста.
CanvasCropTop(Single)	Обрезает процент от высоты холста с верхней части холста.
ConvertToFrame()	Преобразует указанную фигуру в рамку.
ConvertToInlineShape()	Преобразует указанную фигуру на слое документа в встроенную фигуру в текстовом слое.
Delete()	Удаляет указанный объект.
Duplicate()	Создает дубликат указанного Shape объекта, добавляет новый диапазон фигур в коллекцию Shapes со стандартным смещением от исходных фигур, а затем возвращает новый объект Shape .
Flip(MsoFlipCmd)	Переворачивает фигуру по горизонтали или вертикали.
IncrementLeft(Single)	Перемещает указанную фигуру по горизонтали на указанное количество точек.
IncrementRotation(Single)	Изменяет поворот указанной фигуры вокруг оси Z на указанное количество градусов.
IncrementTop(Single)	Перемещает указанную фигуру по вертикали на указанное количество точек.
PickUp()	Копирует форматирование указанной фигуры.
RerouteConnections()	Зарезервировано для внутреннего использования.
ScaleHeight(Single, MsoTriState, MsoScaleFrom)	Масштабирует высоту фигуры с применением указанного коэффициента.
ScaleWidth(Single, MsoTriState, MsoScaleFrom)	Масштабирует ширину фигуры с применением указанного коэффициента.
Select(Object)	Выбирает указанный объект.
SetShapesDefaultProperties()	Применяет форматирование указанной фигуры к фигуре по умолчанию для этого документа. Новые фигуры наследуют многие из своих атрибутов от фигуры по умолчанию.
Ungroup()	Разгруппирует все сгруппированные фигуры в указанной фигуре.
ZOrder(MsoZOrderCmd)	Помещает указанную фигуру перед или за другими фигурами в коллекции (то есть изменяет положение фигуры по оси Z).