Объект ShapeRange (Project)ShapeRange object (Project)

Представляет диапазон фигуры, представляющий собой коллекцию из одной или нескольких фигур в отчете.Represents a shape range, which is a collection of one or more shapes in a report.

ПримечанияRemarks

Project использует ту же инфраструктуру Office Art, которая используется другими приложениями Office, и адаптирует Office Art к отчетам, таблицам и диаграммам, которые могут использовать поля в активном проекте.Project uses the same Office Art infrastructure that other Office applications use, and adapts Office Art to reports, tables, and charts that can use fields in the active project. Однако в Project не реализованы все операции ShapeRange .However, Project does not implement all ShapeRange operations. Например, Project не поддерживает автоматическое выравнивание, распределение, группирование и объединение фигур в диапазоне фигур.For example, Project does not support automatic alignment, distribution, grouping, or merging of shapes in a shape range.

Диапазон фигуры может содержать одну фигуру или все фигуры в отчете.A shape range can contain a single shape or all the shapes in the report. Вы можете включить любую фигуру, которую требуется создать для диапазона фигур.You can include whichever shapes you want to construct a shape range. Например, можно создать коллекцию ShapeRange , содержащую первые три фигуры в отчете, все фигуры в отчете или только фигуры треугольников.For example, you can construct a ShapeRange collection that contains the first three shapes in a report, all the shapes in a report, or only the triangle shapes.

Большинство операций, которые можно выполнять с объектом Shape , можно также выполнить с помощью объекта ShapeRange , который содержит только одну фигуру.Most operations that you can do with a Shape object, you can also do with a ShapeRange object that contains only one shape. Некоторые операции, выполняемые при выполнении объекта ShapeRange , содержащего несколько фигур, фигур разных типов или фигуру, которые не полностью поддерживаются в Project, могут вызвать ошибку.Some operations, when performed on a ShapeRange object that contains more than one shape, shapes of different types, or a shape that is not fully supported in Project, can cause an error. Например, если диапазон фигуры содержит прямоугольник и диаграмму, и вы пытаетесь задать свойство Fill , инструкция завершится с ошибкой, так как на диаграмме не реализовано свойство Fill .For example, if a shape range contains a rectangle and a chart, and you try to set the Fill property, the statement fails because a chart does not implement the Fill property. В других случаях, например, если вы используете свойство вращения для диапазона фигур, содержащего диаграмму и прямоугольник, Project поворачивает прямоугольник, но без уведомления диаграммы.In other cases, for example if you use the Rotation property on a shape range that contains a chart and a rectangle, Project rotates the rectangle but silently ignores the chart.

ПримерыExamples

Можно вернуть набор фигур, заданных номером индекса или именем фигуры.You can return a set of shapes that are specified by the index number or by the shape name. USE Shapes.Range(index), где index — это массив номеров или имен индексов.Use Shapes.Range(index), where index is an array of index numbers or names. Например, допустимы следующие операторы:For example, both of the following statements are valid:

Set myRange1 = theReport.Shapes.Range(Array(1, 2))
Set myRange2 = theReport.Shapes.Range(Array("Textbox 1", "Textbox 2"))

Чтобы создать объект ShapeRange , который содержит все фигуры в отчете, используйте следующий оператор:To create a ShapeRange object that contains all of the shapes in the report, use a statement such as the following:

Set allShapes = theReport.Shapes.Range(Array(1, theReport.Shapes.Count))

Чтобы создать объект ShapeRange с одним элементом коллекции Shapes , можно использовать следующие операторы:To create a ShapeRange object with a single member of the Shapes collection, you can use statements such as the following:

Set myRange3 = theReport.Shapes.Range(2)
Set myRange4 = theReport.Shapes.Range("Rectangle 2")

Чтобы выполнить операцию над одной фигурой в коллекции ShapeRange , можно использовать следующие операторы:To perform an operation on a single shape in a ShapeRange collection, you can use statements such as the following:

myRange1(2).Fill.ForeColor.RGB = RGB(120, 120, 80)
myRange1("Textbox 2").Fill.ForeColor.RGB = RGB(120, 120, 80)

Кроме того, вы можете выполнить операцию непосредственно для объекта Shape , не используя диапазон фигур.Alternately, you can perform an operation directly on a Shape object, without using a shape range.

