Condividi tramite

Informazioni di riferimento sul modello a oggetti VML

Questo argomento descrive VML, una funzionalità deprecata a partire da Windows Internet Explorer 9. È consigliabile eseguire la migrazione di pagine Web e applicazioni basate su VML a SVG o ad altri standard ampiamente supportati.

Nota

A partire da dicembre 2011, questo argomento è stato archiviato. Di conseguenza, non viene più mantenuto attivamente. Per altre informazioni, vedere contenuto archiviato. Per informazioni, consigli e indicazioni sulla versione corrente di Windows Internet Explorer, vedere Internet Explorer Developer Center.

In questo argomento:

Introduzione

Vector Markup Language (VML) è un linguaggio basato su testo che usa XML per estendere il codice HTML allo scopo di visualizzare informazioni grafiche vettoriali. Il DOM (Document Object Model) VML definisce un'interfaccia programmatica per la manipolazione degli elementi del documento. Ciò consente all'utente di creare e modificare dinamicamente la grafica vettoriale tramite un'interfaccia indipendente dalla piattaforma e dal linguaggio. Il DOM VML è conforme alla specifica document object model.

VML usa l'elemento Shape come blocco predefinito di base per le immagini grafiche vettoriali. Dopo aver creato una forma, è possibile modificare la forma tramite attributi o sottoelementi collegati. Ad esempio, per modificare il colore di una forma, assegnare un valore di colore all'attributo FillColor.

myshape.fillcolor = "red"

Diversi attributi di una forma sono anche sottoelementi e hanno i propri attributi, inclusi i seguenti:

VML OM usa diversi tipi di dati per definire i parametri. I tipi di dati preceduti da "Vg" sono enumerazioni e quelli preceduti da "IVg" sono oggetti. Fare clic qui per un elenco. I tipi di dati secondari sono elencati con parametri specifici.

Esempio

Il codice VBScript seguente illustra come creare una forma semplice:

        Set MyRect = Document.CreateElement("v:Rect")
        Set R = MyDiv.AppendChild(MyRect)
        R.Style.Position = "absolute"
        R.Style.Width = 20
        R.Style.Height = 20
        R.Style.Top = 50
        R.Style.Left = 50
        R.FillColor = "red"

Nell'esempio precedente viene creata una forma usando il metodo Document Object Model CreateElement. La forma è una forma VML predefinita Rect. Anche se l'oggetto esiste, non può far parte del documento finché non viene allegato al documento. Utilizzando il metodo AppendChild, rect viene creato come figlio di un elemento DIV denominato MyDiv. Alcuni attributi di stile minimi (Position, Width, Height, Top, Left) vengono impostati per assegnare alla forma una dimensione specifica. Infine, viene assegnato un colore con l'attributo FillColor. Si noti che è possibile usare qualsiasi linguaggio di scripting o qualsiasi linguaggio in grado di usare le interfacce del modello a oggetti documento.

Configurazione di VML

Un'implementazione di VML consiste nell'usare Microsoft Internet Explorer 5.0 o versione successiva. Per configurare correttamente l'oggetto di rendering in una pagina Web, è necessario apportare le aggiunte seguenti:

  1. Lo schema deve essere configurato nel tag HTML> iniziale <come indicato di seguito:

    <HTML xmlns:v="urn:schemas-microsoft-com:vml">

  2. Il comportamento di rendering deve far parte dello stile del documento:

    <STYLE>
