Elemento Shape (VML)

Este tópico descreve o VML, um recurso que foi preterido a partir do Windows Internet Explorer 9. Páginas da Web e aplicativos que dependem de VML devem ser migrados para SVG ou outros padrões amplamente compatíveis.

Observação

A partir de dezembro de 2011, este tópico foi arquivado. Como resultado, ele não é mais mantido ativamente. Para obter mais informações, consulte Conteúdo arquivado. Para obter informações, recomendações e diretrizes sobre a versão atual do Windows Internet Explorer, consulte Internet Explorer Developer Center.

 

Elemento de nível superior usado para descrever uma forma.

Os atributos a seguir modificam uma forma.

Atributo	Descrição
Adj	Especifica um valor de ajuste usado para definir valores para uma fórmula.
AllowInCell	Determina se uma forma pode ser colocada em uma tabela.
AllowOverlap	Determina se uma forma pode se sobrepor a outras formas.
Alt	Define o texto alternativo a ser exibido em vez de um gráfico.
BorderBottomColor	Cor da borda inferior de uma forma embutida.
BorderLeftColor	Cor da borda esquerda de uma forma embutida.
BorderRightColor	Cor da borda direita de uma forma embutida.
BorderTopColor	Cor da borda superior de uma forma embutida.
Bala	Determina se uma forma é um marcador gráfico.
Botão	Determina se uma forma será processada como um botão.
BWMode	Determina como uma forma será renderizada para dispositivos de saída preto e branco.
BWNormal	Define o modo preto e branco para dispositivos de saída normais em preto e branco.
BWPure	Define o modo preto e branco para dispositivos de saída preto e branco puros.
Classe	Refere-se a uma definição de um estilo CSS.
Connectortype	Indica o tipo de conector usado para unir formas.
CoordOrig	Especifica a origem da unidade de coordenadas do retângulo que vincula uma forma.
CoordSize	Especifica as unidades horizontais e verticais do retângulo que vincula uma forma.
DoubleClickNotify	Envia uma mensagem de evento quando uma forma é clicada duas vezes.
Fillcolor	Define a cor do pincel que preenche o caminho fechado de uma forma.
Preenchido	Determina se o caminho fechado será preenchido.
Inverter	Alterna a orientação de uma forma.
ForceDash	Determina se um contorno tracejado é usado para desenhar uma forma quando uma forma não tem linha ou preenchimento.
Altura	Especifica a altura da forma.
RH	Especifica que uma forma é uma regra horizontal.
HRAlign	Define o alinhamento de uma regra horizontal.
Href	Define uma URL para uma forma. Quando a forma for clicada, o navegador carregará a URL.
HRHeight	Define a espessura de uma regra horizontal.
HRNoShade	Determina se uma regra horizontal será exibida com sombreamento 3D.
HRPct	Define o comprimento de uma regra horizontal como uma porcentagem da largura da página.
HRStd	Determina se uma forma é uma regra horizontal padrão.
HRWidth	Define o comprimento de uma regra horizontal.
ID	Fornece um identificador exclusivo para um elemento.
Left	Determina a posição da forma em relação ao elemento à esquerda dele no fluxo do documento.
Margem Inferior	Especifica a borda inferior do retângulo que contém a forma em relação à âncora da forma.
Margem à Esquerda	Especifica a borda esquerda do retângulo que contém a forma em relação à âncora da forma.
Margem à Direita	Especifica a borda direita do retângulo que contém a forma em relação à âncora da forma.
Margem Superior	Especifica a borda superior do retângulo que contém a forma em relação à âncora da forma.
MSO-Position-Horizontal	Especifica os dados de posicionamento horizontal para objetos no Microsoft Word.
MSO-Position-Horizontal-Relative	Especifica dados relativos de posição horizontal para objetos no Microsoft Word.
MSO-Position-Vertical	Especifica os dados de posição vertical para objetos no Microsoft Word.
MSO-Position-Vertical-Relative	Especifica dados relativos de posição vertical para objetos no Microsoft Word.
MSO-Wrap-Distance-Bottom	Define a distância do lado inferior da forma até o texto que a envolve.
MSO-Wrap-Distance-Left	Define a distância do lado esquerdo da forma para o texto que a envolve.
MSO-Wrap-Distance-Right	Define a distância do lado direito da forma para o texto que a envolve.
MSO-Wrap-Distance-Top	Define a distância da parte superior da forma até o texto que a envolve.
MSO-Wrap-Edited	Determina se as coordenadas de encapsulamento foram personalizadas pelo usuário.
MSO-Wrap-Mode	Define o modo de disposição do texto.
OLEIcon	Determina se um objeto OLE será exibido como um ícone.
OnEd	Determina se as alças extras de uma forma estão ocultas.
Onmouseover	Dispara um evento do mouse para uma forma.
Caminho	Especifica a linha que compõe as bordas de uma forma.
Posição	Define o tipo de posicionamento usado para posicionar um elemento.
PreferRelative	Determina se o tamanho original de um objeto é salvo após a reformatação.
Imprimir	Determina se a forma será impressa.
ReGroupID	Define um grupo anterior para uma forma.
Relativeposition	Define uma posição relativa para um objeto .
Rotação	Define o ângulo em que uma forma é girada.
RuleInitiator	Determina se um mecanismo de regras será usado.
RuleProxy	Determina se um proxy para o mecanismo de regras será usado.
Spt	Define um número usado internamente pelo Microsoft Office para identificar tipos de formas.
StrokeColor	Define a cor do pincel que traça o caminho de uma forma.
Acariciou	Define se o caminho será traçado.
StrokeWeight	Define a espessura do pincel que traça o caminho de uma forma.
TableLimits	Lista de valores mínimos de altura para cada linha em uma tabela.
TableProperties	Determina as propriedades da tabela.
Target (destino)	Define um quadro ou janela em que uma URL será exibida.
Título	Define o texto exibido quando o ponteiro do mouse se move sobre a forma.
Top	Define a posição da forma em relação ao elemento acima dela no fluxo da página.
Tipo	Define uma referência à ID de um elemento ShapeType .
UserDrawn	Determina se o usuário adicionou a forma a um slide master.
UserHidden	Determina se uma âncora de script está oculta.
Visibilidade	Determina se uma forma é exibida.
Largura	Define a largura da forma.
WrapCoords	Define o polígono delimitado que envolve uma forma.
Índice Z	Determina a ordem de exibição de formas sobrepostas.

 

