Shape Interfaz

  • Referencia

Definición

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

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