Partager via

Référence du modèle objet VML

Cette rubrique décrit VML, une fonctionnalité déconseillée à partir de Windows Internet Explorer 9. Les pages web et les applications qui s’appuient sur VML doivent être migrées vers SVG ou d’autres normes largement prises en charge.

Notes

Depuis décembre 2011, cette rubrique a été archivée. Par conséquent, il n’est plus activement géré. Pour plus d’informations, consultez Contenu archivé. Pour obtenir des informations, des recommandations et des conseils concernant la version actuelle de Windows Internet Explorer, consultez Centre de développement Internet Explorer.

Dans cette rubrique :

Introduction

Le langage VML (Vector Markup Language) est un langage textuel qui utilise XML pour étendre le code HTML afin d’afficher des informations graphiques vectorielles. Le DOM (Document Object Model) VML définit une interface programmatique pour la manipulation des éléments du document. Cela permet à l’utilisateur de créer et de modifier dynamiquement des graphiques vectoriels via une interface indépendante de la plateforme et du langage. Le DOM VML est conforme à la spécification du modèle objet document .

VML utilise l’élément Shape comme bloc de construction de base pour les images graphiques vectorielles. Une fois qu’une forme est créée, vous pouvez la modifier à l’aide d’attributs ou de sous-éléments attachés. Par exemple, pour modifier la couleur d’une forme, affectez une valeur de couleur à l’attribut FillColor .

myshape.fillcolor = "red"

Plusieurs attributs d’une forme sont également des sous-éléments et ont leurs propres attributs, notamment les suivants :

L’om VML utilise plusieurs types de données pour définir des paramètres. Les types de données préfixés avec « Vg » sont des énumérations et ceux qui ont le préfixe « IVg » sont des objets. Cliquez ici pour obtenir une liste. Les types de données mineurs sont répertoriés avec des paramètres spécifiques.

Exemple

Le code VBScript suivant montre comment créer une forme simple :

        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"

Dans l’exemple ci-dessus, une forme est créée à l’aide de la méthode CreateElement du modèle objet document. La forme est une forme Rect prédéfinie VML. Même si l’objet existe, il ne peut pas faire partie du document tant qu’il n’est pas joint au document. À l’aide de la méthode AppendChild , rect est un enfant d’un élément DIV appelé MyDiv. Quelques attributs de style minimum (Position, Width, Height, Top, Left) sont définis pour donner à la forme une taille spécifique. Enfin, une couleur est affectée avec l’attribut FillColor . Notez que n’importe quel langage de script ou tout langage pouvant fonctionner avec les interfaces de modèle objet document peut être utilisé.

Configuration de VML

Une implémentation de VML est via Microsoft Internet Explorer 5.0 ou version ultérieure. Pour configurer correctement l’objet de rendu dans une page Web, les ajouts suivants doivent être effectués :

  1. Le schéma doit être configuré dans la balise HTML> initiale <comme suit :

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

  2. Le comportement de rendu doit faire partie du style du document :

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

L’exemple suivant montre un exemple de page Web HTML correctement configuré pour VML montrant la création dynamique d’une forme.

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

Notez que dans les versions bêta, une balise d’objet ActiveX et un style de comportement différent étaient nécessaires.

Informations de référence sur le modèle om VML

Cette référence définit l’élément Shape , les sous-éléments et lestypes de données utilisés par le modèle objet de VML.

Élément Shape

Les formes sont les blocs de construction d’images graphiques définis par Le langage VML (Vector Markup Language). La forme est l’élément de niveau supérieur et plusieurs sous-éléments permettent de définir la nature de chaque forme.

VML fournit des formes prédéfinies :

Attributs de forme

  • Arc
  • Courbe
  • Ligne
  • Polyligne
  • Rect
  • RoundRect
