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

• 06/08/2017
• Чтение занимает 3 мин
• • 

Представляет диапазон фигуры, представляющий собой коллекцию из одной или нескольких фигур в отчете.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

СвойстваProperties

См. также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.