ShapeRange Интерфейс

Определение

Представляет диапазон фигур, который представляет собой набор фигур в документе.Represents a shape range, which is a set of shapes on a document.

public interface class ShapeRange : System::Collections::IEnumerable
[System.Runtime.InteropServices.Guid("0002443B-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface ShapeRange : System.Collections.IEnumerable
Public Interface ShapeRange
Implements IEnumerable
Атрибуты
Реализации

Комментарии

Диапазон фигур может содержать до одной фигуры или до всех фигур в документе.A shape range can contain as few as a single shape or as many as all the shapes on the document. Для создания диапазона фигур можно включить все нужные фигуры, выбранные из всех фигур документа или всех фигур в выбранном.You can include whichever shapes you want — chosen from among all the shapes on the document or all the shapes in the selection — to construct a shape range. Например, можно создать коллекцию, которая содержит первые три фигуры в документе, все выбранные фигуры в документе или все свободные формы ShapeRange в документе.For example, you could construct a ShapeRange collection that contains the first three shapes on a document, all the selected shapes on a document, or all the freeforms on a document.

Свойства

Adjustments

Возвращает Adjustments объект, содержащий значения корректировки для всех корректировок в указанной фигуре.Returns an Adjustments object that contains adjustment values for all the adjustments in the specified shape. Применяется к любому ShapeRange объекту, который представляет автошап, WordArt или соединительный объект.Applies to any ShapeRange object that represents an AutoShape, WordArt, or a connector. Только для чтения.Read-only.

AlternativeText

Возвращает или задает текстовую строку с описательным (альтернативным) текстом для объекта, когда объект сохранен ShapeRange на веб-странице.Returns or sets the descriptive (alternative) text string for a ShapeRange object when the object is saved to a Web page. Для чтения и записи, String.Read/write String.

Application

Возвращает Application объект, который представляет приложение Microsoft Excel.Returns an Application object that represents the Microsoft Excel application. Только для чтения.Read-only.

AutoShapeType

Возвращает или задает тип фигуры для указанного объекта, который должен представлять автозахва, а не строку, свободный рисунок или ShapeRange соединительный объект.Returns or sets the shape type for the specified ShapeRange object, which must represent an AutoShape other than a line, freeform drawing, or connector. Чтение и написание MsoAutoShapeType .Read/write MsoAutoShapeType.

BackgroundStyle

Возвращает или задает стиль фона.Returns or sets the background style. Для чтения и записи.Read/write.

BlackWhiteMode

Возвращает или задает значение, которое указывает, как отображается указанная фигура при просмотре презентации в черно-белом режиме.Returns or sets a value that indicates how the specified shape appears when the presentation is viewed in black-and-white mode. Чтение и написание MsoBlackWhiteMode .Read/write MsoBlackWhiteMode.

Callout

Возвращает объект, содержащий свойства форматирования CalloutFormat вызовов для указанной фигуры.Returns a CalloutFormat object that contains callout formatting properties for the specified shape. Применяется к ShapeRange объектам, которые представляют собой вызовы линии.Applies to ShapeRange objects that represent line callouts. Только для чтения.Read-only.

CanvasItems

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

Chart

Возвращает объект, который представляет диаграмму, содержаную в диапазоне фигур.Returns an object that represents the chart contained in the shape range. Только для чтения.Read-only.

Child

Возвращает msoTrue, если указанная фигура является child или если все фигуры в диапазоне фигур являются фигурами одного и того же родительского.Returns msoTrue if the specified shape is a child shape or if all shapes in a shape range are child shapes of the same parent. Только для MsoTriState чтения.Read-only MsoTriState.

ConnectionSiteCount

Возвращает количество сайтов подключений в указанной фигуре.Returns the number of connection sites on the specified shape. Только для чтения, Integer.Read-only Integer.

Connector

Имеет true, если указанная фигура является соединитетелем.True if the specified shape is a connector. Только для MsoTriState чтения.Read-only MsoTriState.

ConnectorFormat

Возвращает ConnectorFormat объект, содержащий свойства форматирования соединители.Returns a ConnectorFormat object that contains connector formatting properties. Применяется к ShapeRange объектам, которые представляют соединители.Applies to ShapeRange objects that represent connectors. Только для чтения.Read-only.

Count

Возвращает количество объектов в коллекции.Returns the number of objects in the collection. Только для чтения, Integer.Read-only Integer.

Creator

Возвращает 32-битное целое число, указывающее на приложение, в котором объект был создан.Returns a 32-bit integer that indicates the application in which this object was created. Если объект был создан в Microsoft Excel, это свойство возвращает строку XCEL, эквивалентную 5843454C.If the object was created in Microsoft Excel, this property returns the string XCEL, which is equivalent to the hexadecimal number 5843454C. Только для XlCreator чтения.Read-only XlCreator.

Diagram

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

DiagramNode

Возвращает DiagramNode объект, который представляет узел на схеме.Returns a DiagramNode object that represents a node in a diagram.

Fill

Возвращает FillFormat объект, содержащий свойства форматирования заливки для указанной диаграммы или фигуры.Returns a FillFormat object that contains fill formatting properties for the specified chart or shape. Только для чтения.Read-only.

Glow

Возвращает объект, содержащий свойства форматирования свечения для диапазона фигур.Returns an object that contains glow formatting properties for the shape range. Только для чтения.Read-only.

GroupItems

Возвращает GroupShapes объект, который представляет отдельные фигуры в указанной группе.Returns a GroupShapes object that represents the individual shapes in the specified group. Применяется к ShapeRange объектам, которые представляют сгруппные фигуры.Applies to ShapeRange objects that represent grouped shapes. Только для чтения.Read-only.

HasChart

Возвращает сведения о том, содержит ShapeRange ли диаграмма.Returns information on if a ShapeRange contains a chart. Только для чтения.Read-only.

HasDiagram

Возвращает, содержит ли фигура или диапазон фигур схему.Returns whether a shape or shape range contains a diagram. Только для MsoTriState чтения.Read-only MsoTriState.

HasDiagramNode

Возвращает значение, указывающее, существует ли узел схемы в заданной фигуре или диапазоне фигур.Returns a value indicating whether a diagram node exists in a given shape or shape range. Только для MsoTriState чтения.Read-only MsoTriState.

Height

Высота объекта.The height of the object. Для чтения и записи, Single.Read/write Single.

HorizontalFlip

Имеет true, если указанная фигура перевернута вокруг горизонтальной оси.True if the specified shape is flipped around the horizontal axis. Только для MsoTriState чтения.Read-only MsoTriState.

ID

Возвращает тип указанного объекта.Returns the type for the specified object. Только для чтения, Integer.Read-only Integer.

Left

Расстояние от левого края объекта до левого края столбца A (на таблице) или левого края области диаграммы (на диаграмме).The distance from the left edge of the object to the left edge of column A (on a worksheet) or the left edge of the chart area (on a chart). Для чтения и записи, Single.Read/write Single.

Line

Возвращает LineFormat объект, содержащий свойства форматирования линии для указанной фигуры.Returns a LineFormat object that contains line formatting properties for the specified shape. Только для чтения.Read-only.

LockAspectRatio

Имеет true, если указанная фигура сохраняет исходные пропорции при ее размере.True if the specified shape retains its original proportions when you resize it. False, если вы можете изменить высоту и ширину фигуры независимо друг от друга при изменении ее размеров.False if you can change the height and width of the shape independently of one another when you resize it. Чтение и написание MsoTriState .Read/write MsoTriState.

Name

Возвращает или задает имя объекта.Returns or sets the name of the object. Для чтения и записи, String.Read/write String.

Nodes

Возвращает ShapeNodes коллекцию, представляюную геометрическое описание указанной фигуры.Returns a ShapeNodes collection that represents the geometric description of the specified shape. Применяется к ShapeRange объектам, которые представляют свободные рисунки.Applies to ShapeRange objects that represent freeform drawings.

Parent

Возвращает родительский объект для указанного объекта.Returns the parent object for the specified object. Только для чтения.Read-only.

ParentGroup

Возвращает объект, представляющую общую родительская фигуру или Shape диапазон фигур.Returns a Shape object that represents the common parent shape of a child shape or a range of child shapes.

PictureFormat

Возвращает объект, содержащий свойства форматирования изображений PictureFormat для указанной фигуры.Returns a PictureFormat object that contains picture formatting properties for the specified shape. Применяется к ShapeRange объектам, которые представляют изображения или объекты OLE.Applies to ShapeRange objects that represent pictures or OLE objects. Только для чтения.Read-only.

Reflection

Возвращает объект для указанного диапазона фигур, который содержит свойства форматирования отражения ReflectionFormat для диапазона фигур.Returns a ReflectionFormat object for a specified shape range that contains reflection formatting properties for the shape range. Только для чтения.Read-only.

Rotation

Возвращает или задает поворот фигуры в градусах.Returns or sets the rotation of the shape in degrees. Для чтения и записи, Single.Read/write Single.

Shadow

Имеет true, если шрифт является теневым шрифтом или объект имеет тень.True if the font is a shadow font or if the object has a shadow. Для чтения и записи, Boolean.Read/write Boolean.

ShapeStyle

Возвращает или задает стиль MsoShapeStyleIndex фигуры для диапазона фигур.Returns or sets a MsoShapeStyleIndex that represents shape style for a shape range. Для чтения и записи.Read/write.

SoftEdge

Возвращает объект, содержащий свойства форматирования мягкого края для указанного диапазона фигур.Returns an object that contains soft edge formatting properties for a specified shape range. Только для чтения.Read-only.

TextEffect

Возвращает TextEffectFormat объект, содержащий свойства форматирования текстового эффекта для указанной фигуры.Returns a TextEffectFormat object that contains text-effect formatting properties for the specified shape. Применяется к ShapeRange объектам, которые представляют WordArt.Applies to ShapeRange objects that represent WordArt. Только для чтения.Read-only.

TextFrame

Возвращает объект, содержащий свойства выравнивания и TextFrame привязки для указанного диапазона фигур.Returns a TextFrame object that contains the alignment and anchoring properties for the specified shape range. Только для чтения.Read-only.

TextFrame2

Возвращает объект, содержащий форматирование текста для указанного диапазона фигур.Returns an object that contains text formatting for the specified shape range. Только для чтения.Read-only.

ThreeD

Возвращает объект, содержащий свойства форматирования эффектов для ThreeDFormat указанной фигуры.Returns a ThreeDFormat object that contains 3-D – effect formatting properties for the specified shape. Только для чтения.Read-only.

Title

Возвращает или задает заголовок альтернативного текста, связанного с указанным диапазоном фигур.Gets or sets the title of the alternative text associated with the specified shape range.

Top

Расстояние от верхнего края самой верхней фигуры в диапазоне фигур до верхнего края таблицы.The distance from the top edge of the topmost shape in the shape range to the top edge of the worksheet. Для чтения и записи, Single.Read/write Single.

Type

Возвращает или задает тип фигуры.Returns or sets the shape type. Только для MsoShapeType чтения.Read-only MsoShapeType.

VerticalFlip

Имеет true, если указанная фигура перевернута вокруг вертикальной оси.True if the specified shape is flipped around the vertical axis. Только для MsoTriState чтения.Read-only MsoTriState.

Vertices

Возвращает координаты вершин указанного свободного рисунка (и контрольных точек для кривых Безье) в качестве серии пар координат.Returns the coordinates of the specified freeform drawing's vertices (and control points for Bézier curves) as a series of coordinate pairs. Объект только для чтения.Read-only Object.

Visible

Определяет, является ли объект видимым.Determines whether the object is visible. Чтение и написание MsoTriState .Read/write MsoTriState.

Width

Ширина объекта.The width of the object. Для чтения и записи, Single.Read/write Single.

ZOrderPosition

Возвращает положение указанной фигуры в z-порядке.Returns the position of the specified shape in the z-order. Только для чтения, Integer.Read-only Integer.

Методы

_Default(Object)

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

Align(MsoAlignCmd, MsoTriState)

Выравнивает фигуры в указанном диапазоне фигур.Aligns the shapes in the specified range of shapes.

Apply()

Применяется к указанному форматированию фигур, скопированного с помощью PickUp() метода.Applies to the specified shape formatting that’s been copied by using the PickUp() method.

CanvasCropBottom(Single)

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

CanvasCropLeft(Single)

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

CanvasCropRight(Single)

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

CanvasCropTop(Single)

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

Delete()

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

Distribute(MsoDistributeCmd, MsoTriState)

Горизонтально или вертикально распределяет фигуры в указанном диапазоне фигур.Horizontally or vertically distributes the shapes in the specified range of shapes.

Duplicate()

Дублирует объект и возвращает ссылку на новую копию.Duplicates the object and returns a reference to the new copy.

Flip(MsoFlipCmd)

Пролистывка указанной фигуры вокруг горизонтальной или вертикальной оси.Flips the specified shape around its horizontal or vertical axis.

GetEnumerator()
Group()

Группная фигура в указанном диапазоне.Groups the shapes in the specified range. Возвращает сгруппные фигуры в качестве одного Shape объекта.Returns the grouped shapes as a single Shape object.

IncrementLeft(Single)

Перемещает указанную фигуру по горизонтали на указанное количество точек.Moves the specified shape horizontally by the specified number of points.

IncrementRotation(Single)

Изменяет поворот указанной фигуры вокруг оси Z на указанное количество градусов.Changes the rotation of the specified shape around the z-axis by the specified number of degrees. Используйте Rotation свойство, чтобы установить абсолютный поворот фигуры.Use the Rotation property to set the absolute rotation of the shape.

IncrementTop(Single)

Перемещает указанную фигуру вертикально на указанное количество точек.Moves the specified shape vertically by the specified number of points.

Item(Object)

Возвращает один объект из коллекции.Returns a single object from a collection.

PickUp()

Копирует форматирование указанной фигуры.Copies the formatting of the specified shape. Используйте этот Apply() метод для применения скопированного форматирования к другой фигуре.Use the Apply() method to apply the copied formatting to another shape.

Regroup()

Перегруппировка группы, к которую ранее принадлежит указанный диапазон фигур.Regroups the group that the specified shape range belonged to previously. Возвращает перегруппировку фигур в одном Shape объекте.Returns the regrouped shapes as a single Shape object.

RerouteConnections()

Перенауляет соединители таким образом, чтобы они перенабирали самый короткий из возможных путей между фигурами, к которые они подключаются.Reroutes connectors so that they take the shortest possible path between the shapes they connect.

ScaleHeight(Single, MsoTriState, Object)

Масштабирует высоту фигуры с применением указанного коэффициента.Scales the height of the shape by a specified factor.

ScaleWidth(Single, MsoTriState, Object)

Масштабирует ширину фигуры с применением указанного коэффициента.Scales the width of the shape by a specified factor.

Select(Object)

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

SetShapesDefaultProperties()

Делает форматирование указанной фигуры форматированием по умолчанию для фигуры.Makes the formatting of the specified shape the default formatting for the shape.

Ungroup()

Ungroups any grouped shapes in the specified shape or range of shapes.Ungroups any grouped shapes in the specified shape or range of shapes. Разберет изображения и объекты OLE в пределах указанной фигуры или диапазона фигур.Disassembles pictures and OLE objects within the specified shape or range of shapes. Возвращает негрупповые фигуры в качестве одного ShapeRange объекта.Returns the ungrouped shapes as a single ShapeRange object.

ZOrder(MsoZOrderCmd)

Помещает указанную фигуру перед или за другими фигурами в коллекции (то есть изменяет положение фигуры по оси Z).Moves the specified shape in front of or behind other shapes in the collection (that is, changes the shape's position in the z-order).

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