Sous-élément Description
Adj IVgAdjustments. Liste de nombres délimités par des virgules qui sont les paramètres des formules de repère qui définissent le chemin de la forme. Les valeurs peuvent être omises pour autoriser l’utilisation des valeurs par défaut. Il peut y avoir jusqu’à 8 valeurs d’ajustement.
Alt Chaîne. Texte de remplacement associé à la forme. Utilisé pour la navigation non graphique.
Bouton VgTriState. Affiche le comportement du bouton lors du clic.
BWMode VgBlackWhiteMode. Détermine comment la forme s’affichera en mode noir et blanc dans les applications ou lors de l’impression sur des imprimantes en noir et blanc. Les valeurs sont les suivantes : Color, Auto, GrayScale, LightGrayScale, InverseGray, GrayOutline, BlackTextAndLines, HighContrast, Black, White, Undrawn. Par défaut : Auto.
BWNormal VgBlackWhiteMode. Lorsque BWMode a la valeur Auto, cette propriété est consultée pour savoir comment restituer la forme en noir et blanc normal. Les valeurs sont les suivantes : Color, Auto, GrayScale, LightGrayScale, InverseGray, GrayOutline, BlackTextAndLines, HighContrast, Black, White, Undrawn. Par défaut : Auto.
BWPure VgBlackWhiteMode. Lorsque BWMode a la valeur Auto, cette propriété est consultée pour savoir comment restituer la forme en mode B/W pur. Les valeurs sont les suivantes : Color, Auto, GrayScale, LightGrayScale, InverseGray, GrayOutline, BlackTextAndLines, HighContrast, Black, White, Undrawn. Par défaut : Auto.
ChildShapes IVgGroupShapes. Collection d’autres formes de ce groupe. Cette collection prend en charge les méthodes Length et Item standard.
Chromakey IVgColor. Valeur de couleur qui sera transparente et qui affichera tout ce qui se trouve derrière la forme.
Control1 Vector2D. Point de contrôle pour la courbe.
Control2 Vector2D. Point de contrôle pour la courbe.
CoordOrigin Vector2D Coordonnées situées dans le coin supérieur gauche du rectangle de conteneur. Plage comprise entre 0 et l’infini.
CoordSize Vector2D. Largeur et hauteur de l’espace de coordonnées à l’intérieur du rectangle de référence de cette forme. Si elle n’est pas spécifiée, elle est identique à la largeur et à la hauteur du rectangle. Plage comprise entre 0 et l’infini. Valeur par défaut : « 1000,1000 ».
EndAngle VgAngleInDegrees. Angle de fin de forme.
Extrusion IVgExtrusion. Spécifie la valeur de l’objet Extrusion pour cette forme. Pour plus d’informations, consultez l’élément Extrusion .
Remplir VgFillFormat. Spécifie la valeur de remplissage pour cette forme. Pour plus d’informations, consultez l’élément Fill .
FillColor IVgColor. Couleur principale du pinceau à utiliser pour remplir le chemin de cette forme.
Rempli VgTriState. Si la valeur est True, le chemin d’accès définissant la forme est rempli. Par défaut, il est rempli à l’aide d’une couleur unie, sauf s’il existe un sous-élément Fill qui spécifie des propriétés de remplissage plus complexes. Si la valeur est False, le remplissage est transparent.
Flip VgFlipOrientation. Les valeurs sont les suivantes : X Y YY YX
ForceDash VgTriState. Indication qu’un contour en pointillés doit être affiché lorsqu’il n’y a pas de trait ni de remplissage pour une forme. Ce comportement est généralement utile pour rendre les formes invisibles visibles dans les applications d’édition afin qu’elles puissent être sélectionnées et exploitées, par exemple dans une carte d’image.
Formules IVgFormulas. Tableau de formules qui définit une forme.
Du Vector2D. Point de départ de la ligne.
Href Chaîne. URL à laquelle accéder si l’utilisateur clique sur cette forme.
ImageData IVgImageData. Informations d’image si la forme est une image. Pour plus d’informations, consultez l’élément ImageData.
OnEd VgTriState. Masque toutes les poignées à l’exception du haut à gauche et du bas à droite, comme dans les poignées d’un segment de ligne droite.
Opacity VgFraction. Opacité de la forme entière. Nombre compris entre 0,0 et 1,0.
Chemin d’accès IVgPath. Chaîne contenant les commandes qui définissent le chemin d’accès.
Points IVgPoints. Collection de points définissant une forme.
Imprimer VgTriState. Si la valeur est True, cette forme est destinée à être imprimée.
Rotation VgAngleInDegrees. Définit la rotation de la forme. La valeur est propagée au style de forme.
Scale Vector2D. Échelle de forme.
Shadow IVgShadow. Spécifie l’ombre de cette forme. Pour plus d’informations, consultez l’élément Shadow .
Spt Réservé.
StartAngle VgAngleInDegrees. Angle de début de forme.
Trait VgStrokeFormat. Pour plus d’informations, consultez Élément Stroke.
StrokeColor IVgColor. Couleur principale du pinceau à utiliser pour tracer le chemin de cette forme.
Caressa VgTriState. Si la valeur est True, le chemin définissant la forme sera tracé.
StrokeWeight VGLength. Largeur du pinceau à utiliser pour tracer le chemin. Varie entre 0 et 1584.
TextPath IVgTextPath. Spécifie l’objet TextPath de la forme. Pour plus d’informations, consultez l’élément TextPath .
À Vector2D. Point de fin de ligne.
Type Chaîne. Type de forme.

Sous-éléments de l’élément Shape

Les sous-éléments suivants font partie du modèle objet VML.

Élément d’arrière-plan

Décrit le remplissage de l’arrière-plan d’une page à l’aide de remplissages VML.

Attribut Description
BWMode VgBlackWhiteMode. Détermine le rendu de la forme en mode noir et blanc dans les applications ou lors de l’impression.
BWNormal VgBlackWhiteMode. Lorsque BWMode est Auto, cette propriété est consultée pour savoir comment restituer la forme en noir et blanc normaux.
BWPure VgBlackWhiteMode. Lorsque BWMode est Auto, cette propriété est consultée pour savoir comment restituer la forme en noir et blanc pur.
Remplir VgFillFormat. Spécifie le remplissage de cette forme. Pour plus d’informations, consultez Élément Fill .
FillColor IVgColor. Couleur principale du pinceau à utiliser pour remplir le chemin de cette forme. Dupliquer la valeur Color dans l’élément Fill. La valeur par défaut est blanc.

Élément d’extrusion

Décrit une extrusion 3D de la forme.

Attributs

AutoRotationCenter VgTriState. Si la valeur est True, le centre de rotation du groupe d’objets 3D (en fait, il n’y a qu’un seul objet dans le groupe) est déterminé automatiquement comme étant le centre du groupe ; sinon, il est déterminé par les paramètres RotationCenter, qui sont une fraction de la forme avec 0,0,0 étant le centre.
BackDepth VgLength. Quantité d’extrusion vers l’arrière. Varie de 0 à 32767.
Luminosité VgPositiveNumber. Luminosité globale de la scène. La valeur par défaut est « 20 000 ».
Couleur IVgColor. Couleur de l’extrusion. Utilisé uniquement si ColorMode est personnalisé. Sinon, Auto définit la couleur de l’effet d’extrusion sur la même que FillColor.
ColorMode Vg3DColorMode. Les valeurs sont les suivantes :
  • Auto (par défaut)
  • Custom
