Clase Shape - un objeto de la capa de dibujo (PowerPoint 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

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

Dim shp as Shape
Set shp = Dim lngX As Long: lngX = 
Dim lngY As Long: lngY = 
ActiveWindow.RangeFromPoint(X:=lngX, Y:=lngY)
Los siguientes procedimientos se pueden usar para establecer variables de clase Shape : Cell.Shape, ConnectorFormat.BeginConnectedShape, ConnectorFormat.EndConnectedShape, DocumentWindow.RangeFromPoint, Effect.Shape, FreeformBuilder.ConvertToShape, GroupShapes.Item, Placeholders.FindByName, Placeholders.Item, Presentation.DefaultShape, ResampleMediaTask.Shape, ParentGroup, ShapeRange.Group, ShapeRange.Item ...ShapeRange.ParentGroup, ShapeRange.Regroup, Shapes.Add3DModel, Shapes.AddCallout, Shapes.AddChart2, Shapes.AddConnector, Shapes.AddCurve, Shapes.AddInkShapeFromXML, Shapes.AddLabel, Shapes.AddLine, Shapes.AddMediaObject2, Shapes.AddMediaObjectFromEmbedTag, Shapes.AddOLEObject, Shapes.AddPicture, Shapes.AddPicture2, Shapes.AddPlaceholder, Shapes.AddPolyline, Shapes.AddShape, Shapes.AddSmartArt, Shapes.AddTable, Shapes.AddTextbox, Shapes.AddTextEffect, Shapes.AddTitle, Shapes.Item, Shapes.Title, Timing.TriggerShape.

Métodos

Apply - expresión. Aplicar

ApplyAnimation - Aplica la última animación recogida al objeto Shape .

ConvertTextToSmartArt - Convierte texto en un objeto Shape en un diagrama de SmartArt.

Copy - Copia el objeto especificado en el Portapapeles.

Cut - Elimina el objeto especificado y lo coloca en el Portapapeles.

Delete - Elimina el objeto Shape especificado.

Duplicate - Crea un duplicado del objeto Shape especificado, agrega la nueva forma a la colección Shapes y, a continuación, devuelve un nuevo objeto ShapeRange . Los objetos duplicados se colocan al final de la colección Shapes.

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

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. Utilice la propiedad Rotation para establecer el giro absoluto de la forma.

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

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

PickupAnimation - Selecciona todas las animaciones del objeto Shape .

RerouteConnections - Redistribuye los conectores para que tomen la ruta más corta posible entre las formas que conectan. Para ello, el método RerouteConnections puede separar los finales de un conector y volver a conectarlos a sitios de conexión diferentes en las formas conectadas.

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

ScaleWidth - Cambia la escala del ancho de la forma según un factor especificado. Para imágenes y objetos OLE, puede indicar si desea cambiar la escala de la forma respecto al tamaño original o respecto al tamaño actual. La escala de las formas que no son imágenes y objetos OLE siempre se cambia respecto a su ancho actual.

Select - Selecciona el objeto especificado.

SetShapesDefaultProperties - Aplica el formato de la forma especificada a la forma predeterminada. Las formas creadas con este método tendrán aplicado este formato de manera predeterminada.

Ungroup - Desagrupa las formas agrupadas en la forma especificada o intervalo de formas. Separa las imágenes y objetos OLE dentro de la forma especificada o intervalo de formas. Devuelve las formas desagrupadas como un solo objeto ShapeRange .

UpgradeMedia - Convierte un objeto multimedia heredado en un objeto multimedia actualizado.

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

ActionSettings Devuelve un objeto ActionSettings que contiene información acerca de qué acción se produce cuando el usuario hace clic o mueve el mouse sobre el intervalo de texto o forma especificado durante una presentación con diapositivas. Solo lectura.

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. Solo lectura.

AlternativeText Devuelve o establece el texto alternativo asociado a una forma en una presentación web. Lectura y escritura.

AnimationSettings Devuelve un objeto AnimationSettings que representa todos los efectos especiales que se pueden aplicar a la animación de la forma especificada. Solo lectura.

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

BackgroundStyle Establece o devuelve el estilo de fondo del objeto especificado. 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. Lectura y escritura.

Callout Devuelve un objeto CalloutFormat que contiene las propiedades de la forma especificada el formato de la llamada. Se aplica a los objetos Shape o ShapeRange que representan llamadas de línea. Solo lectura.

Chart Devuelve un objeto Chart del actual objeto Shape. Solo lectura.

Child MsoTrue 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. Solo lectura.

ConnectionSiteCount Devuelve el número de sitios de conexión de la forma especificada. Solo lectura.

Connector Determina si la forma especificada es un conector. Solo lectura.

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

CustomerData Devuelve un objeto CustomerData. Solo lectura.

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

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

Glow Devuelve el formato de iluminado de la forma especificada. Solo lectura.

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

GroupItems Devuelve un objeto GroupShapes que representa las formas individuales del grupo especificado. Utilice el método Item del objeto GroupShapes para devolver una única forma del grupo. Solo lectura.

HasChart Devuelve si la forma representada por el objeto especificado contiene un gráfico. Solo lectura.

HasInkXML Devuelve un valor de enumeración MsoTriState que indica si la forma especificada contiene XML de entrada de lápiz que se pueda recuperar a través de la propiedad Shape.InkXML. Solo lectura.

HasSectionZoom

HasSmartArt Devuelve true si el objeto actual Shape contiene un diagrama de SmartArt. Solo lectura.

HasTable Devuelve si la forma especificada es un tabla. Solo lectura.

HasTextFrame Devuelve si la forma especificada tiene un marco de texto. Solo lectura.

Height Devuelve o establece el alto del objeto especificado en puntos. Lectura y escritura.

HorizontalFlip Devuelve si la forma especificada se voltea alrededor del eje horizontal. Solo lectura.

Id Devuelve un Long que identifica la forma o intervalo de formas. Solo lectura.

InkXML Devuelve una Cadena que contiene el InkActionML asociado a la forma especificada. Solo lectura.

IsNarration Especifica si el intervalo de formas especificado contiene una narración. Lectura y escritura.

Left Devuelve o establece un valor Single que representa la distancia en puntos desde el borde izquierdo del cuadro de límite de la forma hasta el borde izquierdo de la diapositiva. Lectura y escritura.

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.) Es de sólo lectura.

