Objeto ShapeRange (Excel)ShapeRange object (Excel)

Representa un rango de formas, que es un conjunto de formas en un documento.Represents a shape range, which is a set of shapes on a document.

NotasRemarks

Un intervalo de formas puede estar compuesto por una única forma o por todas las formas del documento.A shape range can contain as few as a single shape or as many as all the shapes on the document. Puede incluir las formas que desee, elegidas entre todas las formas del documento o todas las formas de la selección, para construir un intervalo de formas.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. Por ejemplo, podría construir una colección ShapeRange que contenga las tres primeras formas en un documento, todas las formas seleccionadas o todas las formas libres de un documento.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.

EjemploExample

Devolución de un conjunto de formas especificadas por nombre o número de índiceReturning a Set of Shapes You Specify by Name or Index Number

Uso Shapes.Range( índice ), donde índice es el nombre o número de índice de la forma o una matriz que contiene los nombres o números de índice de formas, para devolver una colección ShapeRange que representa un conjunto de formas de un documento.Use Shapes.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. Puede usar la función Array para construir una matriz de nombres o números de índice.You can use the Array function to construct an array of names or index numbers. En el ejemplo siguiente se establece la trama de relleno para las formas uno y tres de myDocument.The following example sets the fill pattern for shapes one and three on myDocument.

Set myDocument = Worksheets(1) 
myDocument.Shapes.Range(Array(1, 3)).Fill.Patterned _ 
 msoPatternHorizontalBrick

En el ejemplo siguiente se establece la trama de relleno de las formas denominadas Oval 4 y Rectangle 5 de myDocument.The following example sets the fill pattern for the shapes named Oval 4 and Rectangle 5 on myDocument.

Aunque puede usar la propiedad Range para devolver cualquier número de formas o diapositivas, es más sencillo utilizar el método Item si desea devolver a sólo un miembro de la colección.Although you can use the Range property to return any number of shapes or slides, it's simpler to use the Item method if you want to return only a single member of the collection. Por ejemplo, Shapes(1) es más sencillo que Shapes.Range(1).For example, Shapes(1) is simpler than Shapes.Range(1).

Set myDocument = Worksheets(1) 
Set myRange = myDocument.Shapes.Range(Array("Oval 4", _ 
 "Rectangle 5")) 
myRange.Fill.Patterned msoPatternHorizontalBrick

Devolución de todas o de algunas de las formas seleccionadas en un documentoReturning All or Some of the Selected Shapes on a Document

Utilice la propiedad ShapeRange del objeto Selection para devolver todas las formas de la selección.Use the ShapeRange property of the Selection object to return all the shapes in the selection. El siguiente ejemplo se establece el primer plano del relleno de color de todas las formas de la selección en la ventana uno, suponiendo que haya 's al menos una forma en la selección.The following example sets the fill foreground color for all the shapes in the selection in window one, assuming that there's at least one shape in the selection.

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

Uso Selection.ShapeRange( índice ), donde index es el nombre de la forma o el número de índice, para devolver una sola forma dentro de la selección.Use Selection.ShapeRange( index ), where index is the shape name or the index number, to return a single shape within the selection. El siguiente ejemplo se establece el primer plano del relleno de color para la forma dos de la colección de formas seleccionadas en la ventana uno, suponiendo que haya al menos dos formas en la selección.The following example sets the fill foreground color for shape two in the collection of selected shapes in window one, assuming that there are at least two shapes in the selection.

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

MétodosMethods

NombreName
AlignAlign
ApplyApply
DeleteDelete
DistribuirDistribute
DuplicateDuplicate
FlipFlip
GroupGroup
IncrementLeftIncrementLeft
IncrementRotationIncrementRotation
IncrementTopIncrementTop
ElementoItem
PickUpPickUp
ReagruparRegroup
RerouteConnectionsRerouteConnections
ScaleHeightScaleHeight
ScaleWidthScaleWidth
SelectSelect
SetShapesDefaultPropertiesSetShapesDefaultProperties
UngroupUngroup
ZOrderZOrder

PropiedadesProperties

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

Vea tambiénSee also

Referencia del modelo de objetos de ExcelExcel Object Model Reference