Clase Shape - un objeto de la capa de dibujo (Excel VBA)
La clase Shape representa un objeto de la capa de dibujo, como una autoforma, una forma libre, un objeto OLE o una imagen.
Las siguientes clases dan acceso a la clase Shape
For Each
A continuación, se muestra un ejemplo de cómo procesar los elementos Shape en una colección.
For Each s In Worksheets(1).Shapes
If s.HorizontalFlip Then s.Flip msoFlipHorizontal
If s.VerticalFlip Then s.Flip msoFlipVertical
Next
Métodos
Apply - expresión. Aplicar
Copy - Copia el objeto en el Portapapeles.
CopyPicture - Copia el objeto seleccionado en el Portapapeles, en forma de imagen.
Cut - Corta el objeto y lo copia en el Portapapeles.
Delete - Elimina el objeto.
Duplicate - Duplica el objeto y devuelve una referencia a la nueva copia.
Flip - Voltea la forma especificada alrededor de su eje horizontal o vertical.
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.
PickUp - Copia el formato de la forma especificada. Utilice el método Apply para aplicar el formato copiado a otra forma.
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 Shape que representa una autoforma, WordArt o conector.
AlternativeText Devuelve o establece la cadena de texto descriptivo (alternativa) para un objeto Shape cuando el objeto se guarda en una página web. String de lectura y escritura.
AutoShapeType Devuelve o establece el tipo de forma de los objetos Shape o ShapeRange especificados, que deben representar una autoforma diferente de 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.
BottomRightCell Devuelve un objeto Range que representa la celda que se encuentra debajo de la esquina inferior derecha del objeto. Solo lectura.
Callout Se aplica a un objeto Shape que representa llamadas de línea. Solo lectura.
Chart Devuelve un objeto Chart que representa el gráfico contenido en la forma. 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 un objeto Shape que representa conectores. Solo lectura.
ControlFormat Devuelve un objeto ControlFormat que contiene las propiedades de un control de Microsoft Excel. Solo lectura.
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.
FormControlType Devuelve el tipo de control de Microsoft Excel. XlFormControl de solo lectura.
Glow Devuelve un objeto GlowFormat para una forma especificada que contiene propiedades de formato con resplandor para la forma. Solo lectura.
GraphicStyle Devuelve o establece una constante MsoGraphicStyleIndex que representa el estilo de un gráfico 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 Shape que representan formas agrupadas. Solo lectura.
HasChart Devuelve si una forma contiene un gráfico. MsoTriState de sólo lectura.
HasSmartArt Devuelve si hay un diagrama SmartArt presente en la forma especificada. Solo 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.
Hyperlink Devuelve un objeto HYPERLINK que representa el hipervínculo de la forma.
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.
LinkFormat Devuelve un objeto LinkFormat que contiene las propiedades de un objeto OLE vinculado. 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.
Locked Devuelve o establece un valor de tipo Boolean que indica si el objeto está bloqueado.
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.
OLEFormat Devuelve un objeto OLEFormat que contiene las propiedades de un objeto OLE. Solo lectura.
OnAction Devuelve o establece el nombre de una macro que se ejecuta cuando se elige el objeto especificado. String de lectura y escritura.
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 Shape que representa imágenes u objetos OLE. Solo lectura.
Placement Devuelve o establece un valor XlPlacement que representa la manera en que el objeto se adjunta a las celdas que están debajo de él.
Reflection Devuelve un objeto ReflectionFormat para una forma especificada que contiene las propiedades de formato de reflejo de la forma. 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.
SmartArt Devuelve un objeto Object que representa el SmartArt asociado con la forma. Solo lectura.
SoftEdge Devuelve un objeto SoftEdgeFormat para una forma especificada que contiene propiedades de formato de borde suave para la forma. 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 el formato de texto de la forma especificada. 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 a la forma especificada. 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.
TopLeftCell Devuelve un objeto Range que representa la celda que se encuentra debajo de la esquina superior izquierda del objeto especificado. Solo lectura.
Type Devuelve o establece 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.
Related Classes
Adjustments - Contiene una colección de valores de ajuste para la autoforma, el objeto de WordArt o el conector especificados.
CalloutFormat - Contiene las propiedades y métodos que se aplican a llamadas de línea.
Chart - Representa un gráfico en un libro.
ConnectorFormat - Contiene propiedades y métodos aplicables a conectores.
ControlFormat - Contiene las propiedades de un control de Microsoft Excel.
FillFormat - Representa el formato de relleno de una forma.
GroupShapes - Representa las formas individuales de una forma agrupada.
Hyperlink - Representa un hipervínculo.
LineFormat - Representa el formato de línea y de punta de flecha.
LinkFormat - Contiene las propiedades de un objeto OLE vinculado.
Model3DFormat - Representa las propiedades de una forma de modelo 3D.
OLEFormat - Contiene las propiedades de un objeto OLE.
PictureFormat - Contiene las propiedades y métodos que se aplican a imágenes y objetos OLE.
Range - Representa una celda, una fila, una columna, una selección de celdas que contienen uno o más bloques de celdas contiguos o un rango 3D.
ShadowFormat - Representa el formato de sombreado de una forma.
ShapeNodes - Colección de todos los objetos ShapeNode de especificado forma libre.
ShapeRange - Representa un rango de formas, que es un conjunto de formas en un documento.
TextEffectFormat - Contiene las propiedades y los métodos que se aplican a los objetos de WordArt.
TextFrame - Representa el marco de texto en un objeto Shape.
TextFrame2 - Representa el marco de texto de un objeto Shape, ShapeRange o ChartFormat .
ThreeDFormat - Representa el formato tridimensional de una forma.