Elemento Shape (VML)

En este tema se describe VML, una característica que está en desuso a partir de Windows Internet Explorer 9. Las páginas web y las aplicaciones que dependen de VML deben migrarse a SVG u otros estándares ampliamente compatibles.

Nota

A partir de diciembre de 2011, este tema se ha archivado. Como resultado, ya no se mantiene activamente. Para obtener más información, vea Contenido archivado. Para obtener información, recomendaciones e instrucciones sobre la versión actual de Windows Internet Explorer, vea Centro para desarrolladores de Internet Explorer.

 

Elemento de nivel superior usado para describir una forma.

Los atributos siguientes modifican una forma.

Atributo	Descripción
Adj	Especifica un valor de ajuste utilizado para definir valores para una fórmula.
AllowInCell	Determina si una forma se puede colocar en una tabla.
AllowOverlap	Determina si una forma puede superponerse a otras formas.
Alt	Define el texto alternativo que se va a mostrar en lugar de un gráfico.
BorderBottomColor	Color de borde inferior de una forma insertada.
BorderLeftColor	Color de borde izquierdo de una forma insertada.
BorderRightColor	Color de borde derecho de una forma insertada.
BorderTopColor	Color de borde superior de una forma insertada.
Bala	Determina si una forma es una viñeta gráfica.
Button	Determina si una forma se procesará como un botón.
BWMode	Determina cómo se representará una forma para los dispositivos de salida en blanco y negro.
BWNormal	Define el modo negro y blanco para los dispositivos de salida normales en blanco y negro.
BWPure	Define el modo negro y blanco para los dispositivos de salida puros en blanco y negro.
Clase	Hace referencia a una definición de un estilo CSS.
ConnectorType	Indica el tipo de conector utilizado para unir formas.
CoordOrig	Especifica el origen de la unidad de coordenadas del rectángulo que enlaza una forma.
CoordSize	Especifica las unidades horizontales y verticales del rectángulo que enlaza una forma.
DoubleClickNotify	Envía un mensaje de evento cuando se hace doble clic en una forma.
FillColor	Define el color del pincel que rellena el trazado cerrado de una forma.
Lleno	Determina si se rellenará la ruta de acceso cerrada.
Flip	Cambia la orientación de una forma.
ForceDash	Determina si se usa un contorno discontinuo para dibujar una forma cuando una forma no tiene línea o relleno.
Height	Especifica el alto de la forma.
RR. HH.	Especifica que una forma es una regla horizontal.
HRAlign	Define la alineación de una regla horizontal.
Href	Define una dirección URL para una forma. Cuando se haga clic en la forma, el explorador cargará la dirección URL.
HRHeight	Define el grosor de una regla horizontal.
HRNoShade	Determina si se mostrará una regla horizontal con sombreado 3D.
HRPct	Define la longitud de una regla horizontal como un porcentaje del ancho de página.
HRStd	Determina si una forma es una regla horizontal estándar.
HRWidth	Define la longitud de una regla horizontal.
ID	Proporciona un identificador único para un elemento.
Left	Determina la posición de la forma en relación con el elemento izquierdo del mismo en el flujo del documento.
Margen inferior	Especifica el borde inferior del rectángulo que contiene la forma en relación con el delimitador de la forma.
Margen izquierdo	Especifica el borde izquierdo del rectángulo que contiene la forma en relación con el delimitador de la forma.
Margen derecho	Especifica el borde derecho del rectángulo que contiene la forma en relación con el delimitador de la forma.
Margen superior	Especifica el borde superior del rectángulo que contiene la forma en relación con el delimitador de la forma.
MSO-Position-Horizontal	Especifica los datos de posicionamiento horizontal de los objetos de Microsoft Word.
MSO-Position-Horizontal-Relative	Especifica los datos de posición horizontal relativos para los objetos de Microsoft Word.
MSO-Position-Vertical	Especifica los datos de posición vertical de los objetos de Microsoft Word.
MSO-Position-Vertical-Relative	Especifica los datos de posición vertical relativos para los objetos de Microsoft Word.
MSO-Wrap-Distance-Bottom	Define la distancia desde el lado inferior de la forma hasta el texto que lo rodea.
MSO-Wrap-Distance-Left	Define la distancia desde el lado izquierdo de la forma hasta el texto que lo rodea.
MSO-Wrap-Distance-Right	Define la distancia desde el lado derecho de la forma hasta el texto que lo rodea.
MSO-Wrap-Distance-Top	Define la distancia desde la parte superior de la forma hasta el texto que la rodea.
MSO-Wrap-Edit	Determina si el usuario ha personalizado las coordenadas de ajuste.
Modo de ajuste de MSO	Define el modo de ajuste para el texto.
OLEIcon	Determina si un objeto OLE se mostrará como un icono.
OnEd	Determina si los identificadores adicionales de una forma están ocultos.
Onmouseover	Desencadena un evento de mouse para una forma.
Ruta de acceso	Especifica la línea que forma los bordes de una forma.
Posición	Define el tipo de posicionamiento utilizado para colocar un elemento.
PreferRelative	Determina si el tamaño original de un objeto se guarda después de volver a formatear.
Imprimir	Determina si se imprimirá la forma.
ReGroupID	Define un grupo anterior para una forma.
RelativePosition	Define una posición relativa para un objeto .
Rotación	Define el ángulo en el que se gira una forma.
RuleInitiator	Determina si se usará un motor de reglas.
RuleProxy	Determina si se usará un proxy para el motor de reglas.
Spt	Define un número usado internamente por Microsoft Office para identificar tipos de formas.
Strokecolor	Define el color del pincel que trazo la ruta de acceso de una forma.
Acarició	Define si se trazará la ruta de acceso.
StrokeWeight	Define el grosor del pincel que trazos el trazado de una forma.
TableLimits	Lista de valores mínimos de alto para cada fila de una tabla.
TableProperties	Determina las propiedades de la tabla.
Target	Define un marco o ventana en el que se mostrará una dirección URL.
Título	Define el texto que se muestra cuando el puntero del mouse se mueve sobre la forma.
Top (Principales)	Define la posición de la forma en relación con el elemento situado encima en el flujo de la página.
Tipo	Define una referencia al identificador de un elemento ShapeType .
UserDrawn	Determina si el usuario ha agregado la forma a una diapositiva maestra.
UserHidden	Determina si un delimitador de script está oculto.
Visibilidad	Determina si se muestra una forma.
Width	Define el ancho de la forma.
WrapCoords	Define el polígono delimitador que rodea una forma.
Índice Z	Determina el orden de presentación de las formas superpuestas.

 

