Clase Shape - un objeto de la capa de dibujo (Word VBA)

La clase Shape representa un objeto de la capa de dibujo, como una autoforma, una forma libre, un objeto OLE, un control ActiveX o una imagen.

Las siguientes clases dan acceso a la clase Shape

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

Dim shp as Shape
Set shp = ActiveDocument.Background
Los siguientes procedimientos se pueden usar para establecer variables de clase Shape : CanvasShapes.AddCallout, CanvasShapes.AddConnector, CanvasShapes.AddCurve, CanvasShapes.AddLabel, CanvasShapes.AddLine, CanvasShapes.AddPicture, CanvasShapes.AddPolyline, CanvasShapes.AddShape, CanvasShapes.AddTextbox, CanvasShapes.AddTextEffect, CanvasShapes.Item, Document.Background, FreeformBuilder.ConvertToShape, GroupShapes.Item ...Hyperlink.Shape, InlineShape.ConvertToShape, Duplicate, ParentGroup, ShapeRange.Group, ShapeRange.Item, ShapeRange.ParentGroup, Shapes.Add3DModel, Shapes.AddCallout, Shapes.AddCanvas, Shapes.AddChart2, Shapes.AddCurve, Shapes.AddLabel, Shapes.AddLine, Shapes.AddOLEControl, Shapes.AddOLEObject, Shapes.AddPicture, Shapes.AddPolyline, Shapes.AddShape, Shapes.AddSmartArt, Shapes.AddTextbox, Shapes.AddTextEffect, Shapes.AddWebVideo, Shapes.Item, TextFrame.Parent, Window.RangeFromPoint.

For Each

A continuación, se muestra un ejemplo de cómo procesar los elementos Shape en una colección.

Dim shpCanvasItem As Shape
For Each shpCanvasItem In CanvasItems
	
Next shpCanvasItem

Métodos

Apply - Se aplica a la forma especificada el formato que se ha copiado mediante el método PickUp.

CanvasCropBottom - Recorta un porcentaje del alto de un lienzo de dibujo desde la parte inferior del lienzo.

CanvasCropLeft - Recorta un porcentaje del ancho de un lienzo de dibujo desde el lado izquierdo del lienzo.

CanvasCropRight - Recorta un porcentaje del ancho de un lienzo de dibujo desde el lado derecho del lienzo.

CanvasCropTop - Recorta un porcentaje del alto de un lienzo de dibujo desde la parte superior del lienzo.

ConvertToInlineShape - Convierte la forma especificada en la capa de dibujo de un documento en una forma integrada en la capa de texto.

Delete - Elimina el nodo de forma especificado.

Duplicate - Crea un duplicado del objeto Shape especificado, agrega la nueva forma a la colección Shapes con un desplazamiento estándar de las formas originales y, a continuación, devuelve el nuevo objeto Shape .

Flip - Voltea una forma horizontal o verticalmente.

IncrementLeft - Mueve la forma horizontalmente el número de puntos especificado.

IncrementRotation - Cambia el giro de la forma alrededor del eje Z el número especificado de grados.

IncrementTop - Mueve la forma verticalmente el número de puntos especificado.

PickUp - Copia el formato de la forma especificada.

ScaleHeight - Ajusta el alto de la forma según un factor especificado.

ScaleWidth - Ajusta el ancho de la forma según un factor especificado.

Select - Selecciona la forma especificada.

SetShapesDefaultProperties - expresión. SetShapesDefaultProperties

Ungroup - Desagrupa las formas agrupadas en la forma especificada.

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 de todos los ajustes del objeto Shape especificado que representa una Autoforma o WordArt.

AlternativeText Devuelve o establece el texto alternativo asociado con una forma en una página web.

Anchor Devuelve un objeto Range que representa el intervalo de fijación de la forma especificada o intervalo de formas.

AutoShapeType Devuelve o establece el tipo de forma para el objeto Shape especificado, que debe representar una autoforma que no sea una línea o dibujo de forma libre.

BackgroundStyle Establece o devuelve el estilo de fondo de la forma especificada.

Callout Devuelve un objeto CalloutFormat que contiene las propiedades del formato de llamada de la forma especificada.

CanvasItems Devuelve un objeto CanvasShapes que representa una colección de formas en un lienzo de dibujo.

Chart Devuelve un objeto Chart que representa un gráfico dentro de la colección de formas de un documento.

Child True si la forma es una forma secundaria o si todas las formas en un intervalo de formas son formas secundarias de la misma forma primaria.

Decorative Establece o devuelve la marca decorativa del objeto especificado.

Fill Devuelve un objeto FillFormat que contiene las propiedades de formato de relleno de la forma especificada.

Glow Devuelve un objeto GlowFormat que muestra el formato iluminado de una forma.

GraphicStyle Devuelve o establece una constante MsoGraphicStyleIndex que representa el estilo de un gráfico SVG.

GroupItems Devuelve un objeto GroupShapes que representa las formas individuales del grupo especificado.

HasChart True si la forma especificada tiene un gráfico.

HasSmartArt Devuelve true si hay un diagrama de SmartArt presente en la forma.

Height Devuelve o establece el alto (en puntos) de la forma especificada.

HeightRelative Devuelve o establece un valor Single que representa el porcentaje del alto relativo de una forma.

