Shape Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет объект на слое документа, например автофигуру, свободную форму, объект OLE или рисунок. Объект Shape является членом Shapes коллекции. Коллекция Фигуры содержит все фигуры на слайде.
public interface class Shape[System.Runtime.InteropServices.Guid("00024439-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface ShapePublic 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). |
Применяется к
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по