Clase ShapeRange - un rango de formas (Excel VBA)

La clase ShapeRange representa un rango de formas, que es un conjunto de formas en un documento.

Las siguientes clases dan acceso a la clase ShapeRange

Para usar una variable de clase ShapeRange, primero debe ser instanciado, por ejemplo

Dim sre as ShapeRange
Set sre = Application.ActiveChart.OLEObjects

Los siguientes procedimientos se pueden usar para establecer variables de clase ShapeRange : ChartObject.ShapeRange, ChartObjects.ShapeRange, GroupShapes.Range, OLEObject.ShapeRange, OLEObjects.ShapeRange, Shape.Ungroup, Duplicate, Ungroup y Shapes.Range.

Métodos

Align - Alinea las formas del intervalo especificado.

Apply - expresión. Aplicar

Delete - Elimina el objeto.

Distribute - Distribuye horizontal o verticalmente las formas del rango de formas especificado.

Duplicate - Duplica el objeto y devuelve una referencia a la nueva copia.

Flip - Voltea la forma especificada alrededor de su eje horizontal o vertical.

Group - Agrupa las formas del rango especificado.

IncrementLeft - Mueve horizontalmente la forma especificada el número de puntosespecificado.

IncrementRotation - Cambia el giro de la forma alrededor del eje Z el número especificado de grados. Utilice la propiedad Rotation para establecer el giro absoluto de la forma.

IncrementTop - Mueve verticalmente la forma especificada el número de puntosespecificado.

Item - Devuelve un solo objeto de una colección.

PickUp - Copia el formato de la forma especificada. Utilice el método Apply para aplicar el formato copiado a otra forma.

Regroup - Vuelve a agrupar el grupo al que pertenecía anteriormente el intervalo de formas especificado. Devuelve las formas reagrupadas como un único objeto Shape .

RerouteConnections - Este método redistribuye todos los conectores adjuntos a la forma especificada; Si la forma especificada es un conector, se vuelve a redistribuir.

ScaleHeight - Cambia el alto de la forma en un factor especificado. Para imágenes y objetos OLE, se puede indicar si se desea cambiar el tamaño de la forma con relación al original o al tamaño actual. El tamaño de las formas que no son imágenes y objetos OLE siempre se cambia con relación al alto actual.

ScaleWidth - Cambia el ancho de la forma en un factor especificado. Para imágenes y objetos OLE, se puede indicar si se desea cambiar el tamaño de la forma con relación al original o al tamaño actual. El tamaño de las formas que no son imágenes y objetos OLE siempre se cambia con relación al ancho actual.

Select - Selecciona el objeto.

SetShapesDefaultProperties - Convierte el formato de la forma especificada en el formato predeterminado de la forma.

Ungroup - Desagrupa las formas agrupadas en la forma especificada o intervalo de formas. Separa las imágenes y objetos OLE de la forma o rango especificados.

ZOrder - Desplaza la forma especificada delante o detrás de otras formas del conjunto (es decir, cambia la posición de la forma en el orden z).

Propiedades

Adjustments Devuelve un objeto Adjustments que contiene los valores de ajuste para todos los ajustes de la forma especificada. Se aplica a cualquier objeto ShapeRange que representa una autoforma, WordArt o conector.

AlternativeText Devuelve o establece la cadena de texto descriptivo (alternativa) para un objeto ShapeRange cuando el objeto se guarda en una página web. String de lectura y escritura.

AutoShapeType Devuelve o establece el tipo de forma para el objeto Shape o ShapeRange especificado, que debe representar una autoforma que no sea una línea, un dibujo de forma libre o un conector. MsoAutoShapeType de lectura y escritura.

BackgroundStyle Devuelve o establece el estilo del fondo. MsoBackgroundStyleIndex de lectura y escritura.

BlackWhiteMode Devuelve o establece un valor que indica cómo aparece la forma especificada cuando la presentación se visualiza en modo blanco y negro. MsoBlackWhiteMode de lectura y escritura.

Callout Se aplica a los objetos ShapeRange que representan llamadas de línea. Solo lectura.

Chart Devuelve un objeto Chart que representa el gráfico contenido en el intervalo de formas. Solo lectura.

Child Devuelve msoTrue si la forma especificada es una forma secundaria o si todas las formas del rango de formas son secundarias de la misma forma primaria. Devuelve msoFalse si la forma seleccionada no es una forma secundaria. Devuelve msoTriStateMixed si sólo algunas de las formas seleccionadas son formas secundarias. MsoTriState de sólo lectura.

ConnectionSiteCount Devuelve el número de sitios de conexión de la forma especificada. Long de sólo lectura.

Connector Es True si la forma especificada es un conector. MsoTriState de sólo lectura.

ConnectorFormat Devuelve un objeto ConnectorFormat que contiene propiedades de formato del conector. Se aplica a los objetos ShapeRange que representan conectores. Solo lectura.

Count Devuelve un valor Long que representa el número de objetos de la colección.