HorizontalFlip Indica que una forma se ha volteado horizontalmente.

Hyperlink Devuelve un objeto HYPERLINK que representa el hipervínculo asociado a un objeto Shape .

ID Devuelve el tipo de identificación de la forma especificada.

LayoutInCell Devuelve un Long que indica si una forma de una tabla se muestra dentro o fuera de la tabla.

Left Devuelve o establece un valor Single que representa la posición horizontal, medida en puntos, de la forma especificada o intervalo de formas.

LeftRelative Devuelve o establece un valor Single que representa la posición izquierda relativa de una forma.

Line Devuelve un objeto LineFormat que contiene las propiedades de formato de línea de la forma especificada.

LinkFormat Devuelve un objeto LinkFormat que representa las opciones de vínculo de una forma que está vinculada a un archivo.

LockAnchor True si el delimitador de un objeto Shape está bloqueado para el intervalo de delimitación.

LockAspectRatio MsoTrue si la forma especificada mantiene sus proporciones originales cuando se cambia el tamaño.

Model3D Devuelve un objeto Model3DFormat que contiene propiedades Model3D.

Name Devuelve o establece el nombre del objeto especificado.

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

OLEFormat Devuelve un objeto OLEFormat que representa las características OLE, excepto la de vinculación, de la forma, la forma entre líneas o el campo especificado.

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 formato de imagen para el objeto especificado.

Reflection Devuelve un objeto ReflectionFormat que representa el formato de reflejo de una forma.

RelativeHorizontalPosition Especifica la posición horizontal relativa de una forma.

RelativeHorizontalSize Devuelve o establece una constante WdRelativeVerticalSize que representa el objeto respecto al que es relativo un intervalo de formas.

RelativeVerticalPosition Especifica la posición vertical relativa de una forma.

RelativeVerticalSize Devuelve o establece una constante WdRelativeVerticalSize que representa el tamaño vertical relativo de una forma.

Rotation Devuelve o establece el número de grados que gira la forma especificada alrededor del eje z.

Script Devuelve un objeto script , que representa un bloque de secuencias de comandos o código para una imagen en una página web.

Shadow Devuelve un objeto ShadowFormat que representa el formato de sombreado de la forma especificada.

ShapeStyle Devuelve o establece el estilo de forma de la forma especificada.

SmartArt Devuelve un objeto SmartArt que proporciona una forma de trabajar con el SmartArt asociado a la forma especificada.

SoftEdge Devuelve un objeto SoftEdgeFormat que representa el formato de borde suave de una forma.

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

TextFrame Devuelve un objeto TextFrame que contiene el texto de la forma especificada.

TextFrame2 Devuelve un objeto TextFrame2 que contiene el texto de la forma especificada.

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

Title Devuelve o establece una cadena que contiene un título para la forma especificada.

Top Devuelve o establece la posición vertical de la forma especificada o intervalo de formas en puntos.

TopRelative Devuelve o establece un valor Single que representa la posición superior relativa de una forma.

Type Devuelve el tipo de forma entre líneas.

VerticalFlip True si la forma especificada está volteada alrededor del eje vertical.

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.

Visible True si el objeto especificado o el formato aplicado, está visible.

Width Devuelve o establece el ancho, en puntos, de la forma especificada.

WidthRelative Devuelve o establece un valor Single que representa el ancho relativo de una forma.

WrapFormat Devuelve un objeto WrapFormat que contiene las propiedades de ajuste de texto alrededor de la forma especificada.

ZOrderPosition Devuelve un Long que representa la posición de la forma especificada en el orden z.

Adjustments - Contiene una colección de valores de ajuste para el objeto de Autoforma o WordArt especificado.

CalloutFormat - Contiene las propiedades y métodos que se aplican a llamadas de línea.

CanvasShapes - Utilice la propiedad CanvasItems de un objeto Shape o ShapeRange para devolver una colección CanvasShapes .

Chart - Representa un gráfico en un documento.

FillFormat - Representa el formato de relleno de una forma.

GlowFormat - Representa el formato de iluminado de una forma o un intervalo de formas.

GroupShapes - Representa las formas individuales de una forma agrupada.

Hyperlink - Representa un hipervínculo.

InlineShape - Representa un objeto en la capa de texto de un documento.

LineFormat - Representa la línea y el formato de la punta de flecha.

LinkFormat - Representa las características de vinculación de un objeto OLE o una imagen.

Model3DFormat - Representa las propiedades de una forma de modelo 3D.

OLEFormat - Representa las características OLE, excepto las de vinculación, de un campo, control ActiveX u objeto OLE.

PictureFormat - Contiene propiedades y métodos que se aplican a imágenes y objetos OLE.

Range - Representa un área contigua en un documento.

ReflectionFormat - Representa el formato de reflejo de una forma o un intervalo de formas.

ShadowFormat - Representa el formato de sombreado de una forma.

ShapeNodes - Una colección de todos los ShapeNode objetos en la forma libre.

ShapeRange - Representa un intervalo de formas, que es un conjunto de formas de un documento.

SoftEdgeFormat - Representa el formato de borde suave de una forma o un intervalo de formas.

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 .

ThreeDFormat - Representa el formato tridimensional de una forma.

WrapFormat - Representa todas las propiedades de ajuste de texto alrededor de una forma o de un intervalo de formas.