Comentários

Esse elemento pode aparecer por si só ou dentro de um elemento Group .

Veja a seguir o código mínimo necessário para produzir uma forma. Você deve definir os atributos FillColor, Position, Top, Left, Width, Height e Path ou a forma não será renderizada.

   <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>

Além disso, você deve colocar o código a seguir no elemento HTML da página da Web para obter os esquemas corretos para VML e Extensões do Microsoft Office. Se você não estiver usando as Extensões do Office, poderá omitir o segundo esquema.

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

Você também deve ter o seguinte no elemento STYLE para registrar o comportamento do VML e das Extensões do Microsoft Office. Se você não estiver usando as Extensões do Office, poderá omitir a segunda definição de comportamento.

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

Subelementos válidos

Veja a seguir os subelementos de Shape.

Elemento	Descrição
Balão	Define um texto explicativo para uma forma.
Extrusão	Define uma extrusão para uma forma.
Preenchimento	Define um preenchimento para uma forma.
Fórmulas	Define fórmulas para uma forma.
Alças	Define identificadores para uma forma.
Imagedata	Define dados de imagem para uma forma.
Bloqueios	Define um bloqueio para uma forma.
Caminho	Define um caminho para uma forma.
Shadow	Define uma sombra para uma forma.
Inclinar	Define uma distorção para uma forma.
Traço	Define um traço para uma forma.
TextBox	Define uma caixa de texto para uma forma.
Textpath	Define um caminho de texto para uma forma.

 

Outros elementos

Os elementos de nível superior a seguir funcionam com Shape.

Elemento	Descrição
Grupo	Define um grupo de formas.
ShapeType	Define um modelo para formas.
VMLFrame	Define um quadro para uma forma externa.

 

Formas predefinidas

As formas predefinidas são iguais às formas normais, exceto que algumas delas têm atributos adicionais. As formas a seguir são predefinidas.

Elemento	Descrição
Rect	Define um retângulo para uma forma.
Roundrect	Define um rect redondo para uma forma.
Linha	Define uma linha para uma forma.
Polilinha	Define uma polilinha para uma forma.
Oval	Define uma elipse para uma forma.
Imagem	Define uma imagem para uma forma.
Curva	Define uma curva para uma forma.
Arc	Define um arco para uma forma.

 

Consulte também

Tipos de dados VML

Exemplo

O código a seguir é composto por uma página da Web VML de exemplo:

<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>