LinkFormat Devuelve un objeto LinkFormat que contiene las propiedades que son exclusivas de objetos OLE vinculados. Solo lectura.

LockAspectRatio Determina si la forma especificada mantiene sus proporciones originales al cambiar su tamaño. Lectura y escritura.

MediaFormat Permite el acceso al objeto de vídeo o audio nuevo. Solo lectura.

MediaType Devuelve el tipo de medio OLE. Solo lectura.

Model3D Devuelve un objeto Model3DFormat que representa las propiedades 3D de un objeto de modelo 3D. Solo lectura.

Name Cuando se crea una forma, Microsoft PowerPoint le asigna automáticamente un nombre con el formato TipoForma número, donde TipoForma identifica el tipo de forma o autoforma, y número es un entero que es único dentro de la colección de formas de la diapositiva. Por ejemplo, los nombres asignados automáticamente a las formas de una diapositiva pueden ser Marcador de posición 1, Elipse 2 y Rectángulo 3. Para evitar conflictos con los nombres asignados automáticamente, no use la nomenclatura tipoDeForma Número para los nombres definidos por el usuario, donde tipoDeForma es un valor usado para los nombres generados de forma automática y Número es cualquier número entero positivo. Un intervalo de formas debe contener exactamente una forma. Lectura y escritura.

Nodes Devuelve una colección ShapeNodes que representa la descripción geométrica de la forma especificada. Se aplica a objetos Shape que representan dibujos de forma libre.

OLEFormat Devuelve un objeto OLEFormat que contiene las propiedades de la forma especificada el formato de OLE. Se aplica a los objetos Shape o ShapeRange que representan objetos OLE. Solo lectura.

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. Solo lectura.

PlaceholderFormat Devuelve un objeto PlaceholderFormat que contiene las propiedades que son exclusivas de los marcadores de posición. Solo lectura.

Reflection Devuelve el formato de reflejo de la forma especificada. Solo lectura.

Rotation Devuelve o establece el número de grados en que se gira la forma especificada alrededor del eje Z. Lectura y escritura.

Shadow Devuelve un objeto ShadowFormat que contiene las propiedades de formato de sombra de la forma especificada. Solo lectura.

ShapeStyle Establece o devuelve el índice del estilo de forma para el objeto especificado. Lectura y escritura.

SmartArt Devuelve un objeto de Microsoft Office SmartArt que representa el diagrama de SmartArt del objeto Shape. Solo lectura.

SoftEdge Devuelve el formato de bordes suaves de la forma especificada. Solo lectura.

Table Devuelve un objeto Table que representa una tabla en una forma o en un intervalo de formas. Solo lectura.