Comentarios:

Este elemento puede aparecer por sí mismo o dentro de un elemento Group .

A continuación se muestra el código mínimo necesario para generar una forma. Debe definir los atributos FillColor, Position, Top, Left, Width, Height y Path , o bien no se representará la forma.

   <v:shape
   fillcolor="green"
   style="position:relative;top:1;left:1;width:200;height:200"
   path = "m 1,1 l 1,200, 200,200, 200,1 x e">
   </v:shape>

Además, debe colocar el código siguiente en el elemento HTML de la página web para obtener los esquemas correctos para vmL y extensiones de Microsoft Office. Si no usa extensiones de Office, puede omitir el segundo esquema.

xmlns:v="urn:schemas-microsoft-com:vml"
xmlns:o="urn:schemas-microsoft-com:office:office"

También debe tener lo siguiente en el elemento STYLE para registrar el comportamiento de VML y Extensiones de Microsoft Office. Si no usa extensiones de Office, puede omitir la segunda definición de comportamiento.

v\:* { behavior: url(#default#VML); display:inline-block}
o\:* { behavior: url(#default#VML); }

Subelementos válidos

A continuación se muestran subelementos de Shape.

Elemento	Descripción
Llamada	Define una llamada para una forma.
Extrusión	Define una extrusión para una forma.
Fill	Define un relleno para una forma.
Fórmulas	Define fórmulas para una forma.
Asas	Define los identificadores de una forma.
Imagedata	Define los datos de imagen de una forma.
Bloqueos	Define un bloqueo para una forma.
Ruta de acceso	Define una ruta de acceso para una forma.
Shadow	Define una sombra para una forma.
Sesgar	Define un sesgo para una forma.
Carrera	Define un trazo para una forma.
TextBox	Define un cuadro de texto para una forma.
TextPath	Define una ruta de acceso de texto para una forma.

 

Otros elementos

Los siguientes elementos de nivel superior funcionan con Shape.

Elemento	Descripción
Grupo	Define un grupo de formas.
ShapeType	Define una plantilla para las formas.
VMLFrame	Define un marco para una forma externa.

 

Formas predefinidas

Las formas predefinidas son las mismas que las formas normales, salvo que algunas de ellas tienen atributos adicionales. Las siguientes formas están predefinidas.

Elemento	Descripción
Rect	Define un rectángulo para una forma.
RoundRect	Define un rectándeo redondo para una forma.
Línea	Define una línea para una forma.
Polilínea	Define una polilínea para una forma.
Elipse	Define un óvalo para una forma.
Imagen	Define una imagen para una forma.
Curva	Define una curva para una forma.
Arc	Define un arco para una forma.

 

Vea también

Tipos de datos VML

Ejemplo

El código siguiente consta de una página web de VML de ejemplo:

<HTML xmlns:v="urn:schemas-microsoft-com:vml"
xmlns:o="urn:schemas-microsoft-com:office:office">
<HEAD>
<STYLE>
v\:* { behavior: url(#default#VML);}
o\:* { behavior: url(#default#VML);}
</STYLE>
<TITLE>VML Sample</TITLE>
</HEAD>
<BODY>
   <v:shape
   fillcolor="green"
   style="position:relative;top:1;left:1;width:200;height:200"
   path = "m 1,1 l 1,200, 200,200, 200,1 x e">
   </v:shape>
</BODY>
</HTML>