Diffusion VgPositiveNumber. Rapport entre l’incident et la lumière réfléchie de manière diffuse. Les valeurs inférieures à 1.0 sont normales, mais les valeurs supérieures à 1 peuvent générer des effets intéressants.
Edge VgLength. Définit la taille d’un bord biseauté arrondi simulé. Varie de 0 à 32767 en pts à virgule flottante. La valeur par défaut est « 1pt ».
Facette VgPositiveNumber. Définit la facette de la scène. La valeur par défaut est « 30 000 ».
ForeDepth VgLength. Quantité d’extrusion avant. Varie de 0 à 32767.
LightFace VgTriState. Détermine si la face avant de l’objet répond aux modifications de l’éclairage 3D, par exemple, lorsqu’un objet pivote.
LightHarsh VgTriState. Éclairage violent pour la source de lumière primaire. La valeur par défaut est FALSE.
LightHarsh2 VgTriState. Éclairage dur pour la source de lumière secondaire. La valeur par défaut est FALSE.
LightLevel VgNumber. Intensité de la source de lumière primaire. La valeur par défaut est « 38000 ».
LightLevel2 VgNumber. Intensité de la source de lumière secondaire. La valeur par défaut est « 38000 ».
LightPosition Vector3d. Position de la source de lumière primaire. La valeur par défaut est « 50000,0,10000 ».
LightPosition2 Vector3d. Position de la source de lumière secondaire. La valeur par défaut est « -50000,0,10000 ».
LockRotationCenter VgTriState. « Lockrotationcenter » signifie que la rotation du groupe est définie comme étant par l’angle de rotation[1] degrés par rapport à l’axe y sur la page suivi de rotation-angle[0] degrés sur l’axe x. Lorsque LockRotationCenter a la valeur False, la rotation est définie comme étant par des degrés d’angle d’orientation par rapport au vecteur défini par orientation. Ainsi, par exemple, lockrotationcenter=false orientationangle=45 orientation=(0,1,0) équivaut à lockrotationcenter=true rotationangle=(0,45).
Métallique VgTriState. Fait en sorte que la lumière réfléchie de façon spéculaire soit la couleur du matériau au lieu de la couleur de la source de lumière, ce qui rend l’objet plus métallique.
Activé VgTriState. Active et désactive l’affichage de l’effet d’extrusion.
Orientation Vector3d. Orientation de la caméra.
OrientationAngle VgAngleInDegrees. Angle entre l’orientation de la caméra et le plan xy.
Avion Vg3DExtrudePlane. Permet l’extrusion des plans orthogonaux vers le plan d’écran. Nécessite que ForeDepth et BackDepth soient spécifiés en unités de dessin au lieu d’emus. Les valeurs sont les suivantes :
  • XY
  • ZX
  • YZ
Rendu Vg3DRenderMode. Les valeurs sont les suivantes :
  • Unie (par défaut)
  • Wireframe
  • BoundingCube
RotationAngle Vector2D. AngleX, AngleY ou AngleZ est contrôlé par l’attribut ShapeRotation.
RotationCenter Vector3d. Centre de rotation.
Brillance VgPositiveNumber. Détermine la concentration ou la dispersion de la réflexion spéculaire. Une valeur élevée serait de 8 à 10 et se rapprocherait d’un miroir, et une valeur faible serait de 2 à 3 et des vêtements sequinés approximativement. Des valeurs comprises entre 3 et 7 sont recommandées. Les valeurs élevées reflètent les sources de lumière précises.
SkewAmt VgPercentage. Si Type a la valeur Parallel, l’attribut détermine la quantité d’asymétrie. Plages comprises entre 0 et 100.
SkewAngle VgAngleInDegrees. Si Type a la valeur Parallel, l’attribut détermine le degré d’asymétrie. La valeur par défaut est « -45 ».
Specularité VgPositiveNumber. Rapport entre la lumière incidente et la lumière spéculairement réfléchie. Les valeurs inférieures à 1.0 sont normales, mais les valeurs supérieures à 1 peuvent générer des effets intéressants.
Type VgExtrusionType. Les valeurs sont les suivantes :
  • Parallèle (par défaut)
  • Perspective
Vue Vector3d. Point à partir duquel la scène est vue.
Point de vueOrigin Vector2D. Peut avoir des valeurs comprises entre 0,5 et -0,5 pour positionner l’origine du point de vue dans le cadre englobant de la forme.

Élément Fill

Décrit comment un chemin doit être rempli pour les remplissages plus complexes qu’une couleur unie.

Attributs

AlignShape VgTriState. Alignez l’image sur la forme. Si la valeur est False, alignez l’image avec la fenêtre.
Angle VgAngleInDegrees. Angle le long duquel le dégradé passe. 0 degré est le long de l’axe horizontal de gauche à droite.
Aspect VgAspectType. L’attribut ImageSize sera ajusté pour conserver l’aspect de l’image. Ces valeurs comprennent :
Valeur Description
Ignorer Ignorer les problèmes d’aspect.
AtLeast L’image est au moins aussi grande que la taille de l’image.
AtMost La taille de l’image n’est pas supérieure à celle de l’image.

Couleur IVgColor Couleur de remplissage main. Identique à l’attribut FillColor dans la forme.
Couleur2 IVgColor. Couleur secondaire d’un remplissage lorsque le type d’image est Motif ou remplissage dégradé.
Couleurs IVgGradientColorArray. Couleurs intermédiaires dans le dégradé et leurs positions relatives le long du dégradé, par exemple, « 30 % rouge, 70 % bleu, 90 % vert ». La couleur primaire (attribut Color dans la forme) est de 0 % et la couleur secondaire (attribut Color2) est de 100 %.
Priorité VgSignedPercentage. Point focal pour le remplissage en dégradé linéaire. Les valeurs vont de -100 à +100.
FocusPosition Vector2D. Position du rectangle le plus intérieur pour les dégradés radiales. Le vecteur est une fraction (0,0 - 1,0) de la largeur et de la hauteur de la forme.
FocusSize Vector2D Taille du rectangle le plus intérieur pour les dégradés radiales. Le vecteur est une fraction (0,0 à 1,0) de la largeur et de la hauteur de la forme.
Méthode VgSigmaType. Ces valeurs comprennent :
  • None
  • Linéaire
  • Sigma
  • Quelconque

