Shape Interfaz

Definición

Espacio de nombres:: Microsoft.Office.Interop.Excel

Ensamblado:: Microsoft.Office.Interop.Excel.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Representa un objeto de la capa de dibujo, como una autoforma, una forma libre, un objeto OLE o una imagen. El objeto Shape es un miembro de la Shapes colección. La colección Formas contiene todas las formas de una diapositiva.

public interface class Shape

[System.Runtime.InteropServices.Guid("00024439-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface Shape

Public Interface Shape

Atributos: GuidAttribute InterfaceTypeAttribute

Comentarios

Hay tres objetos que representan formas: la colección Formas , que representa todas las formas de un documento; la ShapeRange colección, que representa un subconjunto especificado de las formas de un documento (por ejemplo, un objeto ShapeRange podría representar las formas uno y cuatro del documento, o podría representar todas las formas seleccionadas en el documento); y el objeto Shape , que representa una sola forma de un documento. Si desea trabajar con varias formas al mismo tiempo o con formas dentro de la selección, use una colección ShapeRange.

En esta sección se describe cómo:

Devolver una forma existente.
Devolver una forma dentro de la selección.
Devolver las formas adjuntas a los extremos de un conector.
Devolver una forma libre recién creada.
Devolver una forma de un grupo.
Devolver un grupo de formas creado recientemente.

Devolución de una forma existente

Use Formas(index), donde index es el nombre de la forma o el número de índice, para devolver un objeto Shape que representa una forma.

Cada forma lleva asignado un nombre predeterminado cuando se agrega a la colección Shapes. Para darle a la forma un nombre más significativo, use la Name propiedad.

Devolución de una forma dentro de la selección

Use Selection.ShapeRange(index), donde index está el nombre de la forma o el número de índice, para devolver un objeto Shape que representa una forma dentro de la selección.

Devolución de las formas adjuntas a los extremos de un conector

Para devolver un objeto Shape que representa una de las formas unidas por un conector, use la BeginConnectedShape propiedad o EndConnectedShape .

Devolución de una forma libre recién creada

Use los BuildFreeform(MsoEditingType, Single, Single) métodos and AddNodes(MsoSegmentType, MsoEditingType, Single, Single, Object, Object, Object, Object) para definir la geometría de una nueva forma libre y use el ConvertToShape() método para crear la forma libre y devolver el objeto Shape que la representa.

Devolución de una sola forma desde dentro de un grupo

Use GroupItems(index), donde index es el nombre de la forma o el número de índice dentro del grupo, para devolver un objeto Shape que representa una sola forma en una forma agrupada.

Devolución de grupos de formas recién formados

Use el Group() método or Regroup() para agrupar un rango de formas y devolver un único objeto Shape que represente el grupo recién formado. Una vez creado un grupo, puede trabajar con el grupo de la misma manera que con cualquier otra forma.

Propiedades

Nombre	Description
Adjustments	Devuelve un Adjustments objeto que contiene valores de ajuste de todos los ajustes de la forma especificada. Solo lectura.
AlternativeText	Devuelve o establece la cadena de texto descriptiva (alternativa) de un Shape objeto cuando este se guarda en una página web. String de lectura y escritura.
Application	Devuelve un Application objeto que representa la aplicación de Microsoft Excel. Solo lectura.
AutoShapeType	Devuelve o establece el tipo de forma del objeto especificado Shape , que debe representar una autoforma que no sea una línea, un dibujo de forma libre o un conector. Lectura y escritura MsoAutoShapeType
BackgroundStyle	Devuelve o establece el estilo del fondo. 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 MsoBlackWhiteMode
BottomRightCell	Devuelve un Range objeto que representa la celda que se encuentra debajo de la esquina inferior derecha del objeto. Solo lectura.
Callout	Devuelve un CalloutFormat objeto que contiene propiedades de formato de llamada para la forma especificada. Se aplica a objetos que representan llamadas de Shape línea. Solo lectura.
CanvasItems	Reservado para uso interno.
Chart	Devuelve un objeto que representa lo _Chart contenido en el Shapearchivo . 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. Solo lectura MsoTriState
ConnectionSiteCount	Devuelve el número de sitios de conexión de la forma especificada. Integer de solo lectura.
Connector	Es True si la forma especificada es un conector. Solo lectura MsoTriState
ConnectorFormat	Devuelve un ConnectorFormat objeto que contiene propiedades de formato de conector. Se aplica a Shape objetos que representan conectores. Solo lectura.
ControlFormat	Devuelve un ControlFormat objeto que contiene propiedades de control de Microsoft Excel. Solo lectura.
Creator	Devuelve un entero de 32 bits que indica la aplicación con la que se creó el objeto. Si el objeto se creó en Microsoft Excel, la propiedad devuelve la cadena XCEL, que es el equivalente del número hexadecimal 5843454C. Solo lectura XlCreator
Diagram	Devuelve un Diagram objeto que representa un diagrama.
DiagramNode	Devuelve un DiagramNode objeto que representa un nodo de un diagrama.
DrawingObject	Reservado para uso interno.
Fill	Devuelve un FillFormat objeto que contiene propiedades de formato de relleno para el gráfico o la forma especificados. Solo lectura.
FormControlType	Devuelve el tipo de control de Microsoft Excel. Solo lectura XlFormControl
Glow	Devuelve un objeto de una forma especificada que contiene propiedades de formato de resplandor para esa forma. Solo lectura.
GroupItems	Devuelve un GroupShapes objeto que representa las formas individuales del grupo especificado. Use el Item(Object) método del objeto GroupShapes para devolver una sola forma del grupo. Se aplica a Shape objetos que representan formas agrupadas. Solo lectura.
HasChart	Devuelve información acerca de si contiene Shape un gráfico. Solo lectura.
HasDiagram	Devuelve si una forma o un rango de formas contiene un diagrama. Solo lectura MsoTriState
HasDiagramNode	Devuelve un valor que indica si existe un nodo de diagrama en una forma o en un rango de formas determinado. Solo lectura MsoTriState
HasSmartArt	Obtiene si hay un diagrama SmartArt presente en la forma especificada.
Height	La altura del objeto. Lectura y escritura único.
HorizontalFlip	Es True si la forma especificada se voltea alrededor del eje horizontal. Solo lectura MsoTriState
Hyperlink	Devuelve un Hyperlink objeto que representa el hipervínculo de la forma.
ID	Devuelve el tipo del objeto especificado. Integer de solo lectura.
Left	La distancia desde el borde izquierdo del objeto hasta el borde izquierdo de la columna A (en una hoja de cálculo) o el borde izquierdo del área del gráfico (en un gráfico). Lectura y escritura único.
Line	Devuelve un LineFormat objeto que contiene propiedades de formato de línea para la forma especificada. Solo lectura.
LinkFormat	Devuelve un LinkFormat objeto que contiene propiedades de objeto OLE vinculadas. 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. Lectura y escritura MsoTriState
Locked	Verdadero si el objeto está bloqueado, Falso si el objeto se puede modificar cuando la hoja está protegida. Boolean de lectura y escritura.
Name	Devuelve o establece el nombre del objeto. String de lectura y escritura.
Nodes	Devuelve una ShapeNodes colección que representa la descripción geométrica de la forma especificada. Se aplica a Shape objetos que representan dibujos de forma libre.
OLEFormat	Devuelve un OLEFormat objeto que contiene propiedades de objeto OLE. Solo lectura.
OnAction	Devuelve o establece el nombre de una macro que se ejecuta al hacer clic en el objeto especificado. String de lectura y escritura.
Parent	Devuelve el objeto primario del objeto especificado. Solo lectura.
ParentGroup	Devuelve un Shape objeto que representa la forma principal común de una forma secundaria o un rango de formas secundarias.
PictureFormat	Devuelve un PictureFormat objeto que contiene propiedades de formato de imagen para la forma especificada. Se aplica a Shape objetos que representan imágenes u objetos OLE. Solo lectura.
Placement	Devuelve o establece la forma en que el objeto se adjunta a las celdas situadas debajo de él. Lectura y escritura XlPlacement
Reflection	Devuelve un objeto que contiene propiedades de formato de reflexión para la forma. Solo lectura.
Rotation	Devuelve o establece el giro de la forma en grados. Lectura y escritura único.
Script	Devuelve el objeto Script, que representa un bloque de secuencias de comandos o código de la página Web especificada. Si la página no contiene secuencias de comandos, no se devuelve nada.
Shadow	Verdadero si el objeto tiene una sombra. Boolean de lectura y escritura.
ShapeStyle	Devuelve o establece una MsoShapeStyleIndex que representa el estilo de forma de la forma. Lectura y escritura.
SmartArt	Obtiene un objeto que representa el elemento gráfico SmartArt asociado a la forma.
SoftEdge	Devuelve un SoftEdgeFormat objeto de una forma especificada que contiene propiedades de formato de borde suave para la forma. Solo lectura.
TextEffect	Devuelve un TextEffectFormat objeto que contiene propiedades de formato de efecto de texto para la forma especificada. Se aplica a los objetos T:Microsoft.Office.Interop.Excel.Shape que representan WordArt. Solo lectura.
TextFrame	Devuelve un TextFrame objeto que contiene las propiedades de alineación y anclaje de la forma especificada. Solo lectura.
TextFrame2	Devuelve un objeto que contiene formato de texto para la forma especificada. Solo lectura.
ThreeD	Devuelve un ThreeDFormat objeto que contiene propiedades de formato de efecto 3D para la forma especificada. Solo lectura.
Title	Obtiene o establece el título del texto alternativo asociado a la forma especificada.
Top	Distancia desde el borde superior de la forma situada más arriba en el rango de formas hasta el borde superior de la hoja de cálculo. Lectura y escritura único.
TopLeftCell	Devuelve un Range objeto que representa la celda que se encuentra debajo de la esquina superior izquierda del objeto especificado. Solo lectura.
Type	Devuelve o establece el tipo de forma. Solo lectura MsoShapeType
VerticalFlip	True si la forma especificada está volteada alrededor del eje vertical. Solo lectura MsoTriState
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. Read-only objeto.
Visible	Determina si el objeto es visible. Lectura y escritura MsoTriState
Width	El ancho del objeto. Lectura y escritura único.
ZOrderPosition	Devuelve la posición de la forma especificada en el orden Z. Integer de solo lectura.

Métodos

Nombre	Description
Apply()	Se aplica al formato de forma especificado que se ha copiado con el PickUp() método.
CanvasCropBottom(Single)	Reservado para uso interno.
CanvasCropLeft(Single)	Reservado para uso interno.
CanvasCropRight(Single)	Reservado para uso interno.
CanvasCropTop(Single)	Reservado para uso interno.
Copy()	Copia el objeto al Portapapeles.
CopyPicture(Object, Object)	Copia el objeto seleccionado en el Portapapeles como una imagen.
Cut()	Corta el objeto y lo pega en el Portapapeles o en un destino especificado.
Delete()	Elimina el objeto.
Duplicate()	Duplica el objeto y devuelve una referencia a la nueva copia.
Flip(MsoFlipCmd)	Voltea la forma especificada alrededor de su eje horizontal o vertical.
IncrementLeft(Single)	Mueve la forma horizontalmente el número de puntos especificado.
IncrementRotation(Single)	Cambia el giro de la forma alrededor del eje Z el número especificado de grados. Use la Rotation propiedad para establecer el giro absoluto de la forma.
IncrementTop(Single)	Mueve la forma verticalmente el número de puntos especificado.
PickUp()	Copia el formato de la forma especificada. Use el Apply() método para aplicar el formato copiado a otra forma.
RerouteConnections()	Redistribuye los conectores para que tomen la ruta más corta posible entre las formas que conectan.
ScaleHeight(Single, MsoTriState, Object)	Cambia el alto de la forma en un factor especificado.
ScaleWidth(Single, MsoTriState, Object)	Cambia el ancho de la forma en un factor especificado.
Select(Object)	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. Desensambla imágenes y objetos OLE dentro de la forma especificada. Devuelve las formas no agrupadas como un único ShapeRange objeto.
ZOrder(MsoZOrderCmd)	Mueve la forma especificada delante o detrás de otras formas de la colección (es decir, cambia la posición de la forma en el orden z).

Se aplica a

Comentarios

¿Le ha resultado útil esta página?