v\:* { behavior: url(#default#VML); display:inline-block}
</STYLE>

Di seguito viene illustrato un esempio di pagina Web HTML configurata correttamente per VML che mostra la creazione dinamica di una forma.

<HTML xmlns:v="urn:schemas-microsoft-com:vml">
<HEAD>
<STYLE>
v\:* { behavior: url(#default#VML); display:inline-block}
</STYLE>
<TITLE>VML Sample</TITLE>
</HEAD>
<BODY>
<DIV id="MyDiv"></DIV>
<SCRIPT ID="MYSCRIPT" LANGUAGE="VBScript">
<!--
Set MyRect = Document.CreateElement("v:Rect")
Set R = MyDiv.AppendChild(MyRect)
R.Style.Position = "absolute"
R.Style.Width = 20
R.Style.Height = 20
R.Style.Top = 50
R.Style.Left = 50
R.FillColor = "red"
-->
</SCRIPT>
</BODY>
</HTML>

Si noti che nelle versioni beta era necessario un tag oggetto ActiveX e uno stile di comportamento diverso.

Informazioni di riferimento su VML OM

Questo riferimento definisce l'elemento Shape, sottoelementie tipi di dati utilizzati dal modello a oggetti di VML.

Elemento Shape

Le forme sono i blocchi predefiniti delle immagini grafiche definite da Vector Markup Language (VML). La forma è l'elemento di primo livello e diversi sottoelementi consentono di definire la natura di ogni forma.

VML fornisce forme predefinite:

attributi di forma

  • Arc
  • curva
  • linea
  • polyline
  • rect
  • RoundRect
Sottoelemento Descrizione
Adj IVgAdjustments. Elenco delimitato da virgole di numeri che sono i parametri per le formule della guida che definiscono il percorso della forma. I valori possono essere omessi per consentire l'uso delle impostazioni predefinite. Possono essere presenti fino a 8 valori di regolazione.
Alt Corda. Testo alternativo associato alla forma. Utilizzato per l'esplorazione non grafica.
Bottone VgTriState. Visualizza il comportamento del pulsante facendo clic.
BWMode VgBlackWhiteMode. Determina la modalità di rendering della forma in visualizzazione bianco e nero nelle app o quando stampata in stampanti bianche e nere. I valori includono: Color, Auto, GrayScale, LightGrayScale, InverseGray, GrayOutline, BlackTextAndLines, HighContrast, Black, White, Undrawn. Impostazione predefinita: automatico .
BWNormal VgBlackWhiteMode. Quando BWMode è Auto, questa proprietà viene consultata per informazioni su come eseguire il rendering della forma in bianco e nero normale. I valori includono: Color, Auto, GrayScale, LightGrayScale, InverseGray, GrayOutline, BlackTextAndLines, HighContrast, Black, White, Undrawn. Impostazione predefinita: automatico .
BWPure VgBlackWhiteMode. Quando BWMode è Auto, questa proprietà viene consultata per informazioni su come eseguire il rendering della forma in B/W puro. I valori includono: Color, Auto, GrayScale, LightGrayScale, InverseGray, GrayOutline, BlackTextAndLines, HighContrast, Black, White, Undrawn. Impostazione predefinita: automatico .
Forme figlio IVgGroupShapes. Insieme di altre forme di questo gruppo. Questa raccolta supporta i metodi Standard Length e Item.
Chromakey IVgColor. Valore di colore che sarà trasparente e che mostrerà qualsiasi elemento dietro la forma.
Control1 Vector2D. Punto di controllo per la curva.
Control2 Vector2D. Punto di controllo per la curva.
CoordOrigin Vector2D Le coordinate nell'angolo superiore sinistro del rettangolo contenitore. Intervallo compreso tra 0 e infinito.
CoordSize Vector2D. Larghezza e altezza dello spazio delle coordinate all'interno del rettangolo di riferimento di questa forma. Se non viene specificato, corrisponde alla larghezza e all'altezza del rettangolo. Intervallo compreso tra 0 e infinito. Impostazione predefinita: "1000.1000".
EndAngle VgAngleInDegrees. Angolo finale della forma.
Estrusione IVgExtrusion. Specifica il valore dell'oggetto Estrusione per questa forma. Per informazioni dettagliate, vedere l'elemento estrusione.
Riempire VgFillFormat. Specifica il valore di riempimento per questa forma. Per altri dettagli, vedere l'elemento Fill.
FillColor IVgColor. Colore principale del pennello da utilizzare per riempire il percorso della forma.
Otturato VgTriState. Se True, il percorso che definisce la forma verrà riempito. Per impostazione predefinita, verrà riempita utilizzando un colore a tinta unita, a meno che non sia presente un sottoelemento Fill che specifica proprietà di riempimento più complesse. Se False, il riempimento è trasparente.
Capovolgere VgFlipOrientation. I valori sono: X Y XY YX
ForceDash VgTriState. Indica che è necessario eseguire il rendering di un contorno tratteggiato quando non è presente alcuna linea e nessun riempimento per una forma. Questo comportamento è in genere utile per rendere visibili forme invisibili nelle applicazioni di modifica in modo che possano essere selezionate e gestite, ad esempio in una mappa delle immagini.
Formule IVgFormulas. Matrice di formule che definisce una forma.
Da Vector2D. Punto di partenza della linea.
HRef stringa. URL a cui passare se si fa clic su questa forma.
ImageData IVgImageData. Informazioni sull'immagine se la forma è un'immagine. Per altre informazioni, vedere l'elemento ImageData.
Attivato VgTriState. Nasconde tutti i punti di manipolazione tranne quelli in alto a sinistra e in basso a destra, come negli handle per un segmento di linea retta.
Opacità VgFraction. Opacità dell'intera forma. Numero compreso tra 0,0 e 1,0.
Sentiero IVgPath. Stringa contenente i comandi che definiscono il percorso.
Scambio ferroviario IVgPoints. Insieme di punti che definiscono una forma.
Stampare VgTriState. Se True, la forma deve essere stampata.
Rotazione VgAngleInDegrees. Imposta la rotazione della forma. Il valore viene propagato allo stile della forma.
Scala Vector2D. Scala della forma.
Ombra IVgShadow. Specifica l'ombreggiatura per questa forma. Per informazioni dettagliate, vedere l'elemento Shadow.
Spt Riservato.
StartAngle VgAngleInDegrees. Angolo iniziale della forma.
Infarto VgStrokeFormat. Per informazioni dettagliate, vedere Elemento Stroke.
StrokeColor IVgColor. Colore principale del pennello da utilizzare per tracciare il percorso della forma.
Accarezzò VgTriState. Se True, verrà tracciato il percorso che definisce la forma.
StrokeWeight VGLength. Larghezza del pennello da utilizzare per tracciare il percorso. Intervalli compresi tra 0 e 1584.
TextPath IVgTextPath. Specifica l'oggetto TextPath della forma. Per altre informazioni, vedere l'elemento TextPath.
A Vector2D. Punto finale della linea.
Digitare Corda. Tipo di forma.

Sottoelementi dell'elemento Shape

I sottoelementi seguenti fanno parte del modello a oggetti VML.

Elemento Background

Descrive il riempimento dello sfondo di una pagina usando i riempimenti VML.

Attributo Descrizione
BWMode VgBlackWhiteMode. Determina il rendering della forma in visualizzazione bianco e nero nelle applicazioni o quando viene stampato.
BWNormal VgBlackWhiteMode. Quando BWMode è Auto, questa proprietà viene consultata per informazioni su come eseguire il rendering della forma in bianco e nero normale.
BWPure VgBlackWhiteMode. Quando BWMode è Auto, questa proprietà viene consultata per informazioni su come eseguire il rendering della forma in bianco e nero puro.
Riempire VgFillFormat. Specifica il riempimento per questa forma. Per altre informazioni, vedere elemento Fill.
FillColor IVgColor. Colore principale del pennello da utilizzare per riempire il percorso della forma. Duplicato del valore Color nell'elemento Fill. Il valore predefinito è bianco.

Elemento Estrusione

Descrive un'estrusione 3D della forma.

attributi

AutoRotationCenter VgTriState. Se True, il centro di rotazione del gruppo di oggetti 3D (in realtà c'è un solo oggetto nel gruppo) viene determinato automaticamente come centro del gruppo; in caso contrario, è determinato dai parametri RotationCenter, che sono una frazione della forma con 0,0,0 come centro.
BackDepth VgLength. Quantità di estrusione all'indietro. È compreso tra 0 e 32767.
Luminosità VgPositiveNumber. Luminosità complessiva della scena. Il valore predefinito è "20.000".
Colore IVgColor. Colore dell'estrusione. Utilizzato solo se ColorMode è Personalizzato. In caso contrario, Auto imposta il colore dell'effetto di estrusione sullo stesso valore di FillColor.
ColorMode Vg3DColorMode. I valori sono:
  • Auto (impostazione predefinita)
  • Costume
Diffusione VgPositiveNumber. Rapporto tra evento imprevisto e luce diffusamente riflessa. I valori minori di 1,0 sono normali, ma i valori superiori a uno possono generare effetti interessanti.
Bordo VgLength. Imposta le dimensioni di un bordo smussato simulato arrotondato. È compreso tra 0 e 32767 in punti a virgola mobile. Il valore predefinito è "1pt".
Sfaccettatura VgPositiveNumber. Imposta il facet della scena. Il valore predefinito è "30.000".
ForeDepth VgLength. Quantità di estrusione in avanti. È compreso tra 0 e 32767.
LightFace VgTriState. Determina se la faccia anteriore dell'oggetto risponderà alle modifiche apportate all'illuminazione 3D, ad esempio quando un oggetto ruota.
LightHarsh VgTriState. Illuminazione dura per la sorgente di luce primaria. Il valore predefinito è False.
LightHarsh2 VgTriState. Illuminazione dura per la sorgente di luce secondaria. Il valore predefinito è False.
LightLevel VgNumber. Intensità della sorgente di luce primaria. Il valore predefinito è "38000".
LightLevel2 VgNumber. Intensità della sorgente di luce secondaria. Il valore predefinito è "38000".
LightPosition Vector3D. Posizione della sorgente di luce primaria. Il valore predefinito è "50000,0,10000".
LightPosition2 Vector3D. Posizione della sorgente di luce secondaria. Il valore predefinito è "-50000,0,10000".
LockRotationCenter VgTriState. "Lockrotationcenter" indica che la rotazione del gruppo viene definita in base all'angolo di rotazione[1] circa l'asse y nella pagina seguita da angolo di rotazione[0] gradi circa l'asse x. Quando LockRotationCenter è False, la rotazione viene definita in base ai gradi di angolo di orientamento sul vettore definito dall'orientamento. Ad esempio, lockrotationcenter=false orientationangle=45 orientation=(0,1,0) equivale a lockrotationcenter=true rotationangle=(0,45).
Metallo VgTriState. Fa sì che la luce riflessa specularmente sia il colore del materiale anziché il colore della sorgente di luce, rendendo l'oggetto più metallico.
Su VgTriState. Attiva e disattiva la visualizzazione dell'effetto di estrusione.
Orientamento Vector3D. Orientamento della fotocamera.
OrientationAngle VgAngleInDegrees. Angolo tra l'orientamento della fotocamera e il piano xy.
Aereo Vg3DExtrudePlane. Consente l'estrusione dai piani ortogonali al piano dello schermo. Richiede che foreDepth e BackDepth vengano specificati nelle unità di misura del disegno anziché nell'emus. I valori sono:
  • XY
  • ZX
  • YZ
Rendere Vg3DRenderMode. I valori sono:
  • Solid (impostazione predefinita)
  • WireFrame
  • BoundingCube
RotationAngle Vector2D. AngleX, AngleY o AngleZ è controllato dall'attributo ShapeRotation.
RotationCenter Vector3D. Centro di rotazione.
Lucidità VgPositiveNumber. Determina la modalità di riflessione speculare concentrata o distribuita. Un valore elevato sarebbe da 8 a 10 e approssimare uno specchio, e un valore basso sarebbe da 2 a 3 e sarebbe approssimativo abbigliamento aquinato. I valori da 3 a 7 sono consigliati. I valori alti rifletteranno le sorgenti di luce puntina.
SkewAmt VgPercentage. Se Type è Parallel, l'attributo determina la quantità di asimmetria. È compreso tra 0 e 100.
Asimmetria VgAngleInDegrees. Se Type è Parallel, l'attributo determina il grado di asimmetria. Il valore predefinito è "-45".
Specularità VgPositiveNumber. Rapporto tra evento imprevisto e luce specularmente riflessa. I valori minori di 1,0 sono normali, ma i valori superiori a uno possono generare effetti interessanti.
Digitare VgExtrusionType. I valori sono:
  • Parallel (impostazione predefinita)
  • Prospettiva
Punto di vista Vector3D. Punto da cui viene visualizzata la scena.
ViewpointOrigin Vector2D. I valori possono essere compresi tra 0,5 e -0,5 per posizionare l'origine del punto di vista all'interno del rettangolo di selezione della forma.

Elemento Fill

Descrive il modo in cui un percorso deve essere riempito per i riempimenti più complessi rispetto a un colore a tinta unita.

attributi

AlignShape VgTriState. Allineare l'immagine alla forma. Se False, allineare l'immagine alla finestra.
Angolo VgAngleInDegrees. Angolo lungo il quale va la sfumatura. 0 gradi si trova lungo l'asse orizzontale da sinistra a destra.
Aspetto VgAspectType. L'attributo ImageSize verrà modificato per mantenere l'aspetto dell'immagine. I valori includono:
Valore Descrizione
Ignorare Ignorare i problemi relativi all'aspetto.
AtLeast L'immagine è almeno grande quanto le dimensioni dell'immagine.
AtMost L'immagine non è maggiore delle dimensioni dell'immagine.

Colore IVgColor Colore di riempimento principale. Uguale all'attributo FillColor nella forma.
Color2 IVgColor. Colore secondario per un riempimento quando il tipo di immagine è Motivo o riempimento sfumato.
Colori IVgGradientColorArray. Colori intermedi nella sfumatura e le relative posizioni lungo la sfumatura, ad esempio "30% rosso, 70% blu, 90% verde". Il colore primario (attributo Color nella forma) è 0% e il colore secondario (attributo Color2) è 100%.
Fuoco VgSignedPercentage. Punto focale per il riempimento sfumato lineare. I valori vanno da -100 a +100.
FocusPosition Vector2D. Posizione del rettangolo più interno per le sfumature radiali. Il vettore è una frazione (0,0 - 1,0) della larghezza e dell'altezza della forma.
FocusSize Vector2D Dimensioni del rettangolo più interno per le sfumature radiali. Il vettore è una frazione (da 0,0 a 1,0) della larghezza e dell'altezza della forma.
Metodo VgSigmaType. I valori includono:
  • Nessuno
  • Lineare
  • Sigma
  • Qualunque

Il valore predefinito è Sigma.
Su VgTriState. Attiva la visualizzazione del riempimento. Uguale all'attributo Fill nella forma.
Opacità VgFraction. Opacità del riempimento.
Opacità2 VgFraction. Opacità secondaria per le sfumature.
Origine Vector2D. Punto rispetto all'angolo superiore sinistro dell'immagine considerata come origine dell'immagine. Il valore predefinito è il centro dell'immagine. Il vettore è una frazione (da 0,0 a 1,0) della larghezza e dell'altezza dell'immagine.
Posizione Vector2D. Puntare nel rettangolo di riferimento della forma per posizionare l'origine dell'immagine. Il valore predefinito è il centro del rettangolo del contenitore. Il vettore è una frazione (0,0 - 1,0) della larghezza e dell'altezza dell'immagine.
Grandezza Vector2D. Dimensioni dell'immagine. Il valore predefinito è la dimensione in pixel dell'immagine. Può essere specificato in coordinate o percentuali assolute.
Src stringa. URL di un'immagine da caricare per i riempimenti di immagini e motivi. Questo attributo deve essere sempre presente e puntare a dati di immagine validi per la visualizzazione di un'immagine.
Digitare VgFillType. Può essere uno dei tipi seguenti:
  • Sfondo
  • Cornice
  • Gradiente
  • GradientCenter
  • GradientRadial
  • GradientTitle
  • GradientUnscaled
  • Modello
  • Solido
  • Tegola
Tile, Pattern e Frame richiedono che gli attributi dell'immagine vengano forniti. Gradient e GradientRadial richiedono che vengano forniti gli attributi sfumatura.

Elemento Group

Un gruppo è una raccolta di singole forme che possono essere posizionate e trasformate come unità.

Attributo Descrizione
Articolo IVgShape. Elemento specificato nella matrice di forme.
Lunghezza integer. Numero di forme in questo gruppo.

Elemento Imagedata

Descrive un'immagine di cui eseguire il rendering sopra una forma.

Attributo Descrizione
BiLevel VgTriState. Visualizzare l'immagine solo in due colori (in genere nero e bianco).
BlackLevel VgFraction. Consente di impostare il livello in modo che i neri vengano visualizzati come veri neri e tutti gli altri colori sono visibili come sfumature sopra il nero.
Chromakey IVgColor. Colore trasparente dell'immagine.
CropBottom VgNumber. Ritagliare la distanza dal basso dell'immagine espressa come percentuale di dimensioni dell'immagine.
CropLeft VgNumber. Distanza di ritaglio dal bordo sinistro dell'immagine espressa come frazione di dimensioni dell'immagine (da 0,0 a 1,0). Tuttavia, il "ritaglio in uscita" è supportato e pertanto sono supportati valori minori di 0 e maggiori di 1; Ad esempio, -5, 20 ritaglia i limiti 25X delle dimensioni dell'immagine con 4/5 su un lato dell'immagine.
CropRight VgNumber. Ritagliare la distanza da destra dell'immagine espressa come percentuale di dimensioni dell'immagine.
CropTop VgNumber. Distanza di ritaglio dall'inizio dell'immagine espressa come percentuale di dimensioni dell'immagine.
RilievoColor IVgColor. Questa proprietà è impostata su una percentuale del colore dell'ombreggiatura per creare un effetto immagine in rilievo.
Guadagnare VgPositiveNumber. Regola l'intensità di tutti i colori. Essenzialmente imposta la luminosità del bianco. È compreso tra 0 e 32767.
Gamma VgFraction. Correzione gamma. Aumentando, l'immagine aumenta il contrasto.
Gradazioni di grigio VgTriState. Visualizzare l'immagine in colori in scala di grigi.
Src stringa. URL di un'immagine da caricare per i riempimenti di immagini e motivi. Questo attributo deve essere sempre presente e puntare a dati di immagine validi per la visualizzazione di un'immagine.

Elemento Path

Definisce il percorso che costituisce la forma, utilizzando una stringa che contiene un set completo di comandi di "spostamento penna".

Limousine IVgVector2D. Definisce il punto in cui viene allungata la forma; Ad esempio, per una forma giraffe, il punto di limo sarà sul collo, quindi quando la forma viene ridimensionata, il collo si allunga e il resto della forma manterrà le sue dimensioni.
TextBoxRect IVgFixedRectangleArray. Matrice contenente i rettangoli che definiscono dove deve andare il testo.
V stringa. Corrisponde all'attributo v nel tag Path. Si noti che il percorso può corrispondere all'attributo o all'elemento Path.
Valore stringa. Rappresentazione testuale dei comandi che definiscono il percorso. I valori delle coordinate X o y possono essere un riferimento a una formula nel formato "@#" dove # è il numero ordinale della formula, ad esempio "@2". Questa stringa di attributi è costituita da un set completo di comandi, tra cui:
Comando Descrizione
ae (angleellipseto) centrale(x,y) (w,h) angolo iniziale, angolo finale
Disegnare un segmento di un'ellisse. Una linea retta viene tracciata dal punto corrente al punto iniziale del segmento.
al (angleelipse) Uguale a ae, ad eccezione del fatto che c'è un m implicito al punto iniziale del segmento.
ar (arco) Uguale a a. Tuttavia, un nuovo sottopercorso viene avviato da un m implicito al punto iniziale dell'arco.
at (arcto) sinistra, superiore , destra, inferiore, avviare(x,y) fine(x,y)
I primi quattro valori definiscono il rettangolo delimitatore di un'ellisse. Gli ultimi quattro definiscono due vettori radiali. Un segmento dell'ellisse viene disegnato che inizia in corrispondenza dell'angolo definito dal vettore del raggio iniziale e termina in corrispondenza dell'angolo definito dal vettore finale. Una linea retta viene disegnata dal punto corrente all'inizio dell'arco. L'arco viene sempre disegnato in direzione antiorario.
c (curveto) control1(x,y) control2(x,y ) a(x,y)
Disegnare una curva di bézier cubica dal punto corrente alla coordinata data dai due parametri finali, i punti di controllo specificati dai primi quattro parametri. Il punto corrente diventa l'endpoint del bézier.
e (fine) Terminare il set corrente di percorsi secondari. Un determinato set di sottopercorso (come delimitato dalla fine) viene riempito usando eofill. I set successivi di percorsi secondari vengono riempiti in modo indipendente e sovrapposti a quelli esistenti.
l (lineto) x,y
Disegnare una linea dal punto corrente alla coordinata x,y specificata, che diventa il nuovo punto corrente. È possibile specificare coppie di coordinate aggiuntive per formare una polilinea, ad esempio "l 10,13,45,27,89,-12".
m (moveto) x,y
Avviare un nuovo sottopercorso in corrispondenza della coordinata x,y specificata.
nf (nofill) Il set corrente di sottopercorso (delimitato per fine) non verrà riempito.
ns (nostroke) Il set corrente di sottopercorso (delimitato per fine) non verrà tracciato.
qb (quadraticbezier) (punto di controllo(x, y)*,fine(x,y)
Definisce una o più curve di bézier quadratiche tramite punti di controllo e un endpoint. I punti intermedi (su curva) vengono ottenuti tramite interpolazione tra punti di controllo successivi simili ai tipi di carattere TrueType. Il sottopercorso non deve essere un inizio, nel qual caso il sottopercorso è chiuso e l'ultimo punto definisce il punto iniziale.
qx (ellitticoquadrantx) fine(x,y)
Un quarto di ellisse viene disegnato dal punto corrente all'endpoint specificato. Il segmento ellittico è inizialmente tangente a una linea parallela all'asse x; ad esempio, il segmento inizia orizzontalmente.
qy (ellipticalquadranty) fine(x,y)
Uguale a qx ad eccezione del fatto che il segmento ellittico è inizialmente tangente a una linea parallela all'asse y; ad esempio, il segmento inizia verticalmente.
r (rlineto) x,y
Disegnare una linea dal punto corrente alla coordinata relativa (cpx + x, cpy + y). Se vengono fornite coppie di coordinate aggiuntive, ogni nuovo punto viene calcolato rispetto all'ultimo.
t (rmoveto) x,y
Avviare un nuovo sottopercorso in corrispondenza delle coordinate relative ( cpx + x, cpy + y) dove cpx, cpy è la posizione corrente.
v (curveto) control1(x,y) control2(x,y) da a (x,y)
Curva di bézier cubica che usa le coordinate indicate rispetto al punto corrente. Tutti i punti vengono calcolati rispetto allo stesso punto iniziale.
wa (clockwisearcto) Uguale a ma l'arco viene disegnato in senso orario.
wr (in senso orario) Uguale a ar ma viene disegnato in senso orario.
x (chiudi) Chiudere il sottopercorso corrente disegnando una linea retta dal punto corrente al punto di spostamento originale.

Elemento Shadow

Descrive un effetto ombreggiatura su una forma.

Colore IVgColor. Colore dell'ombreggiatura primaria. Il valore predefinito è RGB(128,128,128)
Color2 IVgColor. Colore della seconda ombreggiatura, o evidenziazione in un'ombreggiatura in rilievo o incisa. Il valore predefinito è RGB(203,203,203).
Matrice IvgSkewMatrix. Matrice di trasformazione prospettica nel formato "sxx,sxy,syx,syy,px,py" [s=scale, p=perspective]. Gli elementi s specificano il modo in cui l'ombreggiatura deve essere ridimensionata rispetto alla forma e gli elementi p specificano la modalità di asimmetria dell'ombreggiatura rispetto alla forma. Ad esempio, la matrice seguente ridimensiona la forma in base a un fattore pari a 2 e la sfasa in base a un fattore 4 in tutte le direzioni:
"2,2,2,2,4,4"
Questa matrice viene usata solo se il tipo di ombreggiatura è impostato sulla prospettiva.
Oscurato VgTriState. L'ombreggiatura può essere visualizzata se non c'è riempimento sulla forma. Il valore predefinito è False.
Compensare IVgSkewOffset. Quantità di offset x,y rispetto alla posizione della forma. Il valore predefinito è "2pt,2pt".
Offset2 Vector2D. Quantità di offset x,y secondo rispetto alla posizione della forma. I valori sono una misura assoluta o un valore frazionaria della forma (da-0,5 a +0,5).
Su VgTriState. Attiva e disattiva la visualizzazione dell'ombreggiatura.
Opacità VgFraction. Opacità dell'effetto ombreggiatura.
Origine Vector2D Coppia di valori frazionari della forma da -0,5 a +0,5.
Digitare VgShadowType. I valori sono:
  • Single (impostazione predefinita)
  • Doppio
  • Prospettiva
  • ShapeRelative
  • DisegnoRelative
  • Coniare

Elemento asimmetria

Descrive un effetto di asimmetria prospettica su una forma. L'asimmetria viene applicata ai dati grafici vettoriali, non ai dati dell'immagine.

Attributo Descrizione
Matrice IVgSkewMatrix. Matrice di trasformazione prospettica nel formato "sxx,sxy,syx,syy,px,py" [ s=scale, p=perspective]. Se l'offset è in unità assolute, px,py sono emu ^ -1 unità; in caso contrario, sono una frazione inversa delle dimensioni della forma.
Compensare IvgSkewOffset. Quantità di offset x,y rispetto alla posizione della forma. Il valore predefinito è "2pt,2pt".
Su VgTriState. Attiva o disattiva la visualizzazione dell'asimmetria.
Origine Vector2D. Coppia di valori frazionari della forma da -0,5 a +0,5.

Elemento Stroke

Descrive come disegnare il percorso se si desidera un elemento oltre una linea a tinta unita con un colore a tinta unita.

Colore VgTriState. Colore della linea. Uguale all'attributo StrokeColor in Shape, ma ne esegue l'override.
Color2 IVgColor. Colore secondario. Utilizzato quando FillType è Pattern.
DashStyle VgLineDashStyle. Formato stile trattino. Può essere un valore specifico o una sequenza di numeri con un modello trattino definito dall'utente. I valori sono:
  • Solid (impostazione predefinita)
  • ShortDash
  • ShortDot
  • ShortDashDot
  • ShortDashDotDot
  • Punto
  • Lineetta
  • DashDot
  • LongDash
  • LongDashDot
  • LongDashDotDot
EndArrow VgArrowheadStyle. Punta della freccia per la fine della linea. I valori sono:
  • Nessuno (impostazione predefinita)
  • Blocco
  • Classico
  • Diamante
  • Ovale
  • Aperto
  • Gallone
  • DoubleChevron
EndArrowLength VgArrowHeadLength. Lunghezza della punta della freccia per la fine della linea. I valori sono:
  • Corto
  • Medio (impostazione predefinita)
  • Lungo
EndArrowWidth VgArrowheadWidth. Larghezza della punta della freccia per la fine della linea. I valori sono:
  • Stretto
  • Medio (impostazione predefinita)
  • Largo
EndCap VgLineEndCapStyle. I valori sono:
  • Appartamento
  • Quadrato
  • Rotondo
FillType VgLineFillType. I valori sono:
  • Solid (impostazione predefinita)
  • Tegola
  • Modello
  • Cornice
ImageAlignShape VgTriState. Allineare l'immagine alla forma. Se False, allineare l'immagine alla finestra.
ImageAspect VgAspectType. L'attributo ImageSize verrà modificato per mantenere l'aspetto dell'immagine. I valori includono:
Valore Descrizione
Ignorare Ignorare i problemi relativi all'aspetto.
AtLeast L'immagine è almeno grande quanto le dimensioni dell'immagine.
AtMost L'immagine non è maggiore delle dimensioni dell'immagine.

ImageSize Vector2D. Dimensioni dell'immagine con cui formare il pennello. Il valore predefinito è la dimensione dell'immagine.
JoinStyle VgLineJoinStyle. I valori sono:
  • Arrotondamento (articolazione arrotondata)
  • Rilievo (giunzione smussata)
  • Miter (articolazione miter)
LineStyle VgLineStyle. I valori sono:
  • Singolo
  • ThinThin (1:1:1)
  • ThinThick (1:1:2)
  • ThickThin (2:1:1)
  • ThickBetweenThin (1:1:2:1:1)
MiterLimit lunghezza. Distanza massima tra il punto interno e il punto esterno di un'articolazione. Questo numero è un multiplo dello spessore della linea. È compreso tra 0 e 32.767.
Su VgTriState. Attiva e disattiva la visualizzazione della linea. Uguale all'attributo Stroke in Shape ma ne esegue l'override.
Opacità VgFraction. Opacità del tratto.
Src Corda. URL di un'immagine da caricare per i riempimenti di immagini e motivi. Questo attributo deve essere sempre presente e puntare a dati di immagine validi per la visualizzazione di un'immagine.
StartArrow VgArrowheadStyle. Punta della freccia per l'inizio della linea. I valori sono:
  • Nessuno (impostazione predefinita)
  • Blocco
  • Classico
  • Diamante
  • Ovale
  • Aperto
  • Gallone
  • DoubleChevron
StartArrowLength VgArrowHeadLength. Lunghezza della punta della freccia per l'inizio della linea. I valori sono:
  • Corto
  • Medio (impostazione predefinita)
  • Lungo
StartArrowWidth VgArrowheadWidth. Larghezza della punta della freccia per l'inizio della linea. I valori sono:
  • Narrow Medium (impostazione predefinita) Wide
Peso VgLength. Larghezza della linea. È compreso tra 0 e 1584.

Nota:
L'attributo DashStyle consente all'utente di specificare un modello trattino definito personalizzato. Questa operazione viene eseguita usando una serie di numeri. Gli stili trattino sono definiti in termini di lunghezza del trattino (parte disegnata del tratto) e della lunghezza dello spazio tra i trattini. Le lunghezze sono relative alla larghezza della linea; una lunghezza pari a "1" è uguale alla larghezza della linea. Lo stile EndCap viene applicato a ogni trattino, gli stili freccia non sono. La stringa definisce prima la lunghezza del trattino, quindi la lunghezza dello spazio. Questo può essere ripetuto per formare stili trattini complessi. La stringa deve contenere sempre una coppia di numeri; se contiene un numero dispari di numeri, l'ultimo può essere ignorato. Nella tabella seguente sono elencati alcuni valori tipici e una descrizione dell'effetto previsto. "0" implica un punto che deve essere simmetrico quattro volte (con estremità arrotondate dovrebbe essere un cerchio). Se l'estremità finale della riga è Flat, un visualizzatore deve scegliere un trattino del sistema operativo predefinito laddove possibile (ad esempio, qualcosa che è veloce da disegnare). Di seguito sono riportati alcuni esempi.

"2 2" trattini brevi (ogni trattino e lo spazio tra è due volte la larghezza della linea)
"1 2" punto (ogni trattino è la larghezza della linea mentre ogni spazio è due volte la larghezza della linea)
"4 2" trattino (ogni trattino è quattro volte la larghezza della linea mentre ogni spazio è due volte la larghezza della linea)
"8 2" trattino lungo
"4 2 1 2" trattino punto
"8 2 1 2" punto trattino lungo
"8 2 1 2 1 2" punto punto trattino lungo

Elemento TextPath

Descrive un percorso vettoriale basato sui dati di testo, sul tipo di carattere e sugli stili forniti. Il percorso di testo viene modificato in modo da essere conforme a un elemento Path, se specificato.

Attributo Descrizione
FitPath VgTriState. Ridimensiona il testo per riempire il percorso su cui si trova.
FitShape VgTriState. Estende il percorso di testo verso i bordi della casella della forma.
Su VgTriState. Determina se i percorsi dei caratteri vengono visualizzati o meno.
Corda Corda. Testo di cui eseguire il rendering come percorso di testo.
Tagliare VgTriState. Rimuove gli eventuali spazi aggiuntivi riservati per ascender e discendenti, se non usati.
XScale VgTriState. Usare la misura x dritta invece di misurare lungo il percorso.

Tipi di dati usati nel modello a oggetti VML

I tipi di dati seguenti vengono usati dal modello a oggetti VML.

tipo di dati Double

Intero a precisione doppia con intervallo compreso tra -infinity e infinito.

tipo di dati fisso

Numero a virgola mobile con intervallo compreso tra -32.766.0 e 32.766.0.

tipo di dati Integer

Intero con un intervallo compreso tra -infinity e infinito.

tipo di dati IVgAdjustments

Raccolta di regolazioni a una forma che può essere utilizzata per modificare le dimensioni di una forma. Le regolazioni possono essere usate come segnaposto temporanei o per qualsiasi motivo si userebbero variabili. Ci sono solo 8 regolazioni nella raccolta.

Attributo Descrizione
Esiste IVgTriState. Determina se esiste una regolazione specificata. Si noti che è necessario utilizzare un indice; ovvero, exists( item ) deve essere usato per recuperare l'esistenza di un elemento.
Articolo long. Matrice di rettifiche indicizzate da 0 a 7. Si noti che le rettifiche possono essere specificate in modo sparce; ovvero, i valori di matrice intermedia potrebbero non essere sempre riempiti. Ad esempio, l'elemento 1, 3 e 5 potrebbe avere valori per una lunghezza pari a 3, con item(0), item(2) e item(4) specificati. Per verificare se esiste un elemento, usare l'attributo Exists.
Lunghezza integer. Numero di rettifiche. Non può essere maggiore di 8.
Valore stringa. Rappresentazione testuale di valori numerici, con virgole tra ogni numero.

IVgColor

Specifica un colore.

Attributi Descrizione
RGB VgRGBType. Valore RGB (Long) del colore. Valido solo se Type è RGB.
R integer. Componente rosso del colore. Può variare tra 0 e 255.
G integer. Componente verde del colore. Può variare tra 0 e 255.
B integer. Componente blu del colore. Può variare tra 0 e 255.
Corda stringa. Rappresentazione testuale del colore. Sono supportati i tipi di colore denominati seguenti:
  • Nero (#000000)
  • Silver (#C0C0C0)
  • Grigio (#808080)
  • Bianco (#FFFFFF)
  • Maroon (#800000)
  • Rosso (#FF0000)
  • Viola (#800080)
  • Fucsia (#FF00FF)
  • Verde (#008000)
  • Lime (#00FF00)
  • Olive (#808000)
  • Giallo (#FFFF00)
  • Marina (#000080)
  • Blu (#0000FF)
  • Teal (#008080)
  • Aqua (#00FFFF)
Digitare VgColorType. Tipo di colore. Uno dei tipi seguenti:
  • Misto
  • Denominato
  • RGB
  • Schema

IVgEquation

Equazioni usate per le formule.

Operazione VgEquationOperationType Nome dell'operazione da eseguire sui parametri. In un'equazione è possibile usare le operazioni seguenti:
Operazione Descrizione
Abs Valore assoluto.
abs(v)
Atan2 Risultati aritmetici polari in unità fd (gradi moltiplicati per 65536).
atan2(p1,v)
Perché Coseno, argomento in unità fd (gradi moltiplicati per 65536).
v * cos(p1)
Cosatan2 Mantiene l'accuratezza completa nel calcolo intermedio.
v * cos(atan2( p2,p1 ))
Ellisse Ellisse
Se Test della condizione If. v > 0 ? p1 : p2
Max Maggiore di due valori.
max(v,p1)
Metà Media ( v + p1)/2
Min Minore di due valori. min(v,p1)
Mod Modulo.
Prodotto Utilizzato per la moltiplicazione e la divisione. v * p1 / p2
Peccato Seno, argomento in unità fd (gradi moltiplicati per 65536).
v * sin(p1)
Sinatan2 Mantiene l'accuratezza completa nel calcolo intermedio. v * sin(atan2(p2,p1))
Sqrt Il risultato è positivo e arrotonda verso il basso.
sqrt(v)
Somma Utilizzato per l'addizione e la sottrazione.
v + p1 p2
Sumangle Angolo esistente (ridimensionato da 65536), dove p1 e p2 sono in gradi.
v + p1 * 65536 + p2 * 65536
Abbronzatura Tangente, l'argomento è espresso in unità fd (gradi moltiplicati per 65536).
v * tan( p1 )
Val Definisce un valore di guida da un altro valore.

Param1 integer. Primo parametro.
Paramtype1 VgFormulaParamType. Tipo del primo parametro. Sono supportati i valori seguenti:
Digitare Descrizione
Valore Il parametro è un valore semplice.
AdjustmentReference Il parametro è un riferimento a una regolazione. Ad esempio, se il primo parametro è 1, verrà utilizzato il valore della prima regolazione.
FormulaReference Il parametro è il risultato di un riferimento al risultato di una formula precedente. Ad esempio, se il primo parametro è 2, verrà usato il risultato della formula 2.

Param2 integer. Secondo parametro.
Paramtype2 VgFormulaParamType Tipo di parametro 2.
Val integer. Il risultato.
Valtype2 VgFormulaParamType. Tipo del risultato.

IVgFixedRectangle

Specifica un rettangolo fisso.

Attributo Descrizione
Valore stringa. Valore di testo che specifica il percorso.
A sinistra double. Coordinata più a sinistra del rettangolo.
In alto double. Coordinata superiore del rettangolo.
A destra double. Coordinata più a destra del rettangolo.
Fondoschiena double. Coordinata più in basso del rettangolo.

IVgFixedRectangleArray

Matrice di rettangoli fissi.

Attributo Descrizione
Valore stringa. Rappresentazione testuale della matrice.
Lunghezza integer. Numero di rettangoli in questa matrice.
Articolo IVgFixedRectangle. Oggetto rettangolo in corrispondenza dell'indice specificato.

tipo di dati IVgFormula

Definizioni per formule che possono variare il percorso di una forma o essere utilizzate per altri scopi di calcolo. Le formule possono essere basate sull'attributo Adj di una forma, che può cambiare. Le formule possono anche fare riferimento ad altre formule.

Attributo Descrizione
Eqn IVgEquation. Ogni formula definisce un singolo valore come risultato della valutazione dell'espressione. L'espressione è definita da questo attributo e ha la forma generale di un'operazione seguita da un massimo di tre argomenti, che possono essere valori di regolazione (ad esempio, #2), i risultati delle formule precedenti (ad esempio @2), numeri fissi o valori predefiniti.

tipo di dati IVgFormulas

Insieme di oggetti formula.

Attributo Descrizione
Lunghezza integer. Numero di oggetti formula nell'insieme.
Articolo IVgFormula. Formula specifica. Si noti che la matrice di formule può essere ereditata per il tipo di forma.

IVgGradientColorArray

Matrice di colori che definiscono una sfumatura (intervallo di colori misto).

Attributo Descrizione
Valore stringa. Specifica la matrice di colori; ad esempio " rosso .2; verde .4; nero .7"
Lunghezza integer. Numero di colori nella matrice.
Metodo Descrizione
AddColor VgFraction. Aggiunge un nuovo colore in corrispondenza dell'endpoint specificato dalla frazione. Il nuovo colore è bianco per impostazione predefinita ed è il valore restituito. Il colore può quindi essere modificato in base al riferimento.
RemoveColor VgFraction. Rimuove un colore in corrispondenza dell'endpoint specificato dalla frazione. Nota: se 0.0 o 1.0 non esiste, è implicito e il colore bianco viene usato a quel punto.

tipo di dati IVgPoints

Matrice di punti che definiscono una forma.

Attributo Descrizione
Valore stringa. Rappresentazione testuale della matrice.
Lunghezza integer. Numero di punti in questa matrice.
Articolo IVgVector2D. Punto in corrispondenza dell'indice specificato.

tipo di dati IVgSkewMatrix

Matrice usata per l'asimmetria delle forme, una matrice di trasformazione prospettica nel formato "sxx,sxy,syx,syy,px,py " [s =scale, p =perspective]. Se l'offset è in unità assolute, px,py sono emu ^-1 unità; in caso contrario, sono una frazione inversa delle dimensioni della forma.

Attributo Descrizione
XtoX double.
YtoX double.
XtoY double.
YtoY double.
PerspectiveX double.
PerspectiveY double.

IVgSkewOffset

Specifica l'offset dell'asimmetria.

Attributi Descrizione
Valore stringa. Rappresentazione testuale dell'offset.
X double. Componente X. Percentuale o misura. Se nessuna unità di misura, il tipo ShapeRelative è implicito; in caso contrario, il tipo Assoluto è implicito.
Y double. Componente Y.
Digitare VgSkewTransformType. Specifica il tipo di trasformazione. I valori validi sono punti interi compresi tra -infinity e infinito.
Digitare Descrizione
ShapeRelative I valori dell'offset sono percentuali (rapporti) delle dimensioni della forma originale; Ad esempio, un valore pari a 0,5 indica una metà della dimensione della forma.
Assoluto I valori sono unità assolute.

tipo di dati IVgVector2D

Specifica un vettore bidimensionale costituito da due numeri double.

Attributi Descrizione
Valore stringa. Rappresentazione testuale di entrambi i numeri vettoriali separati da uno spazio.
X double. Componente X di questo vettore.
Y double. Componente Y di questo vettore.
Digitare VgVectorType. Unità previste per questo vettore. I valori sono:
  • Misura
  • Lunghezza
  • AngleInDegrees
  • Frazione
  • Numero intero percentuale

tipo di dati IVgVector3D

Specifica un vettore tridimensionale costituito da tre numeri double.

Valore stringa. Rappresentazione testuale di tre numeri vettoriali separati da uno spazio.
X double. Componente X di questo vettore.
Y double. Componente Y di questo vettore.
Z double. Componente Z di questo vettore.
Digitare VgVectorType. Unità previste per questo vettore. I valori sono:
  • Misura
  • Lunghezza
  • AngleInDegrees
  • Frazione
  • Numero
  • Percentuale
  • Numero intero

tipo di dati Length

Numero a virgola mobile con un intervallo compreso tra 0 e infinito.

Tipo di dati Measure

Numero a virgola mobile da -infinity a infinito.

tipo di dati String

Dati di tipo carattere di qualsiasi lunghezza.

VgBlackWhiteMode

Modalità di rendering per bianco e nero. I valori possibili sono:

  • Color
  • automatico
  • grayscale
  • lightGrayScale
  • inverseGray
  • GrayOutline
  • BlackTextAndLines
  • HighContrast
  • nero
  • bianco
  • non ritirata

tipo di dati VgFraction

Numero a virgola mobile con intervallo compreso tra 0,0 e 1,0. Le frazioni possono essere specificate anche come percentuale; ad esempio "50%".

tipo di dati VgTriState

Enumerazione usata per i valori che possono essere uno dei tre stati seguenti:

  • TRUE
  • false
  • MIXED