La valeur par défaut est Sigma.
Activé VgTriState. Active l’affichage des remplissages. Identique à l’attribut Fill dans la forme.
Opacity VgFraction. Opacité du remplissage.
Opacité2 VgFraction. Opacité secondaire pour les dégradés.
Origine Vector2D. Pointez par rapport au coin supérieur gauche de l’image qui est traitée comme l’origine de l’image. La valeur par défaut est le centre de l’image. Le vecteur est une fraction (de 0,0 à 1,0) de la largeur et de la hauteur de l’image.
Position Vector2D. Pointez dans le rectangle de référence de la forme pour positionner l’origine de l’image. La valeur par défaut est le centre du rectangle de conteneur. Le vecteur est une fraction (0,0 - 1,0) de la largeur et de la hauteur de l’image.
Taille Vector2D. Taille de l’image. La valeur par défaut est la taille des pixels de l’image. Peut être spécifié en coordonnées absolues ou en pourcentage.
Source Chaîne. URL d’une image à charger pour les remplissages d’images et de motifs. Cet attribut doit toujours être présent et pointer vers des données d’image valides pour qu’une image apparaisse.
Type VgFillType. qui peut être l’un des suivants :
  • Arrière-plan
  • Frame
  • Dégradé
  • GradientCenter
  • GradientRadial
  • GradientTitle
  • GradientUnscaled
  • Modèle
  • Unie
  • Vignette
La vignette, le modèle et l’image nécessitent que les attributs d’image soient fournis. Gradient et GradientRadial nécessitent que les attributs de dégradé soient fournis.

élément Group

Un groupe est une collection de formes individuelles qui peuvent être positionnées et transformées en une unité.

Attribut Description
Élément IVgShape. Élément spécifié dans le tableau de formes.
Longueur Integer. Nombre de formes dans ce groupe.

Élément Imagedata

Décrit une image à afficher au-dessus d’une forme.

Attribut Description
BiLevel VgTriState. Afficher l’image en deux couleurs uniquement (généralement noir et blanc).
BlackLevel VgFraction. Autorise l’ajustement pour définir le niveau afin que les noirs apparaissent comme des noirs vrais, et que toutes les autres couleurs soient visibles sous forme de nuances au-dessus du noir.
Chromakey IVgColor. Couleur transparente de l’image.
CropBottom VgNumber. Rogner la distance du bas de l’image exprimée sous la forme d’un pourcentage de la taille de l’image.
CropLeft VgNumber. Distance de rognage du bord gauche de l’image exprimée en fraction de la taille de l’image (de 0,0 à 1,0). Toutefois, « out-cropping » est pris en charge et, par conséquent, les valeurs inférieures à 0 et supérieures à 1 sont prises en charge ; Par exemple, -5, 20 dépasse les limites 25 fois la taille de l’image avec 4/5 sur un côté de l’image.
CropRight VgNumber. Rogner la distance à partir de la droite de l’image exprimée sous la forme d’un pourcentage de la taille de l’image.
CropTop VgNumber. Rogner la distance du haut de l’image exprimée sous la forme d’un pourcentage de la taille de l’image.
EmbossColor IVgColor. Cette valeur est définie sur un pourcentage de la couleur d’ombre pour créer un effet d’image en relief.
Gain VgPositiveNumber. Ajuste l’intensité de toutes les couleurs. Définit essentiellement la luminosité du blanc. Va de 0 à 32767.
Gamma VgFraction. Correction gamma. L’augmentation donne à une image plus de contraste.
Nuances de gris VgTriState. Afficher l’image en couleurs de nuances de gris.
Source Chaîne. URL d’une image à charger pour les remplissages d’images et de motifs. Cet attribut doit toujours être présent et pointer vers des données d’image valides pour qu’une image apparaisse.

Élément Path

Définit le chemin qui compose la forme, à l’aide d’une chaîne qui contient un ensemble complet de commandes « mouvement du stylet ».

