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

Представляет диапазон фигуры, который представляет собой набор фигур в документе.Represents a shape range, which is a set of shapes on a document. Диапазон фигуры может содержать как одну фигуру, так и столько же, сколько все фигуры в документе.A shape range can contain as few as one shape or as many as all the shapes in the document.

ПримечанияRemarks

Можно добавить любую нужную фигуру, выбранную из всех фигур в документе или всех фигур в выделенном фрагменте, для создания диапазона фигур.You can include whichever shapes you want—chosen from among all the shapes in 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 in a document, all the selected shapes in a document, or all the freeform shapes in a document. Большинство операций, которые можно выполнять с объектом 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 , содержащего несколько фигур, приведут к возникновению ошибки.Some operations, when performed on a ShapeRange object that contains more than one shape, will cause an error.

USE Range (index), где index — это имя или номер индекса фигуры или массива, содержащего имена или номера индексов фигур, чтобы возвратить коллекцию ShapeRange , представляющую набор фигур в документе.Use Range (index), where index is the name or index number of the shape or an array that contains either names or index numbers of shapes, to return a ShapeRange collection that represents a set of shapes on a document. Можно использовать функцию массивов Visual Basic, чтобы создать массив имен или номеров индексов.You can use Visual Basic's Array function to construct an array of names or index numbers. В приведенном ниже примере задается шаблон заливки для фигур 1 и 3 в активном документе.The following example sets the fill pattern for shapes one and three on the active document.

ActiveDocument.Shapes.Range(Array(1, 3)).Fill.Patterned _ 
 msoPatternHorizontalBrick

В приведенном ниже примере показано, как выделить фигуры с именем овал 4 и прямоугольник 5 в активном документе.The following example selects the shapes named Oval 4 and Rectangle 5 on the active document.

ActiveDocument.Shapes.Range(Array("Oval 4", "Rectangle 5")).Select

Несмотря на то, что вы можете использовать метод Range , чтобы возвратить любое количество фигур, проще использовать метод Item , если требуется возвратить только один элемент коллекции.Although you can use the Range method to return any number of shapes, it is simpler to use the Item method if you want to return only a single member of the collection. Например, проще Shapes(1) , чем Shapes.Range(1).For example, Shapes(1) is simpler than Shapes.Range(1).

Используйте ShapeRange (index), где index — это имя или номер индекса, чтобы возвратить объект Shape , представляющий фигуру в выделенном фрагменте.Use ShapeRange (index), where index is the name or the index number, to return a Shape object that represents a shape within a selection. В приведенном ниже примере задается заливка первой фигуры в выделенном фрагменте, предполагая, что выделенная область содержит по крайней мере одну фигуру.The following example sets the fill for the first shape in the selection, assuming that the selection contains at least one shape.

Selection.ShapeRange(1).Fill.ForeColor.RGB = RGB(255, 0, 0)

В этом примере показано, как выделить все фигуры в первом разделе активного документа.This example selects all the shapes in the first section of the active document.

Set myRange = ActiveDocument.Sections(1).Range 
myRange.ShapeRange.Select

Используйте метод align, распределитьили ZOrder , чтобы разместить набор фигур относительно друг друга или относительно документа.Use the Align, Distribute, or ZOrder method to position a set of shapes relative to each other or relative to the document.

Используйте метод Group, REGROUPили Ungroup для создания одиночной фигуры, созданной на основе диапазона фигур, и работы с ней.Use the Group, Regroup, or UnGroup method to create and work with a single shape formed from a shape range. Свойство граупитемс объекта Shape возвращает объект GroupShapes , который представляет все фигуры, сгруппированные в форму одной фигуры.The GroupItems property for a Shape object returns the GroupShapes object, which represents all the shapes that were grouped to form one shape.

При записи фигур средство записи всегда использует свойство ShapeRange .The recorder always uses the ShapeRange property when recording shapes.

Примечание

Объект ShapeRange не содержит объектов InlineShape .A ShapeRange object doesn't include InlineShape objects.

МетодыMethods

СвойстваProperties

См. такжеSee also

Поддержка и обратная связь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.