Shapes Интерфейс

Определение

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

Microsoft.Office.Interop.Word

Сборка:

Microsoft.Office.Interop.Word.dll

Коллекция Shape объектов, представляющих все фигуры в документе или все фигуры во всех верхних и нижних колонтитулах документа.

public interface class Shapes : System::Collections::IEnumerable

[System.Runtime.InteropServices.Guid("0002099F-0000-0000-C000-000000000046")]
public interface Shapes : System.Collections.IEnumerable

type Shapes = interface
    interface IEnumerable

Public Interface Shapes
Implements IEnumerable

Атрибуты

GuidAttribute

Реализации

IEnumerable

Комментарии

Каждый объект Shape представляет объект на слое рисования, например автофигуру, свободную форму, объект OLE или рисунок.

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

Используйте свойство , Shapes чтобы вернуть коллекцию Shapes .

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

Используйте один из следующих методов коллекции 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), , AddPolyline(Object, Object)AddShape(Int32, Single, Single, Single, Single, Object)AddOLEObject(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object), AddTextEffect(MsoPresetTextEffect, String, String, Single, MsoTriState, MsoTriState, Single, Single, Object)AddTextbox(MsoTextOrientation, Single, Single, Single, Single, Object), или BuildFreeform(MsoEditingType, Single, Single) , чтобы добавить фигуру в документ и вернуть объект Shape, представляющий только что созданную фигуру.

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

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

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

Свойство Count для этой коллекции в документе возвращает количество элементов только в main истории. Чтобы подсчитать фигуры во всех колонтитулах, используйте коллекцию Фигуры с любым HeaderFooter объектом.

Свойства

Application	Application Возвращает объект , представляющий приложение Microsoft Word.
Count	Возвращает количество элементов в указанной коллекции.
Creator	Возвращает 32-разрядное целое число, указывающее приложение, в котором был создан указанный объект.
Item[Object]	Возвращает отдельный объект в коллекции.
Parent	Возвращает объект , представляющий родительский объект указанного объекта.

Методы

AddCallout(MsoCalloutType, Single, Single, Single, Single, Object)	Добавляет выноску без границ в документ. Shape Возвращает объект , представляющий выноску и добавляющий его в коллекциюShapes.
AddCanvas(Single, Single, Single, Single, Object)	Добавляет холст рисунка в документ. Shape Возвращает объект , представляющий холст рисования и добавляющий его в коллекциюShapes.
AddChart(XlChartType, Object, Object, Object, Object, Object)	Этот объект, элемент или перечисление устарели и не предназначены для использования в коде.
AddChart2(Int32, XlChartType, Object, Object, Object, Object, Object, Object)	Добавляет диаграмму в документ. Shape Возвращает объект , представляющий диаграмму и добавляющий его в указанную коллекцию.
AddConnector(MsoConnectorType, Single, Single, Single, Single)	Зарезервировано для внутреннего использования.
AddCurve(Object, Object)	Shape Возвращает объект , представляющий кривую Безье в документе.
AddDiagram(MsoDiagramType, Single, Single, Single, Single, Object)	Shape Возвращает объект , представляющий только что созданную схему в документе.
AddLabel(MsoTextOrientation, Single, Single, Single, Single, Object)	Добавляет текстовую метку в документ. Shape Возвращает объект , представляющий текстовую метку и добавляющий его в коллекциюShapes.
AddLine(Single, Single, Single, Single, Object)	Добавляет строку в документ. Shape Возвращает объект , представляющий строку и добавляющий ее в коллекциюAddCallout(MsoCalloutType, Single, Single, Single, Single, Object).
AddOLEControl(Object, Object, Object, Object, Object, Object)	Создает элемент управления ActiveX (ранее известный как элемент управления OLE). Shape Возвращает объект , представляющий новый элемент activeX.
AddOLEObject(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)	Создает объект OLE. Shape Возвращает объект , представляющий новый объект OLE.
AddPicture(String, Object, Object, Object, Object, Object, Object, Object)	Добавляет рисунок в документ. Shape Возвращает объект, представляющий рисунок и добавляющий его в коллекциюShapes.
AddPolyline(Object, Object)	Добавляет открытый или закрытый многоугольник в документ. Shape Возвращает объект, представляющий многоугольник и добавляющий его в коллекциюShapes.
AddShape(Int32, Single, Single, Single, Single, Object)	Добавляет автофигуру в документ. Shape Возвращает объект , представляющий автофигуру и добавляющий его в коллекциюShapes.
AddSmartArt(SmartArtLayout, Object, Object, Object, Object, Object)	Вставляет указанный графический элемент SmartArt в активный документ.
AddTextbox(MsoTextOrientation, Single, Single, Single, Single, Object)	Добавляет текстовое поле в документ. Shape Возвращает объект , представляющий текстовое поле и добавляющий его в коллекциюShapes.
AddTextEffect(MsoPresetTextEffect, String, String, Single, MsoTriState, MsoTriState, Single, Single, Object)	Добавляет фигуру WordArt в документ. Shape Возвращает объект , представляющий объект WordArt и добавляющий его в коллекциюShapes.
AddWebVideo(String, Object, Object, Object, Object, Object, Object, Object, Object, Object)	Добавляет в документ новое веб-видео.
BuildFreeform(MsoEditingType, Single, Single)	Создает объект свободной формы. FreeformBuilder Возвращает объект , представляющий свободную форму при ее сборке.
GetEnumerator()	Коллекция Shape объектов, представляющих все фигуры в документе или все фигуры во всех верхних и нижних колонтитулах документа.
Range(Object)	ShapeRange Возвращает объект .
SelectAll()	Выделяет все фигуры в main истории, на холсте или в верхних и нижних колонтитулах документа.