Limousine IVgVector2D. Définit le point où la forme est étirée ; Par exemple, pour une forme de girafe, le point de limousine serait sur le cou de sorte que lorsque la forme est redimensionnée, le cou s’étire et le reste de la forme conservera ses dimensions.
TextBoxRect IVgFixedRectangleArray. Tableau contenant les rectangles qui définissent où le texte doit aller.
V Chaîne. Correspond à l’attribut v sur la balise Path. Notez que path peut correspondre à l’attribut ou à l’élément Path.
Valeur Chaîne. Représentation textuelle des commandes qui définissent le chemin d’accès. Les valeurs de coordonnées X ou y peuvent être une référence à une formule au format « @# » où # est le nombre ordinal de la formule, par exemple « @2 ». Cette chaîne d’attribut est constituée d’un ensemble complet de commandes, notamment les suivantes :
Commande Description
ae (angleellipseto) center(x,y) size(w,h) start-angle, end-angle
Dessinez un segment d’une ellipse. Une ligne droite est dessinée à partir du point actuel jusqu’au point de départ du segment.
al (angleelipse) Identique à ae, sauf qu’il y a un m implicite au point de départ du segment.
ar (arc) Identique à à. Toutefois, un nouveau sous-chemin est démarré par un m implicite jusqu’au point de départ de l’arc.
at (arcto) left, top, right, bottom, start(x,y) end(x,y)
Les quatre premières valeurs définissent le cadre englobant d’une ellipse. Les quatre derniers définissent deux vecteurs radiales. Un segment de l’ellipse est dessiné qui commence à l’angle défini par le vecteur de rayon de début et se termine à l’angle défini par le vecteur de fin. Une ligne droite est dessinée du point actuel au début de l’arc. L’arc est toujours dessiné dans le sens inverse des aiguilles d’une montre.
c (curveto) control1(x,y) control2(x,y) to(x,y)
Dessinez une courbe de bézier cubique à partir du point actuel jusqu’à la coordonnée donnée par les deux derniers paramètres, les points de contrôle donnés par les quatre premiers paramètres. Le point actuel devient le point de terminaison du bezier.
e (fin) Terminez l’ensemble actuel de sous-chemins. Un ensemble donné de sous-chemins (délimités par la fin) est rempli à l’aide de eofill. Les ensembles de sous-chemins suivants sont remplis indépendamment et superposés à ceux existants.
l (lineto) x,y
Dessinez une ligne à partir du point actuel jusqu’à la coordonnée x,y donnée, qui devient le nouveau point actuel. Des paires de coordonnées supplémentaires peuvent être spécifiées pour former une polyligne, par exemple« l 10,13,45,27,89,-12 ».
m (déplacer) x,y
Démarrez un nouveau sous-chemin à la coordonnée x,y donnée.
nf (nofill) L’ensemble actuel de sous-chemins (délimité par la fin) n’est pas rempli.
ns (nostroke) L’ensemble actuel de sous-chemins (délimité par la fin) ne sera pas tracé.
qb (quadraticbezier) (controlpoint(x, y))*,end(x,y)
Définit une ou plusieurs courbes de béziers quadratiques au moyen de points de contrôle et d’un point de terminaison. Les points intermédiaires (on-curve) sont obtenus par interpolation entre des points de contrôle successifs similaires aux polices TrueType. Le sous-chemin n’a pas besoin d’être un début, auquel cas le sous-chemin est fermé et le dernier point définit le point de départ.
qx (ellipticalquadrantx) end(x,y)
Une ellipse quart est dessinée à partir du point actuel vers le point de terminaison donné. Le segment elliptique est initialement tangentiel à une ligne parallèle à l’axe X ; c’est-à-dire que le segment commence horizontalement.
qy (elliptiquequadranty) end(x,y)
Identique à qx, sauf que le segment elliptique est initialement tangentiel à une ligne parallèle à l’axe y ; c’est-à-dire que le segment commence verticalement.
r (rlineto) x,y
Dessinez une ligne à partir du point actuel jusqu’à la coordonnée relative (cpx + x, cpy + y). Si des paires de coordonnées supplémentaires sont fournies, chaque nouveau point est calculé par rapport au dernier.
t (rmoveto) x,y
Démarrez un nouveau sous-chemin aux coordonnées relatives (cpx + x, cpy + y) où cpx, cpy est la position actuelle.
v (courbeto) control1(x,y) control2(x,y) à (x,y)
Courbe de bezier cubique utilisant les coordonnées données par rapport au point actuel. Tous les points sont calculés par rapport au même point de départ.
wa (sens des aiguilles d’une montre) Identique à à, mais l’arc est dessiné dans le sens des aiguilles d’une montre.
wr (dans le sens des aiguilles d’une montre) Identique à ar, mais est dessiné dans le sens des aiguilles d’une montre.
x (fermer) Fermez le sous-chemin actuel en dessinant une ligne droite du point actuel vers le point d’origine moveto.

Élément d’ombre

Décrit un effet d’ombre sur une forme.

Couleur IVgColor. Couleur de l’ombre principale. La valeur par défaut est RVB(128,128,128)
Couleur2 IVgColor. Couleur de la deuxième ombre, ou mise en surbrillance dans une ombre en relief ou gravée. La valeur par défaut est RVB(203,203,203).
Matrice IvgSkewMatrix. Matrice de transformation de perspective sous la forme « sxx,sxy,syx,syx,px,py » [s=scale, p=perspective]. Les éléments s spécifient la façon dont l’ombre doit être mise à l’échelle par rapport à la forme, et les éléments p spécifient la façon dont l’ombre doit s’adapter par rapport à la forme. Par exemple, la matrice suivante redimensionne la forme d’un facteur 2 et la fausse d’un facteur 4 dans toutes les directions :
"2,2,2,2,4,4"
Cette matrice est utilisée uniquement si le type de l’ombre est défini sur perspective.
Obscurci VgTriState. L’ombre peut être vue à travers s’il n’y a pas de remplissage sur la forme. La valeur par défaut est FALSE.
Offset IVgSkewOffset. Quantité de décalage x,y par rapport à l’emplacement de la forme. La valeur par défaut est « 2pt,2pt ».
Offset2 Vector2D. Quantité de décalage x,y seconde par rapport à l’emplacement de la forme. Les valeurs sont soit une mesure absolue, soit une valeur fractionnaire de forme (-0,5 à +0,5).
Activé VgTriState. Active et désactive l’affichage de l’ombre.
Opacity VgFraction. Opacité de l’effet d’ombre.
Origine Vector2D Paire de valeurs fractionnaires de forme comprises entre -0,5 et +0,5.
Type VgShadowType. Les valeurs sont les suivantes :
  • Unique (par défaut)
  • Double
  • Perspective
  • ShapeRelative
  • DessinRelative
  • Relief

Élément Skew

Décrit un effet d’asymétrie de perspective sur une forme. L’asymétrie est appliquée aux données de graphique vectoriel, et non aux données d’image.

Attribut Description
Matrice IVgSkewMatrix. Matrice de transformation de perspective sous la forme « sxx,sxy,syx,syx,px,py » [ s=scale, p=perspective]. Si le décalage est en unités absolues, alors px,py sont en emu ^ -1 unités ; sinon, ils sont une fraction inverse de la taille de la forme.
Offset IvgSkewOffset. Quantité de décalage x,y par rapport à l’emplacement de la forme. La valeur par défaut est « 2pt,2pt ».
Activé VgTriState. Active ou désactive l’affichage de l’asymétrie.
Origine Vector2D. Paire de valeurs fractionnaires de forme comprises entre -0,5 et +0,5.

Élément Stroke

Décrit comment tracer le chemin si quelque chose au-delà d’une ligne unie avec une couleur unie est souhaité.