Tags Devuelve un objeto Tags que representa las etiquetas para el objeto especificado. 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 la alineación y delimitación de propiedades para la forma especificada o el estilo de texto de patrón.

TextFrame2 Devuelve el objeto TextFrame2 asociado al objeto Shape especificado que contiene las propiedades de alineación y delimitación 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 un objeto Shape que representa el título de la diapositiva. Solo lectura.

Top Devuelve o establece un valor Single que representa la distancia desde el borde superior del cuadro de límite de la forma hasta el borde superior del documento. Lectura y escritura.

Type Representa el tipo de formas de un intervalo de formas. Solo lectura.

VerticalFlip Determina si la forma especificada se voltea alrededor del eje vertical. Solo lectura.

Vertices Devuelve las coordenadas de los vértices del dibujo de forma libre especificado (y los puntos de control para curvas de Bézier) como una serie de pares de coordenadas. Solo lectura.

Visible Devuelve o establece la visibilidad del objeto especificado o del formato aplicado al objeto especificado. Lectura y escritura.

Width Devuelve o establece el ancho del objeto especificado en puntos. Lectura y escritura.

ZOrderPosition Devuelve la posición de la forma especificada en el orden Z. Solo lectura.

ActionSettings - Una colección que contiene los dos objetos ActionSetting para una forma o un intervalo de texto. Un objeto ActionSetting representa cómo reacciona el objeto especificado cuando el usuario hace clic en él durante una presentación, y el otro objeto ActionSetting representa cómo reacciona el objeto especificado cuando el usuario mueve el puntero del mouse sobre él durante una presentación.

Adjustments - Contiene una colección de valores de ajuste para la autoforma, objeto de WordArt o conector especificados.

AnimationSettings - Representa los efectos especiales aplicados a la animación de la forma especificada durante una presentación con diapositivas.

CalloutFormat - Contiene propiedades y métodos que se pueden aplicar a llamadas con línea.

Chart - Representa un gráfico en una presentación.

ConnectorFormat - Contiene propiedades y métodos aplicables a conectores.

CustomerData - Almacena información sobre un cliente (como su nombre, dirección, número de teléfono, etc.) u otra información en formato XML, como una colección de objetos CustomXMLPart asociados a un objeto de Microsoft PowerPoint.

FillFormat - Representa el formato de relleno de una forma. Una forma puede tener un relleno sólido, degradado, de textura, de entramado, de imagen o semitransparente.

GroupShapes - Representa las formas individuales de una forma agrupada. Cada forma está representada por un objeto Shape. Si usa el método Itemcon este objeto, puede trabajar con formas individuales de un grupo sin tener que desagruparlas.

LineFormat - Representa la línea y el formato de la punta de flecha. Para una línea, el objeto LineFormat contiene información de formato de la línea en sí; para una forma con un borde, este objeto contiene información de formato del borde de la forma.

LinkFormat - Contiene propiedades y métodos que se pueden aplicar a objetos OLE vinculados, imágenes vinculadas y objetos multimedia IIRC.

MediaFormat - Contiene métodos y propiedades que permiten tener acceso a los medios de audio y video y controlarlos.

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

OLEFormat - Contiene propiedades y métodos que se pueden aplicar a objetos OLE.

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

PlaceholderFormat - Contiene propiedades específicas que se aplican a los marcadores de posición, como el tipo.

ShadowFormat - Representa el formato de sombreado de una forma.

ShapeNodes - Colección de todos los objetos ShapeNode de la forma libre especificada.

ShapeRange - Representa un intervalo de formas, es decir, un conjunto de formas de un documento. Un intervalo de formas puede estar compuesto por una única forma o por todas las formas del documento.

Table - Representa una forma de tabla en una diapositiva. El objeto Table es un miembro de la colección Shapes. El objeto Table contiene las columnas colección y las filas colección.

Tags - Representa una etiqueta o una propiedad personalizada que puede crearse para una forma, una diapositiva o una presentación.

TextEffectFormat - Contiene propiedades y métodos que se pueden aplicar a objetos de WordArt.

TextFrame - Representa el marco de texto en un objeto Shape. Contiene el texto en el marco de texto y las propiedades y métodos que controlan la alineación y la fijación del marco de texto.

TextFrame2 - Representa el marco de texto en un objeto Shape o ShapeRange. Contiene el texto del marco de texto y expone las propiedades y los métodos que controlan la alineación y la delimitación del marco de texto.

ThreeDFormat - Representa el formato tridimensional de una forma.