theReport.Shapes("Big rectangle").Fill.ForeColor.RGB = RGB(120, 120, 80)

MethodsMethods

ОписаниеDescription
Метод align не реализован в Project.The Align method is not implemented in Project.
Применяет форматирование к диапазону фигур, в котором сведения о форматировании были скопированы с помощью метода раскладки .Applies formatting to a shape range, where the formatting information has been copied by using the PickUp method.
Копирует диапазон фигуры в буфер обмена.Copies the shape range to the Clipboard.
Вырезает диапазон фигуры в буфер обмена.Cuts the shape range to the Clipboard.
Удаляет диапазон фигуры.Deletes the shape range.
Метод распределения не реализован в Project.The Distribute method is not implemented in Project.
Дублирует диапазон фигуры и возвращает ссылку на копию.Duplicates a shape range and returns a reference to the copy.
Переворачивает каждую фигуру в диапазоне фигуры вокруг горизонтальной или вертикальной оси.Flips each shape in the shape range around its horizontal or vertical axis.
Метод Group не реализован в Project.The Group method is not implemented in Project.
Перемещает каждую фигуру в диапазоне фигуры в горизонтальном направлении на указанное количество точек.Moves each shape in the shape range horizontally by the specified number of points.
Поворачивает каждую фигуру в диапазоне фигуры вокруг оси z на заданное число градусов.Rotates each shape in the shape range around the z-axis by the specified number of degrees.
Перемещает каждую фигуру в диапазоне фигуры в вертикальном направлении на указанное количество точек.Moves each shape in the shape range vertically by the specified number of points.
Возвращает отдельный объект Shape в коллекции диапазонов фигур.Gets an individual Shape object in the shape range collection.
Метод мержешапес не реализован в Project.The MergeShapes method is not implemented in Project.
Копирует форматирование диапазона фигур.Copies the formatting of the shape range.
Метод REGROUP не реализован в Project.The Regroup method is not implemented in Project.
Метод рераутеконнектионс не реализован в Project.The RerouteConnections method is not implemented in Project.
Масштабирует высоту диапазона фигур по заданному коэффициенту.Scales the height of the range of shapes by a specified factor.
Масштабирует ширину диапазона фигур на заданный множитель.Scales the width of the range of shapes by a specified factor.
Выделяет каждую фигуру в диапазоне фигуры.Selects each shape in a shape range.
Применяет форматирование фигуры по умолчанию к каждой фигуре в диапазоне.Applies the formatting of a default shape to each shape in the range.
Метод Ungroup не реализован в Project.The Ungroup method is not implemented in Project.
Перемещает диапазон фигуры перед другими фигурами (то есть изменяет положение в z-порядке).Moves the shape range in front of or behind other shapes (that is, changes the position in the z-order).

СвойстваProperties

ИмяName
AdjustmentsAdjustments
AlternativeTextAlternativeText
ApplicationApplication
AutoShapeTypeAutoShapeType
BackgroundStyleBackgroundStyle
BlackWhiteModeBlackWhiteMode
CalloutCallout
ChartChart
ChildChild
ConnectionSiteCountConnectionSiteCount
ConnectorConnector
ConnectorFormatConnectorFormat
CountCount
FillFill
GlowGlow
GroupItemsGroupItems
HasChartHasChart
HasTableHasTable
HeightHeight
HorizontalFlipHorizontalFlip
IDID
LeftLeft
LineLine
LockAspectRatioLockAspectRatio
NameName
NodesNodes
ParentParent
ParentGroupParentGroup
ReflectionReflection
RotationRotation
ScriptScript
ShadowShadow
ShapeStyleShapeStyle
SoftEdgeSoftEdge
TableTable
TextEffectTextEffect
TextFrameTextFrame
TextFrame2TextFrame2
ThreeDThreeD
TitleTitle
TopTop
TypeType
ValueValue
VerticalFlipVerticalFlip
VerticesVertices
VisibleVisible
WidthWidth
ZOrderPositionZOrderPosition

См. такжеSee also

Объект ShapesShapes Object

Объект ShapeShape Object

Поддержка и обратная связьSupport and feedback

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи?Have questions or feedback about Office VBA or this documentation? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.