Couleur VgTriState. Couleur de la ligne. Identique à l’attribut StrokeColor dans Shape, mais le remplace.
Couleur2 IVgColor. Couleur secondaire. Utilisé lorsque FillType a la valeur Pattern.
DashStyle VgLineDashStyle. Format de style tiret. Il peut s’agir d’une valeur spécifique ou d’une séquence de nombres avec un modèle de tiret défini par l’utilisateur. Les valeurs sont les suivantes :
  • Unie (par défaut)
  • ShortDash
  • ShortDot
  • ShortDashDot
  • ShortDashDotDot
  • Points
  • Tiret
  • Tiret-point
  • LongDash
  • LongDashDot
  • LongDashDotDot
EndArrow VgArrowheadStyle. Pointe de flèche pour la fin de la ligne. Les valeurs sont les suivantes :
  • Aucun (par défaut)
  • Bloquer
  • Classique
  • Losange
  • Ovale
  • Ouvrir
  • Chevron
  • DoubleChevron
EndArrowLength VgArrowHeadLength. Longueur de la pointe de flèche pour la fin de la ligne. Les valeurs sont les suivantes :
  • Court
  • Moyenne (par défaut)
  • Long
EndArrowWidth VgArrowheadWidth. Largeur de la pointe de flèche pour la fin de la ligne. Les valeurs sont les suivantes :
  • Étroite
  • Moyenne (par défaut)
  • Large
EndCap VgLineEndCapStyle. Les valeurs sont les suivantes :
  • À deux dimensions
  • Carré
  • Round
FillType VgLineFillType. Les valeurs sont les suivantes :
  • Unie (par défaut)
  • Vignette
  • Modèle
  • Frame
ImageAlignShape VgTriState. Alignez l’image avec la forme. Si la valeur est False, alignez l’image avec la fenêtre.
ImageAspect VgAspectType. L’attribut ImageSize sera ajusté pour conserver l’aspect de l’image. Ces valeurs comprennent :
Valeur Description
Ignorer Ignorer les problèmes d’aspect.
AtLeast L’image est au moins aussi grande que la taille de l’image.
AtMost La taille de l’image n’est pas supérieure à celle de l’image.

ImageSize Vector2D. Taille de l’image avec laquelle former le pinceau. La valeur par défaut est la taille de l’image.
JoinStyle VgLineJoinStyle. Les valeurs sont les suivantes :
  • Ronde (jointure arrondie)
  • Biseau (jointure biseautée)
  • Mitre (joint de mitre)
LineStyle VgLineStyle. Les valeurs sont les suivantes :
  • Unique
  • ThinThin (1:1:1)
  • ThinThick (1:1:2)
  • ThickThin (2:1:1)
  • ThickBetweenThin (1:1:2:1:1)
MiterLimit Longueur. Distance maximale entre le point intérieur et le point externe d’un joint. Ce nombre est un multiple de l’épaisseur de la ligne. Va de 0 à 32 767.
Activé VgTriState. Active et désactive l’affichage de la ligne. Identique à l’attribut Stroke dans Shape, mais le remplace.
Opacity VgFraction. Opacité du trait.
Source Chaîne. URL d’une image à charger pour les remplissages d’images et de motifs. Cet attribut doit toujours être présent et pointer vers des données d’image valides pour qu’une image apparaisse.
StartArrow VgArrowheadStyle. Pointe de flèche pour le début de la ligne. Les valeurs sont les suivantes :
  • Aucun (par défaut)
  • Bloquer
  • Classique
  • Losange
  • Ovale
  • Ouvrir
  • Chevron
  • DoubleChevron
StartArrowLength VgArrowHeadLength. Longueur de la pointe de flèche pour le début de la ligne. Les valeurs sont les suivantes :
  • Court
  • Moyenne (par défaut)
  • Long
StartArrowWidth VgArrowheadWidth. Largeur de la pointe de flèche pour le début de la ligne. Les valeurs sont les suivantes :
  • Narrow Medium (valeur par défaut) Wide
Poids VgLength. Largeur du trait. Va de 0 à 1584.

Remarque :
L’attribut DashStyle permet à l’utilisateur de spécifier un modèle de tiret personnalisé. Cette opération est effectuée à l’aide d’une série de nombres. Les styles de tiret sont définis en termes de longueur du tiret (partie dessinée du trait) et de la longueur de l’espace entre les tirets. Les longueurs sont relatives à la largeur du trait ; une longueur de « 1 » est égale à la largeur de ligne. Le style EndCap est appliqué à chaque tiret, mais pas les styles de flèche. La chaîne définit d’abord la longueur du tiret, puis la longueur de l’espace. Cela peut être répété pour former des styles de tirets complexes. La chaîne doit toujours contenir une paire de nombres ; s’il contient un nombre impair de nombres, le dernier peut être ignoré. Le tableau suivant répertorie certaines valeurs classiques et une description de l’effet prévu. « 0 » implique un point qui doit être symétrique à quatre fois (avec des extrémités arrondies, il doit s’agir d’un cercle). Si l’extrémité de ligne est Plate, une visionneuse doit choisir un tiret de système d’exploitation intégré si possible (c’est-à-dire un trait rapide à dessiner). Voici quelques exemples.

"2 2" tirets courts (chaque tiret et l’espace entre les deux est deux fois la largeur de la ligne)
"1 2" point (chaque tiret est la largeur de la ligne tandis que chaque espace est deux fois la largeur de la ligne)
"4 2" tiret (chaque tiret est quatre fois la largeur de la ligne tandis que chaque espace est deux fois la largeur de la ligne)
"8 2" tiret long
"4 2 1 2" tiret point
"8 2 1 2" point de tiret long
"8 2 1 2 1 2" point point de tiret long

Élément TextPath

Décrit un chemin d’accès vectoriel basé sur les données de texte, la police et les styles fournis. Le chemin du texte est déformé pour être conforme à un élément Path s’il est fourni.

