Shape Interfaz

Referencia

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 Shapes 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 Shapes , 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 formas una y cuatro en el documento, o podría representar todas las formas seleccionadas en el documento) y el objeto Shape , que representa una sola forma en 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 Shapes(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 asignar un nombre más significativo a la forma, use la Name propiedad .

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

Use Selection.ShapeRange(index), donde index es 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 adjuntas 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 y 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 lo 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 o Regroup() para agrupar un intervalo 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

Adjustments	Devuelve un Adjustments objeto que contiene valores de ajuste para todos los ajustes de la forma especificada. Solo lectura.
AlternativeText	Devuelve o establece la cadena de texto descriptivo (alternativo) de un Shape objeto cuando el objeto 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 distinta de 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 Shape objetos que representan llamadas de línea. Solo lectura.
CanvasItems	Reservado para uso interno.
Chart	Devuelve un objeto que representa el _Chart contenido en .Shape 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. De solo MsoTriStatelectura.
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. De solo MsoTriStatelectura.
ConnectorFormat	Devuelve un ConnectorFormat objeto que contiene las propiedades de formato del 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. De solo XlCreatorlectura.
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. De solo XlFormControllectura.
Glow	Devuelve un objeto para una forma especificada que contiene propiedades de formato de iluminado 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 sobre si contiene Shape un gráfico. Solo lectura.
HasDiagram	Devuelve si una forma o un intervalo de formas contiene un diagrama. De solo MsoTriStatelectura.
HasDiagramNode	Devuelve un valor que indica si existe un nodo de diagrama en una forma o un intervalo de formas determinados. De solo MsoTriStatelectura.
HasSmartArt	Obtiene si hay un diagrama smartart presente en la forma especificada.
Height	Alto del objeto. Lectura y escritura único.
HorizontalFlip	Es True si la forma especificada se voltea alrededor del eje horizontal. De solo MsoTriStatelectura.
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	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	True si el objeto está bloqueado, False 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 primaria común de una forma secundaria o un intervalo 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 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	True si el objeto tiene una sombra. Boolean de lectura y escritura.
ShapeStyle	Devuelve o establece un MsoShapeStyleIndex objeto que representa el estilo de forma de la forma. Lectura y escritura.
SmartArt	Obtiene un objeto que representa el SmartArt asociado a la forma.
SoftEdge	Devuelve un SoftEdgeFormat objeto para 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 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 delimitador 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 superior del 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 bajo la esquina superior izquierda del objeto especificado. Solo lectura.
Type	Devuelve o establece el tipo de forma. De solo MsoShapeTypelectura.
VerticalFlip	True si la forma especificada está volteada alrededor del eje vertical. De solo MsoTriStatelectura.
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	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

Apply()	Se aplica al formato de forma especificado que se ha copiado mediante 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 la rotación absoluta 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 desagrupadas como un solo 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

Compartir a través de

Shape Interfaz

Definición

Comentarios

Propiedades

Métodos

Se aplica a

Comentarios

Recursos adicionales