Decorative Establece o devuelve la marca decorativa del objeto especificado. Lectura y escritura.

Fill Devuelve un objeto FillFormat para una forma especificada o un objeto ChartFillFormat de un gráfico especificado que contiene las propiedades de formato de relleno de la forma o del gráfico. Solo lectura.

Glow Devuelve un objeto GlowFormat para un rango de formas especificado que contiene propiedades de formato con resplandor para el intervalo de formas. Solo lectura.

GraphicStyle Devuelve o establece una constante MsoGraphicStyleIndex que representa el estilo de un intervalo de formas que contiene uno o varios gráficos SVG. Lectura y escritura.

GroupItems Utilice el método Item del objeto GroupShapes para devolver una única forma del grupo. Se aplica a los objetos ShapeRange que representan formas agrupadas. Solo lectura.

HasChart Devuelve si un rango de forma contiene un gráfico. MsoTriState de sólo lectura.

Height Devuelve o establece un valor de tipo Single que representa el alto, en puntos, del objeto.

HorizontalFlip Es True si la forma especificada se voltea alrededor del eje horizontal. MsoTriState de sólo lectura.

ID Devuelve un valor de tipo Long que representa el tipo del objeto especificado.

Left Devuelve o establece un valor de tipo Single que representa la distancia, en puntos, desde el borde izquierdo del objeto al borde izquierdo de la columna a (en una hoja de cálculo) o al borde izquierdo del área del gráfico (en un gráfico).

Line Devuelve un objeto LineFormat que contiene las propiedades de la forma especificada el formato de línea. (Para una línea, el objeto LineFormat representa la línea en sí; para una forma con borde, el objeto LineFormat representa el borde). Solo lectura.

LockAspectRatio Es True si la forma especificada mantiene sus proporciones originales al ajustar su tamaño. Es False si el alto y el ancho de la forma se pueden cambiar independientemente al ajustar su tamaño. MsoTriState de lectura y escritura.

Model3D Devuelve un objeto Model3DFormat que contiene propiedades Model3D. Solo lectura.

Name Devuelve o establece un valor de tipo String que representa el nombre del objeto.

Nodes Devuelve una colección ShapeNodes que representa la descripción geométrica de la forma especificada.

ParentGroup Devuelve un objeto Shape que representa la forma primaria común de una forma secundaria o un intervalo de formas secundarias.

PictureFormat Devuelve un objeto PictureFormat que contiene las propiedades de la forma especificada el formato de imagen. Se aplica a un objeto ShapeRange que representa imágenes u objetos OLE. Solo lectura.

Reflection Devuelve un objeto ReflectionFormat para un intervalo de formas especificado que contiene las propiedades de formato de reflejo del intervalo de formas. Solo lectura.

Rotation Devuelve o establece el giro de la forma, en grados. Single de lectura y escritura.

Shadow Devuelve un objeto ShadowFormat de sólo lectura que contiene las propiedades de formato de sombra de la forma o formas especificadas.

ShapeStyle Devuelve o establece un valor de MsoShapeStyleIndex que representa el estilo de forma del intervalo de formas. Lectura y escritura.

SoftEdge Devuelve un objeto SoftEdgeFormat para un intervalo de formas especificado que contiene las propiedades de formato de borde suave del intervalo de formas. Solo lectura.

TextEffect Devuelve un objeto TextEffectFormat que contiene propiedades de formato de efecto de texto de la forma especificada. Solo lectura.

TextFrame Devuelve un objeto TextFrame que contiene las propiedades de alineación y delimitación de la forma especificada. Solo lectura.

TextFrame2 Devuelve un objeto TextFrame2 que contiene formato de texto para el intervalo de formas especificado. Solo lectura.

ThreeD Devuelve un objeto ThreeDFormat que contiene las propiedades de formato de efecto 3D de la forma especificada. Solo lectura.

Title Devuelve o establece el título del texto alternativo asociado con el intervalo de formas especificado. Lectura y escritura.

Top Devuelve o establece un valor de tipo Single que representa la distancia, en puntos, desde el borde superior de la forma superior del rango de formas hasta el borde superior de la hoja de cálculo.

Type Devuelve un valor MsoShapeType que representa el tipo de forma.

VerticalFlip True si la forma especificada está volteada alrededor del eje vertical. MsoTriState de sólo lectura.

Vertices Devuelve las coordenadas de los vértices del dibujo de forma libre especificado, y los puntos de control de las curvas Bézier, como una serie de pares de coordenadas. Puede usar la matriz devuelta por esta propiedad como un argumento para el método AddCurve o AddPolyLine . Variant de solo lectura.

Visible Devuelve o establece un valor MsoTriState que determina si el objeto es visible. Lectura y escritura.

Width Devuelve o establece un valor de tipo Single que representa el ancho, en puntos, del objeto.

ZOrderPosition Devuelve la posición de la forma especificada en el orden Z. Long de sólo lectura.