Attribut Description
FitPath VgTriState. Dimensionne le texte à remplir le chemin d’accès sur lequel il se trouve.
FitShape VgTriState. Étire le chemin du texte jusqu’aux bords de la zone de forme.
Activé VgTriState. Détermine si les chemins d’accès aux caractères sont affichés ou non.
Chaîne Chaîne. Texte à afficher en tant que chemin de texte.
SupprEspace VgTriState. Supprime tout espace supplémentaire réservé aux ascendants et descendants s’il n’est pas utilisé.
Xscale VgTriState. Utilisez la mesure x droite au lieu de mesurer le long du chemin.

Types de données utilisés dans le modèle objet VML

Les types de données suivants sont utilisés par le modèle objet VML.

Type de données double

Entier de double précision avec plage de -infini à infini.

Type de données fixe

Nombre à virgule flottante avec une plage comprise entre -32 766,0 et 32 766,0.

Type de données Integer

Entier avec une plage comprise entre -infini et infini.

Type de données IVgAdjustments

Collection d’ajustements d’une forme qui peut être utilisée pour modifier les dimensions d’une forme. Les ajustements peuvent être utilisés comme espaces réservés temporaires ou pour n’importe quelle raison vous utiliseriez des variables. Il n’y a que 8 ajustements dans la collection.

Attribut Description
Exists IVgTriState. Détermine si un ajustement spécifié existe. Notez qu’un index doit être utilisé ; autrement dit, exists( item ) doit être utilisé pour récupérer l’existence d’un élément.
Élément Long. Tableau d’ajustements indexés de 0 à 7. Notez que les ajustements peuvent être spécifiés de manière précise; autrement dit, les valeurs de tableau intermédiaires peuvent ne pas toujours être remplies. Par exemple, l’élément 1, 3 et 5 peut avoir des valeurs pour une longueur de 3, avec item(0), item(2) et item(4) spécifiés. Pour voir s’il existe un élément, utilisez l’attribut Exists.
Longueur Integer. Nombre d’ajustements. Ne peut pas être supérieur à 8.
Valeur Chaîne. Représentation textuelle de valeurs numériques, avec des virgules entre chaque nombre.

IVgColor

Spécifie une couleur.

