Поделиться через


Shape Интерфейс

Определение

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

public interface class Shape
[System.Runtime.InteropServices.Guid("00024439-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface Shape
Public Interface Shape
Атрибуты

Комментарии

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

В этом разделе описано, как:

  • Возвращает существующую фигуру.
  • Возвращает фигуру в выделенном фрагменте.
  • Возвращает фигуры, прикрепленные к концам соединителя.
  • Возвращает только что созданную свободную форму.
  • Возвращает одну фигуру из группы.
  • Возвращает только что сформированную группу фигур.

Возвращение существующей фигуры

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

Каждой фигуре присваивается имя по умолчанию при ее добавлении в коллекцию Фигуры . Чтобы придать фигуре более понятное имя, используйте Name свойство .

Возвращение фигуры в выделенном фрагменте

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

Возвращение фигур, присоединенных к концам соединителя

Чтобы вернуть объект Shape , представляющий одну из фигур, присоединенных соединителем, используйте BeginConnectedShape свойство или EndConnectedShape .

Возврат только что созданной свободной формы

BuildFreeform(MsoEditingType, Single, Single) Используйте методы и AddNodes(MsoSegmentType, MsoEditingType, Single, Single, Object, Object, Object, Object) для определения геометрии новой свободной формы, а метод — ConvertToShape() для создания свободной формы и возврата объекта Shape, представляющего ее.

Возвращение одной фигуры из группы

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

Возвращение вновь сформированной группы фигур

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

Свойства

Adjustments

Adjustments Возвращает объект , содержащий значения корректировки для всех корректировок в указанной фигуре. Только для чтения.

AlternativeText

Возвращает или задает описательную (альтернативную) текстовую Shape строку для объекта при сохранении объекта на веб-странице. Для чтения и записи, String.

Application

Application Возвращает объект , представляющий приложение Microsoft Excel. Только для чтения.

AutoShapeType

Возвращает или задает тип фигуры для указанного Shape объекта, который должен представлять автофигуру, отличный от линии, рисунка свободной формы или соединителя. Чтение и запись MsoAutoShapeType.

BackgroundStyle

Возвращает или задает стиль фона. Для чтения и записи.

BlackWhiteMode

Возвращает или задает значение, указывающее, как отображается указанная фигура при просмотре презентации в черно-белом режиме. Чтение и запись MsoBlackWhiteMode.

BottomRightCell

Range Возвращает объект , представляющий ячейку, расположенную под правым нижним углом объекта . Только для чтения.

Callout

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

CanvasItems

Зарезервировано для внутреннего использования.

Chart

Возвращает объект , представляющий объект , _Chart содержащийся в Shape. Только для чтения.

Child

Возвращает msoTrue, если указанная фигура является дочерней фигурой или если все фигуры в диапазоне фигур являются дочерними фигурами одного родительского элемента. Только для MsoTriStateчтения .

ConnectionSiteCount

Возвращает количество сайтов подключения на указанной фигуре. Только для чтения, Integer.

Connector

Значение true , если указанная фигура является соединителем. Только для MsoTriStateчтения .

ConnectorFormat

ConnectorFormat Возвращает объект , содержащий свойства форматирования соединителя. Применяется к Shape объектам, представляющим соединители. Только для чтения.

ControlFormat

ControlFormat Возвращает объект , содержащий свойства элемента управления Microsoft Excel. Только для чтения.

Creator

Возвращает 32-битное целое число, указывающее на приложение, в котором объект был создан. Если объект был создан в Microsoft Excel, это свойство возвращает строку XCEL, эквивалентную шестнадцатеричной цифре 5843454C. Только для XlCreatorчтения .

Diagram

Возвращает объект, Diagram представляющий схему.

DiagramNode

DiagramNode Возвращает объект , представляющий узел на схеме.

DrawingObject

Зарезервировано для внутреннего использования.

Fill

FillFormat Возвращает объект , содержащий свойства форматирования заливки для указанной диаграммы или фигуры. Только для чтения.

FormControlType

Возвращает тип элемента управления Microsoft Excel. Только для XlFormControlчтения .

Glow

Возвращает объект для указанной фигуры, содержащий свойства форматирования свечения для этой фигуры. Только для чтения.

GroupItems

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

HasChart

Возвращает сведения о том, содержит ли Shape диаграмма. Только для чтения.

HasDiagram

Возвращает значение, указывающее, содержит ли фигура или диапазон фигуры схему. Только для MsoTriStateчтения .

HasDiagramNode

Возвращает значение, указывающее, существует ли узел схемы в заданной фигуре или диапазоне фигур. Только для MsoTriStateчтения .

HasSmartArt

Возвращает значение, указывающее, присутствует ли на указанной фигуре схема SmartArt.

Height

Высота объекта. Для чтения и записи, Single.

HorizontalFlip

Значение true , если указанная фигура перевернута вокруг горизонтальной оси. Только для MsoTriStateчтения .

Hyperlink

Hyperlink Возвращает объект , представляющий гиперссылку для фигуры.

ID

Возвращает тип для указанного объекта. Только для чтения, Integer.

Left

Расстояние от левого края объекта до левого края столбца A (на листе) или левого края области диаграммы (на диаграмме). Для чтения и записи, Single.

Line

LineFormat Возвращает объект , содержащий свойства форматирования линий для указанной фигуры. Только для чтения.

LinkFormat

LinkFormat Возвращает объект , содержащий связанные свойства объекта OLE. Только для чтения.

LockAspectRatio

Значение true , если указанная фигура сохраняет исходные пропорции при изменении размера фигуры. Значение false , если при изменении размера фигуры можно изменять высоту и ширину фигуры независимо друг от друга. Чтение и запись MsoTriState.

Locked

Значение true , если объект заблокирован, значение False , если объект может быть изменен при защите листа. Для чтения и записи, Boolean.

Name

Возвращает или задает имя объекта. Для чтения и записи, String.

Nodes

Возвращает коллекцию ShapeNodes , представляющую геометрическое описание указанной фигуры. Применяется к Shape объектам, представляющим рисунки свободной формы.

OLEFormat

OLEFormat Возвращает объект , содержащий свойства объекта OLE. Только для чтения.

OnAction

Возвращает или задает имя макроса, выполняемого при щелчке указанного объекта. Для чтения и записи, String.

Parent

Возвращает родительский объект для указанного объекта. Только для чтения.

ParentGroup

Shape Возвращает объект , представляющий общую родительскую фигуру дочерней фигуры или диапазон дочерних фигур.

PictureFormat

PictureFormat Возвращает объект , содержащий свойства форматирования рисунка для указанной фигуры. Применяется к Shape объектам, представляющим рисунки или объекты OLE. Только для чтения.

Placement

Возвращает или задает способ присоединения объекта к ячейкам под ним. Чтение и запись XlPlacement.

Reflection

Возвращает объект, содержащий свойства форматирования отражения для фигуры. Только для чтения.

Rotation

Возвращает или задает поворот фигуры в градусах. Для чтения и записи, Single.

Script

Возвращает объект Script , представляющий блок скрипта или кода на указанной веб-странице. Если страница не содержит скрипта, ничего не возвращается.

Shadow

Значение true , если объект имеет тень. Для чтения и записи, Boolean.

ShapeStyle

Возвращает или задает объект MsoShapeStyleIndex , представляющий стиль фигуры. Для чтения и записи.

SmartArt

Возвращает объект, представляющий объект SmartArt, связанный с фигурой.

SoftEdge

SoftEdgeFormat Возвращает объект для указанной фигуры, содержащий свойства форматирования мягкого края для фигуры. Только для чтения.

TextEffect

TextEffectFormat Возвращает объект , содержащий свойства форматирования текстовых эффектов для указанной фигуры. Применяется к объектам T:Microsoft.Office.Interop.Excel.Shape , представляющим Объект WordArt. Только для чтения.

TextFrame

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

TextFrame2

Возвращает объект, содержащий форматирование текста для указанной фигуры. Только для чтения.

ThreeD

ThreeDFormat Возвращает объект, содержащий трехмерные свойства форматирования эффекта для указанной фигуры. Только для чтения.

Title

Возвращает или задает заголовок альтернативного текста, связанного с указанной фигурой.

Top

Расстояние от верхнего края верхней фигуры в диапазоне фигур до верхнего края листа. Для чтения и записи, Single.

TopLeftCell

Range Возвращает объект , представляющий ячейку, расположенную в левом верхнем углу указанного объекта. Только для чтения.

Type

Возвращает или задает тип фигуры. Только для MsoShapeTypeчтения .

VerticalFlip

Значение true , если указанная фигура перевернута вокруг вертикальной оси. Только для MsoTriStateчтения .

Vertices

Возвращает координаты вершин указанного рисунка свободной формы (и контрольных точек для кривых Безье) в виде ряда пар координат. Объект только для чтения.

Visible

Определяет, является ли объект видимым. Чтение и запись MsoTriState.

Width

Ширина объекта. Для чтения и записи, Single.

ZOrderPosition

Возвращает положение указанной фигуры в порядке z. Только для чтения, Integer.

Методы

Apply()

Применяется к указанному форматированию фигуры, скопированной с помощью PickUp() метода .

CanvasCropBottom(Single)

Зарезервировано для внутреннего использования.

CanvasCropLeft(Single)

Зарезервировано для внутреннего использования.

CanvasCropRight(Single)

Зарезервировано для внутреннего использования.

CanvasCropTop(Single)

Зарезервировано для внутреннего использования.

Copy()

Копирует объект в буфер обмена.

CopyPicture(Object, Object)

Копирует выбранный объект в буфер обмена в виде рисунка.

Cut()

Вырезает объект в буфер обмена или вставляет его в указанное место назначения.

Delete()

Удаляет объект .

Duplicate()

Дублирует объект и возвращает ссылку на новую копию.

Flip(MsoFlipCmd)

Переворачивает указанную фигуру вокруг горизонтальной или вертикальной оси.

IncrementLeft(Single)

Перемещает указанную фигуру по горизонтали на указанное количество точек.

IncrementRotation(Single)

Изменяет поворот указанной фигуры вокруг оси Z на указанное количество градусов. Используйте свойство , Rotation чтобы задать абсолютный поворот фигуры.

IncrementTop(Single)

Перемещает указанную фигуру по вертикали на указанное количество точек.

PickUp()

Копирует форматирование указанной фигуры. Используйте метод , Apply() чтобы применить скопированное форматирование к другой фигуре.

RerouteConnections()

Перенаправляет соединители так, чтобы они пробирали кратчайший путь между фигурами, которые они подключают.

ScaleHeight(Single, MsoTriState, Object)

Масштабирует высоту фигуры с применением указанного коэффициента.

ScaleWidth(Single, MsoTriState, Object)

Масштабирует ширину фигуры с применением указанного коэффициента.

Select(Object)

Выбирает объект .

SetShapesDefaultProperties()

Делает форматирование указанной фигуры форматированием по умолчанию для фигуры.

Ungroup()

Разгруппирует все сгруппированные фигуры в указанной фигуре или диапазоне фигур. Дизассемблирует изображения и объекты OLE в пределах указанной фигуры. Возвращает негруппированные фигуры в виде одного ShapeRange объекта.

ZOrder(MsoZOrderCmd)

Помещает указанную фигуру перед или за другими фигурами в коллекции (то есть изменяет положение фигуры по оси Z).

Применяется к