Attributs Description
RGB VgRGBType. Valeur RVB (Long) de la couleur. Valide uniquement si Type est RVB.
R Integer. Composant rouge de la couleur. Peut être compris entre 0 et 255.
G Integer. Composant vert de la couleur. Peut être compris entre 0 et 255.
B Integer. Composant bleu de la couleur. Peut être compris entre 0 et 255.
Chaîne Chaîne. Représentation textuelle de la couleur. Les types de couleurs nommés suivants sont pris en charge :
  • Noir (#000000)
  • Argent (#C0C0C0)
  • Gris (#808080)
  • Blanc (#FFFFFF)
  • Maroon (#800000)
  • Rouge (#FF0000)
  • Violet (#800080)
  • Fuchsia (#FF00FF)
  • Vert (#008000)
  • Lime (#00FF00)
  • Olive (#808000)
  • Jaune (#FFFF00)
  • Marine (#000080)
  • Bleu (#0000FF)
  • Sarcelle (#008080)
  • Aqua (#00FFFF)
Type VgColorType. Type de couleur. L’un des types suivants :
  • Mixte
  • named
  • RGB
  • Schéma

IVgEquation

Équations utilisées pour les formules.

Opération VgEquationOperationType Nom de l’opération à effectuer sur les paramètres. Les opérations suivantes peuvent être utilisées dans une équation :
Opération Description
Abs Valeur absolue.
abs(v)
Atan2 L’arithmétique polaire se traduit par des unités fd (degrés multipliés par 65536).
atan2(p1,v)
Cos Cosinus, argument en unités fd (degrés multipliés par 65536).
v * cos(p1)
Cosatan2 Conserve la précision totale dans le calcul intermédiaire.
v * cos(atan2( p2,p1 ))
Ellipse Ellipse
Si Si test de condition. v > 0 ? p1 : p2
Max La plus grande de deux valeurs.
max(v,p1)
ExtracChaîne Moyenne ( v + p1)/2
Min La moindre des deux valeurs. min(v,p1)
Mod Modulo.
Produit Utilisé pour la multiplication et la division. v * p1 / p2
Sin Sinus, argument en unités fd (degrés multipliés par 65536).
v * sin(p1)
Sinatan2 Conserve la précision totale dans le calcul intermédiaire. v * sin(atan2(p2,p1))
Sqrt Le résultat est positif et arrondit vers le bas.
sqrt(v)
Sum Utilisé pour l’addition et la soustraction.
v + p1 p2
Sumangle Angle existant (mis à l’échelle par 65536), où p1 et p2 sont en degrés.
v + p1 * 65536 + p2 * 65536
Tan Tangente, l’argument est en unités fd (degrés multipliés par 65536).
v * tan( p1 )
Val Définit une valeur de repère à partir d’une autre valeur.

Param1 Integer. Premier paramètre.
Paramtype1 VgFormulaParamType. Type du premier paramètre. Les valeurs suivantes sont admises :
Type Description
Valeur Le paramètre est une valeur simple.
AjustementReference Le paramètre est une référence à un ajustement. Par exemple, si le premier paramètre est 1, la valeur du premier ajustement est utilisée.
FormulaReference Le paramètre est le résultat d’une référence au résultat d’une formule précédente. Par exemple, si le premier paramètre est 2, le résultat de la formule 2 est utilisé.

Param2 Integer. Deuxième paramètre.
Paramtype2 VgFormulaParamType Type de paramètre 2.
Val Integer. Résultat.
Valtype2 VgFormulaParamType. Type du résultat.

IVgFixedRectangle

Spécifie un rectangle fixe.

Attribut Description
Valeur Chaîne. Valeur de texte spécifiant le chemin d’accès.
Gauche Double. Coordonnée la plus à gauche du rectangle.
Haut Double. Coordonnée la plus haute du rectangle.
Right Double. Coordonnée la plus à droite du rectangle.
Bas Double. Coordonnée la plus inférieure du rectangle.

IVgFixedRectangleArray

Tableau de rectangles fixes.

Attribut Description
Valeur Chaîne. Représentation textuelle du tableau.
Longueur Integer. Nombre de rectangles dans ce tableau.
Élément IVgFixedRectangle. Objet rectangle à l’index spécifié.

Type de données IVgFormula

Définitions de formules qui peuvent varier le chemin d’une forme ou être utilisées à d’autres fins de calcul. Les formules peuvent être basées sur l’attribut Adj d’une forme, qui peut changer. Les formules peuvent également référencer d’autres formules.

Attribut Description
Eqn IVgEquation. Chaque formule définit une valeur unique comme résultat de l’évaluation de l’expression. L’expression est définie par cet attribut et a la forme générale d’une opération suivie d’un maximum de trois arguments, qui peuvent être des valeurs d’ajustement (par exemple, #2), les résultats des formules antérieures (par exemple, @2), des nombres fixes ou des valeurs prédéfinies.

Type de données IVgFormulas

Collection d’objets de formule.

Attribut Description
Longueur Integer. Nombre d’objets de formule dans la collection.
Élément IVgFormula. Formule spécifique. Notez que le tableau de formules peut être hérité du type de forme.

IVgGradientColorArray

Tableau de couleurs qui définissent un dégradé (plage de couleurs fusionnées).

Attribut Description
Valeur Chaîne. Spécifie le tableau de couleurs ; par exemple, « .2 rouge ; vert .4; noir .7 »
Longueur Integer. Nombre de couleurs dans le tableau.
Méthode Description
AddColor VgFraction. Ajoute une nouvelle couleur au point de terminaison spécifié par fraction. La nouvelle couleur est blanche par défaut et est la valeur de retour. La couleur peut ensuite être modifiée par référence.
RemoveColor VgFraction. Supprime une couleur au point de terminaison spécifiée par fraction. Remarque : si la version 0.0 ou 1.0 n’existe pas, elle est implicite et la couleur blanche est utilisée à ce stade.

Type de données IVgPoints

Tableau de points qui définissent une forme.

Attribut Description
Valeur Chaîne. Représentation textuelle du tableau.
Longueur Integer. Nombre de points dans ce tableau.
Élément IVgVector2D. Point à l’index spécifié.

Type de données IVgSkewMatrix

Matrice utilisée pour la déformation des formes, matrice de transformation de perspective sous la forme « sxx,sxy,syx,syy,px,py » [s =scale, p =perspective]. Si offset est en unités absolues, alors px,py sont en emu ^-1 unités; sinon, ils représentent une fraction inverse de la taille de la forme.

Attribut Description
XtoX Double.
YtoX Double.
XtoY Double.
YtoY Double.
PerspectiveX Double.
PerspectiveY Double.

IVgSkewOffset

Spécifie le décalage de l’asymétrie.

Attributs Description
Valeur Chaîne. Représentation textuelle du décalage.
X Double. Composant X. Pourcentage ou mesure. Si aucune unité n’est utilisée, le type ShapeRelative est implicite ; sinon, le type absolu est implicite.
O Double. Composant Y.
Type VgSkewTransformType. Spécifie le type de transformation. Les valeurs valides sont des points entiers compris entre -infini et infini.
Type Description
ShapeRelative Les valeurs du décalage sont des pourcentages (ratios) de la taille de la forme d’origine; Par exemple, une valeur de 0,5 signifie un décalage de la moitié de la taille de la forme.
Absolu Les valeurs sont des unités absolues.

Type de données IVgVector2D

Spécifie un vecteur à deux dimensions composé de deux nombres Doubles .

Attributs Description
Valeur Chaîne. Représentation textuelle des deux nombres vectoriels séparés par un espace.
X Double. Composant X de ce vecteur.
O Double. Composant Y de ce vecteur.
Type VgVectorType. Unités attendues pour ce vecteur. Les valeurs sont les suivantes :
  • Measure
  • Longueur
  • AngleInDegrees
  • Fraction
  • Nombre entier en pourcentage

Type de données IVgVector3D

Spécifie un vecteur tridimensionnel composé de trois nombres doubles .

Valeur Chaîne. Représentation textuelle de trois nombres vectoriels séparés par un espace.
X Double. Composant X de ce vecteur.
O Double. Composant Y de ce vecteur.
Z Double. Composant Z de ce vecteur.
Type VgVectorType. Unités attendues pour ce vecteur. Les valeurs sont les suivantes :
  • Measure
  • Longueur
  • AngleInDegrees
  • Fraction
  • Nombre
  • Pourcentage
  • Integer

Type de données Length

Nombre à virgule flottante avec une plage comprise entre 0 et l’infini.

Type de données de mesure

Nombre à virgule flottante de -l’infini à l’infini.

Type de données String

Données caractères de n’importe quelle longueur.

VgBlackWhiteMode

Mode de rendu pour le noir et blanc. Les valeurs possibles sont les suivantes :

  • Color
  • Automatique
  • Gris
  • LightGrayScale
  • InverseGray
  • GrayOutline
  • BlackTextAndLines
  • HighContrast
  • Noir
  • Blancs
  • Désinscrit

Type de données VgFraction

Nombre à virgule flottante avec une plage comprise entre 0,0 et 1,0. Les fractions peuvent également être spécifiées sous forme de pourcentage ; Par exemple, « 50 % ».

Type de données VgTriState

Énumération utilisée pour les valeurs qui peuvent être l’un des trois états suivants :

  • TRUE
  • FALSE
  • CONDITIONS MIXTES