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 reposent sur VML doivent être migrées vers SVG ou d’autres normes largement prises en charge.

Notes

Depuis le 2011 décembre, cette rubrique a été archivée. Par conséquent, il n’est plus activement conservé. Pour plus d’informations, consultez contenu archivé. pour obtenir des informations, des recommandations et des conseils relatifs à la version actuelle de Windows internet explorer, consultez le centre de développement internet explorer.

Dans cette rubrique :

Introduction

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

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

myshape.fillcolor = "red"

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

VML OM utilise plusieurs types de données pour définir des paramètres. Les types de données précédés de « VG » sont des énumérations et celles précédées de « 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 Document Object Model createElement. 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 attaché au document. À l’aide de la méthode AppendChild , le Rect est devenu l’enfant d’un élément div appelé MyDiv. Quelques attributs de style minimum (position, largeur, hauteur, haut, gauche) sont définis pour attribuer une taille spécifique à la forme. Enfin, une couleur est assignée avec l’attribut FillColor . Notez que vous pouvez utiliser n’importe quel langage de script ou n’importe quel langage pouvant fonctionner avec des interfaces Document Object Model.

Configuration de VML

L’une des implémentations de VML est par le biais de 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 configuré correctement 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 était requis.

Informations de référence sur VML OM

Cette référence définit l’élément de forme , les sous- élémentset les types de données utilisés par le modèle objet de Vml.

Élément Shape

Les formes sont les blocs de construction des images graphiques définies par langage VML (VML). 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
  • Apprendre
  • Ligne
  • Polyligne
  • Rect
  • RoundRect
Sous-élément Description
Ajustement IVgAdjustments. Liste délimitée par des virgules de nombres qui correspondent aux paramètres des formules de repère qui définissent le chemin d’accès de la forme. Les valeurs peuvent être omises pour permettre l’utilisation des valeurs par défaut. Il peut y avoir jusqu’à 8 valeurs d’ajustement.
Alt Chaîne. Texte de remplacement associé à Shape. Utilisé pour l’exploration non graphique.
Bouton VgTriState. Affiche le comportement du bouton sur clic.
BWMode VgBlackWhiteMode. Détermine le mode de rendu de la forme en noir et blanc dans les applications, ou lorsqu’elle est imprimée sur des imprimantes noir et blanc. Les valeurs sont les suivantes : couleur, auto, nuances de gris, LightGrayScale, InverseGray, GrayOutline, BlackTextAndLines, HighContrast, noir, blanc, dédessiné. Valeur par défaut : auto.
BWNormal VgBlackWhiteMode. Quand BWMode est auto, cette propriété est consultée pour savoir comment afficher la forme en noir et blanc normal. Les valeurs sont les suivantes : couleur, auto, nuances de gris, LightGrayScale, InverseGray, GrayOutline, BlackTextAndLines, HighContrast, noir, blanc, dédessiné. Valeur par défaut : auto.
BWPure VgBlackWhiteMode. Quand BWMode est auto, cette propriété est consultée pour savoir comment afficher la forme dans les e/s pures. Les valeurs sont les suivantes : couleur, auto, nuances de gris, LightGrayScale, InverseGray, GrayOutline, BlackTextAndLines, HighContrast, noir, blanc, dédessiné. Valeur par défaut : auto.
ChildShapes IVgGroupShapes. Collection d’autres formes de ce groupe. Cette collection prend en charge les méthodes de longueur et d’élément standard.
Chromakey IVgColor. Valeur de couleur qui est transparente et qui affiche 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. S’il n’est pas spécifié, il 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 la forme.
Extrusion IVgExtrusion. Spécifie la valeur de l’objet d’extrusion pour cette forme. Pour plus d’informations, consultez l’élément extrusion .
Remplir VgFillFormat. Spécifie la valeur de remplissage de cette forme. Pour plus d’informations, consultez l’élément Fill .
FillColor IVgColor. Couleur principale du pinceau à utiliser pour remplir le tracé de cette forme.
Spécifié VgTriState. Si la valeur est true, le chemin d’accès qui définit 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.
Livre VgFlipOrientation. Les valeurs sont les suivantes : X XY YX
ForceDash VgTriState. Indique qu’un contour en pointillés doit être rendu lorsqu’il n’y a aucune ligne et aucun remplissage pour une forme. Ce comportement est généralement utile pour rendre les formes invisibles visibles dans la modification des applications afin qu’elles puissent être sélectionnées et exploitées, par exemple dans une image interactive.
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 tous les descripteurs à l’exception des poignées en haut à gauche et en bas à droite, comme dans les poignées pour 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 la forme.
Shadow IVgShadow. Spécifie l’ombre de cette forme. Pour plus d’informations, consultez l’élément Shadow .
Arborescence Réservé.
StartAngle VgAngleInDegrees. Angle de début de la forme.
Trait VgStrokeFormat. Pour plus d’informations, consultez élément Stroke.
StrokeColor IVgColor. Couleur principale du pinceau à utiliser pour rayer le tracé de cette forme.
Rayé VgTriState. Si la valeur est true, le chemin d’accès qui définit la forme est rayé.
StrokeWeight VGLength. Largeur du pinceau à utiliser pour rayer le tracé. Les plages sont comprises 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 terminaison de la 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 d’objet VML.

Élément d’arrière-plan

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

Attribut Description
BWMode VgBlackWhiteMode. Détermine la façon dont la forme s’affiche dans une vue en noir et blanc dans des applications ou à l’impression.
BWNormal VgBlackWhiteMode. Quand BWMode est auto, cette propriété est consultée pour savoir comment afficher la forme en noir et blanc normal.
BWPure VgBlackWhiteMode. Quand BWMode est auto, cette propriété est consultée pour savoir comment afficher la forme en noir et blanc pur.
Remplir VgFillFormat. Spécifie le remplissage de cette forme. Pour plus d’informations, consultez l’élément Fill .
FillColor IVgColor. Couleur principale du pinceau à utiliser pour remplir le tracé de cette forme. Doublon de la valeur de couleur dans l’élément Fill. La valeur par défaut est blanc.

Élément 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 ; dans le cas contraire, il est déterminé par les paramètres RotationCenter, qui sont une fraction de la forme avec 0, 0, le centre.
Profondeur VgLength. Quantité d’extrusion vers l’arrière. Est compris entre 0 et 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é. Dans le cas contraire, définit automatiquement la couleur de l’effet d’extrusion sur la même valeur que FillColor.
ColorMode Vg3DColorMode. Les valeurs sont les suivantes :
  • Auto (par défaut)
  • Custom
Diffusion VgPositiveNumber. Rapport entre l’incident et la lumière diffuse. Les valeurs inférieures à 1,0 sont normales, mais les valeurs supérieures à un peuvent générer des effets intéressants.
Edge VgLength. Définit la taille d’un bord biseauté arrondi simulé. Est compris entre 0 et 32767 dans la valeur de type 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 vers l’avant. Est compris entre 0 et 32767.
LightFace VgTriState. Determimes si la face avant de l’objet répond aux modifications de l’éclairage 3D, par exemple quand un objet pivote.
LightHarsh VgTriState. Éclairage sévère de la source de lumière principale. La valeur par défaut est FALSE.
LightHarsh2 VgTriState. Éclairage sévère de la source de lumière secondaire. La valeur par défaut est FALSE.
LightLevel VgNumber. Intensité de la source de lumière principale. 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 principale. 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 par l’angle de rotation [1] degrés autour de l’axe y sur la page suivie de l’angle de rotation [0] degrés sur l’axe x. Quand LockRotationCenter a la valeur false, la rotation est définie en tant que degrés d’orientation-angle sur le vecteur défini par l’orientation. 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 modèle éclairé soit la couleur matérielle 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 de l’extrusion.
Orientation Vector3D. Orientation de l’appareil photo.
OrientationAngle VgAngleInDegrees. Angle entre l’orientation de l’appareil photo et le plan XY.
Verticale Vg3DExtrudePlane. Autorise l’extrusion des plans orthogonals au plan de l’écran. Requiert la spécification de ForeDepth et de l’effet de profondeur pour les unités de dessin au lieu de EMU. 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 façon dont la réflexion spéculaire concentrée ou répartie est. Une valeur élevée est comprendra de 8 à 10 et se traduirait par un miroir, et une valeur basse serait de 2 à 3 et sequinedrait des vêtements de ré. Les valeurs 3 à 7 sont recommandées. Des valeurs élevées reflètent les sources de lumière de repérage.
SkewAmt VgPercentage. Si le type est Parallel, l’attribut détermine la quantité d’inclinaison. Est compris entre 0 et 100.
SkewAngle VgAngleInDegrees. Si le type est Parallel, l’attribut détermine le degré d’inclinaison. La valeur par défaut est " -45 " .
Specularity VgPositiveNumber. Rapport entre l’incident et le modèle éclairé de lumière réfléchie. Les valeurs inférieures à 1,0 sont normales, mais les valeurs supérieures à un peuvent générer des effets intéressants.
Type VgExtrusionType. Les valeurs sont les suivantes :
  • Parallèle (par défaut)
  • Perspective
Point Vector3D. Point à partir duquel la scène est affichée.
ViewpointOrigin 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.

Fill, élément

Décrit comment remplir un tracé pour obtenir des remplissages plus complexes qu’une couleur unie.

Attributs

AlignShape VgTriState. Alignez l’image avec la forme. Si la valeur est false, l’image est alignée avec la fenêtre.
Angle VgAngleInDegrees. Angle de rotation du dégradé. 0 degré est le long de l’axe horizontal de gauche à droite.
Aspect VgAspectType. L’attribut ImageSize est ajusté pour conserver l’aspect de l’image. Ces valeurs comprennent :
Valeur Description
Ignorer Ignorer les problèmes d’aspect.
Au moins L’image est au moins aussi grande que la taille de l’image.
AtMost L’image n’est pas plus grande que la taille de l’image.

Couleur IVgColor Couleur de remplissage principale. Identique à l’attribut FillColor dans Shape.
Couleur2 IVgColor. Couleur secondaire d’un remplissage lorsque le type d’image est Pattern ou un remplissage dégradé.
Couleurs IVgGradientColorArray. Les couleurs intermédiaires dans le dégradé et leurs positions relatives le long du dégradé, par exemple " 30% de rouge, 70% bleu, 90% vert " . La couleur primaire (attribut Color dans Shape) est 0% et la couleur secondaire (attribut Color2) est 100%.
Priorité VgSignedPercentage. Point focal pour le remplissage dégradé linéaire. Les valeurs sont comprises entre-100 et + 100.
FocusPosition Vector2d. Position du rectangle le plus profond pour les dégradés radiaux. 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 profond pour les dégradés radiaux. 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 :
  • Aucun
  • Linéaire
  • Sigma
  • Quelconque

La valeur par défaut est Sigma.

Activé VgTriState. Active l’affichage du remplissage. Identique à l’attribut Fill dans Shape.
Opacity VgFraction. Opacité du remplissage.
Opacity2 VgFraction. Opacité secondaire pour les dégradés.
Origine Vector2d. Point relatif au coin supérieur gauche de l’image qui est traité 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. Point 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 en pixels de l’image. Peut être spécifié en coordonnées absolues ou en pourcentage.
Source Chaîne. URL vers une image à charger pour les remplissages d’image et de motif. Cet attribut doit toujours être présent et pointer vers des données d’image valides pour qu’une image s’affiche.
Type VgFillType. qui peut être l’un des suivants :
  • Contexte
  • Frame
  • Dégradé
  • GradientCenter
  • GradientRadial
  • GradientTitle
  • GradientUnscaled
  • Modèle
  • Unie
  • Tile
Les mosaïques, les modèles et les frames requièrent que les attributs d’image soient fournis. Les attributs gradient et GradientRadial requièrent 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 en haut d’une forme.

Attribut Description
Anticrénelage VgTriState. Affichez l’image dans deux couleurs uniquement (généralement en noir et blanc).
BlackLevel VgFraction. Permet de définir le niveau de manière à ce que les noirs apparaissent comme des véritables noirs et que toutes les autres couleurs soient visibles en tant que nuances au-dessus du noir.
Chromakey IVgColor. Couleur transparente de l’image.
CropBottom VgNumber. Distance de rognage à partir du bas de l’image exprimée sous la forme d’un pourcentage de la taille de l’image.
CropLeft VgNumber. Distance de rognage à partir du bord gauche de l’image exprimée sous la forme d’une fraction de la taille de l’image (de 0,0 à 1,0). Toutefois, « out-recadrage » 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écoupent les limites 25X la taille de l’image avec 4/5 d’un côté de l’image.
CropRight VgNumber. Distance de rognage à partir de la droite de l’image exprimée sous la forme d’un pourcentage de la taille de l’image.
CropTop VgNumber. Distance de rognage à partir du haut de l’image exprimée sous la forme d’un pourcentage de la taille de l’image.
EmbossColor IVgColor. Il s’agit d’un pourcentage de la couleur de l’ombre pour créer un effet d’image en relief.
Maîtrise VgPositiveNumber. Ajuste l’intensité de toutes les couleurs. Définit essentiellement le degré de luminosité du blanc. Est compris entre 0 et 32767.
Gamma VgFraction. Correction gamma. L’amélioration de l’image donne une image plus contrastée.
Nuances de gris VgTriState. Affichez l’image en nuances de gris.
Source Chaîne. URL vers une image à charger pour les remplissages d’image et de motif. Cet attribut doit toujours être présent et pointer vers des données d’image valides pour qu’une image s’affiche.

Élément Path

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

Limo IVgVector2D. Définit le point d’étirement de la forme ; par exemple, pour une forme Giraffe, le point Limo serait sur le cou. par conséquent, lorsque la forme est redimensionnée, le cou est étiré et le reste de la forme conserve ses dimensions.
TextBoxRect IVgFixedRectangleArray. Tableau contenant les rectangles qui définissent l’emplacement où le texte doit être placé.
V Chaîne. Correspond à l’attribut v de la balise Path. Notez que le chemin d’accès peut correspondre à un attribut ou à un élément de chemin d’accès.
Valeur Chaîne. Représentation textuelle des commandes qui définissent le chemin d’accès. Les valeurs de coordonnée X ou y peuvent être une référence à une formule dans le formulaire " @# " 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) Centre(x, y) taille(w, h), angle de début, angle de fin
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 existe un m implicite vers le point de départ du segment.
AR (ARC) Identique à. Toutefois, un nouveau sous-tracé est démarré par un m implicite jusqu’au point de départ de l’arc.
à (ArcTo) end gauche, haut, droite, bas, début(x, y) (x, y)
Les quatre premières valeurs définissent le cadre englobant d’une ellipse. Les quatre derniers définissent deux vecteurs radials. Un segment de l’ellipse est dessiné qui commence à l’angle défini par le vecteur de démarrage RADIUS et se termine à l’angle défini par le vecteur de fin. Une ligne droite est dessinée à partir du point actuel jusqu’au début de l’arc. L’arc est toujours dessiné dans le sens inverse des aiguilles d’une passe.
c (curveTo) Control1(x, y) Control2(x, y) à(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 de la courbe de Bézier.
e (fin) Terminer l’ensemble de sous-chemins en cours. Un ensemble donné de sous-chemins (délimités par fin) est rempli à l’aide de eofill. Les ensembles de sous-tracés suivants sont remplis indépendamment et superposés sur ceux qui existent déjà.
l (LineTo) x, y
Dessine une ligne 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 (MoveTo) x, y
Démarre un nouveau sous-tracé à la coordonnée x, y donnée.
NF (NoFill) L’ensemble actuel de sous-chemins (délimité par fin) n’est pas rempli.
NS (noStroke) L’ensemble actuel de sous-chemins (délimité par fin) n’est pas rayé.
QB (quadraticbezier) (ControlPoint(x, y)) *,end(x, y)
Définit une ou plusieurs courbes de Bézier quadratiques au moyen de points de contrôle et d’un point de terminaison. Les points intermédiaires (sur la courbe) sont obtenus par interpolation entre des points de contrôle successifs similaires aux polices TrueType. Le sous-tracé n’a pas besoin d’être un début, auquel cas le sous-tracé est fermé et le dernier point définit le point de départ.
qx (ellipticalquadrantx) fin(x, y)
Un quart d’ellipse est dessiné du point actuel au point de terminaison donné. Le segment elliptique est initialement tangent à une ligne parallèle à l’axe x ; autrement dit, le segment démarre horizontalement.
qy (ellipticalquadranty) fin(x, y)
Identique à qx, à ceci près que le segment elliptique est initialement tangent à une ligne parallèle à l’axe y ; autrement dit, le segment démarre verticalement.
r (rlineto) x, y
Dessinez une ligne du point actuel vers 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 d’accès aux coordonnées relatives (CPX + x, cpy + y) où CPX, cpy correspond à la position actuelle.
v (curveTo) Control1(x, y) Control2(x, y) à (x, y)
Courbe de Bézier cubique utilisant les coordonnées données relatives au point actuel. Tous les points sont calculés par rapport au même point de départ.
WA (clockwisearcto) Identique à, mais l’arc est dessiné dans le sens des aiguilles d’une montre.
WR (clockwisearc) Identique à AR mais est dessiné dans le sens des aiguilles d’une montre.
x (fermer) Fermer le sous-tracé en cours en dessinant une ligne droite à partir du point actuel sur le point MoveTo d’origine.

Élément Shadow

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

Couleur IVgColor. Couleur de l’ombre principale. La valeur par défaut est RVB (128128128)
Couleur2 IVgColor. Couleur de la deuxième ombre, ou mise en surbrillance dans une ombre de relief ou d’empreinte. La valeur par défaut est RVB (203203203).
Matrice IvgSkewMatrix. Matrice de transformation de perspective au format " Sxx, SXY, syx, SYY, 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 être faussée par rapport à la forme. Par exemple, la matrice suivante redimensionne la forme d’un facteur de 2 et l’incline par un facteur de 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.
Masquée VgTriState. L’ombre peut être consultée si aucun remplissage n’est présent sur la forme. La valeur par défaut est FALSE.
Offset IVgSkewOffset. Quantité de décalage x, y à partir de l’emplacement de la forme. La valeur par défaut est " 2pt, 2pt " .
Offset2 Vector2d. Nombre de décalages x, y à partir de 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 ou désactive l’affichage de l’ombre.
Opacity VgFraction. Opacité de l’effet d’ombre.
Origine Vector2d Paire de valeurs fractionnaires de forme comprise entre-0,5 et + 0,5.
Type VgShadowType. Les valeurs sont les suivantes :
  • Unique (valeur par défaut)
  • Double
  • Perspective
  • ShapeRelative
  • DrawingRelative
  • Relief

Élément Skew

Décrit un effet d’inclinaison de perspective sur une forme. L’inclinaison 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, SYY, PX, py « [ s = Scale, p = perspective ] . Si le décalage est en unités absolues alors que PX, py sont en unités UME ^-1 ; Sinon, il s’agit d’une fraction inverse de la taille de la forme.
Offset IvgSkewOffset. Quantité de décalage x, y à partir de l’emplacement de la forme. La valeur par défaut est « 2pt, 2pt ».
Activé VgTriState. Active ou désactive l’affichage de l’inclinaison.
Origine Vector2d. Paire de valeurs fractionnaires de forme comprise entre-0,5 et + 0,5.

Stroke, élément

Décrit comment dessiner le tracé si un point au-delà d’une ligne pleine 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é quand FillType est un modèle.
DashStyle VgLineDashStyle. Format du style des tirets. Peut être une valeur spécifique ou 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 flèche pour la fin de la ligne. Les valeurs sont les suivantes :
  • Court
  • Moyenne (par défaut)
  • Long
EndArrowWidth VgArrowheadWidth. Largeur de la flèche pour la fin de la ligne. Les valeurs sont les suivantes :
  • Restreindre
  • Moyenne (par défaut)
  • Large
Extrem VgLineEndCapStyle. Les valeurs sont les suivantes :
  • À deux dimensions
  • Carré
  • Round
FillType VgLineFillType. Les valeurs sont les suivantes :
  • Unie (par défaut)
  • Tile
  • Modèle
  • Frame
ImageAlignShape VgTriState. Alignez l’image avec la forme. Si la valeur est false, l’image est alignée avec la fenêtre.
ImageAspect VgAspectType. L’attribut ImageSize est ajusté pour conserver l’aspect de l’image. Ces valeurs comprennent :
Valeur Description
Ignorer Ignorer les problèmes d’aspect.
Au moins L’image est au moins aussi grande que la taille de l’image.
AtMost L’image n’est pas plus grande que la taille 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 :
  • Round (joint arrondi)
  • Biseau (joint biseauté)
  • Mitre (articulation à onglet)
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 interne et le point externe d’une jointure. Ce nombre est un multiple de l’épaisseur de la ligne. Est compris entre 0 et 32 767.
Activé VgTriState. Active ou 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 vers une image à charger pour les remplissages d’image et de motif. Cet attribut doit toujours être présent et pointer vers des données d’image valides pour qu’une image s’affiche.
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 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 flèche pour le début de la ligne. Les valeurs sont les suivantes :
  • Étroit moyen (par défaut) large
Poids VgLength. Largeur de la ligne. Est compris entre 0 et 1584.
[!Note]
L’attribut DashStyle permet à l’utilisateur de spécifier un modèle de tirets personnalisé. Cette opération s’effectue à l’aide d’une série de nombres. Les styles de tirets 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 de la ligne ; une longueur de " 1 " est égale à la largeur de ligne. Le style d’extrémité est appliqué à chaque tiret. les styles de flèche ne le sont pas. 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 tiret complexes. La chaîne doit toujours contenir une paire de nombres ; Si elle contient un nombre impair de nombres, la dernière peut être ignorée. Le tableau suivant répertorie des valeurs typiques et une description de l’effet prévu. "0 " signifie un point qui doit être quatre symétrique (avec des extrémités arrondies, il doit s’agir d’un cercle). Si l’extrémité de la ligne est plate, une visionneuse doit choisir un tiret de système d’exploitation intégré si possible (c’est-à-dire un point rapide à dessiner). Voici quelques exemples.
"2 2" des tirets courts (chaque tiret et l’espace entre deux fois la largeur de la ligne)
"1 2" point (chaque tiret correspond à la largeur de la ligne, tandis que chaque espace est deux fois plus large que la largeur de la ligne)
"4 2" Dash (chaque tiret correspond à quatre fois la largeur de la ligne, tandis que chaque espace est deux fois plus large que la largeur de la ligne)
"8 2" long tiret
"4 2 1 2" tiret-point
"8 2 1 2" long-tiret-point
"8 2 1 2 1 2" point-tiret long

Élément TextPath

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

Attribut Description
FitPath VgTriState. Dimensionne le texte pour remplir le tracé sur lequel il se trouve.
FitShape VgTriState. Étire le tracé du texte vers les 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 sous la forme d’un tracé de texte.
SupprEspace VgTriState. Supprime tout espace supplémentaire réservé pour les jambages ascendants et descendants s’il n’est pas utilisé.
Cadencé VgTriState. Utilisez une mesure x droite au lieu de mesurer le long du tracé.

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

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

Double (type de données)

Entier double précision avec une plage comprise entre-Infinity et Infinity.

Type de données fixe

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

Integer (type de données)

Entier compris entre-Infinity et Infinity.

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 en tant qu’espaces réservés temporaires ou pour une raison quelconque, vous pouvez utiliser des variables. La collection ne contient que 8 ajustements.

Attribut Description
Exists IVgTriState. Détermine si un ajustement spécifié existe. Notez qu’un index doit être utilisé ; en d’autres cas, 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 pour SPARC. autrement dit, les valeurs de tableau intermédiaire ne peuvent pas toujours être remplies. Par exemple, les éléments 1, 3 et 5 peuvent avoir des valeurs pour une longueur de 3, avec l’élément (0), l’élément (2) et l’élément (4) spécifiés. Pour voir si un élément existe, utilisez l’attribut exists.
Longueur Integer. Nombre d’ajustements. Ne peut pas être supérieur à 8.
Valeur Chaîne. Représentation textuelle des valeurs numériques, avec des virgules entre chaque nombre.

IVgColor

Spécifie une couleur.

Attributs Description
RGB VgRGBType. Valeur RVB (longue) de la couleur. Valide uniquement si le 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 couleur nommés suivants sont pris en charge :
  • Noir (#000000)
  • Silver (#C0C0C0)
  • Gris (#808080)
  • Blanc (#FFFFFF)
  • Marron (#800000)
  • Rouge (#FF0000)
  • Violet (#800080)
  • Fuchsia (#FF00FF)
  • Vert (#008000)
  • Chaux (#00FF00)
  • Vert olive (#808000)
  • Jaune (#FFFF00)
  • Bleu marine (#000080)
  • Bleu (#0000FF)
  • Bleu-vert (#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 Arithmétique polaire--résultats en unités FD (degrés multiplié par 65536).
atan2(P1, v)
Cos Cosinus, argument en unités FD (degrés multiplié par 65536).
v * COS(P1)
Cosatan2 Préserve la précision complète dans le calcul intermédiaire.
v * cos (atan2 ( P2, P1 ))
Ellipse Ellipse
Si Test de condition if. v > 0 ? P1 : P2
Max Valeur la plus grande de deux valeurs.
Max(v, P1)
ExtracChaîne Moyenne (v + P1)/2
Min La plus petite 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é par 65536).
v * Sin(P1)
Sinatan2 Préserve la précision complète dans le calcul intermédiaire. v * Sin(atan2(P2, P1))
Sqrt Le résultat est positif et arrondit à la valeur inférieure.
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 exprimés en degrés.
v + P1 * 65536 + P2 * 65536
Tan Tangente, l’argument est en unités FD (degrés multiplié 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.
AdjustmentReference Le paramètre est une référence à un ajustement. Par exemple, si le premier paramètre est 1, la valeur du premier ajustement sera 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 a la valeur 2, le résultat de la formule 2 sera 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 grande du rectangle.
Right Double. Coordonnée la plus à droite du rectangle.
Bas Double. Coordonnée la plus basse du rectangle.

IVgFixedRectangleArray

Tableau de rectangles fixes.

Attribut Description
Valeur Chaîne. Représentation textuelle d’un 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 des formules qui peuvent varier le tracé 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, ce qui peut changer. Les formules peuvent également faire référence à 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 présente la forme générale d’une opération suivie de jusqu’à trois arguments, qui peuvent être des valeurs d’ajustement (par exemple, # 2), des résultats de 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é de le type de forme.

IVgGradientColorArray

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

Attribut Description
Valeur Chaîne. Spécifie le tableau de couleurs ; par exemple, «Red. 2 ; 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é par fraction. Remarque : si 0,0 ou 1,0 n’existe pas, il est implicite et le blanc de couleur est utilisé à ce stade.

Type de données IVgPoints

Tableau de points qui définissent une forme.

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

Type de données IVgSkewMatrix

Matrice utilisée pour incliner des formes, une matrice de transformation de perspective sous la forme "Sxx, SXY, syx, SYY, PX, py " [ s = Scale, p = perspective ] . Si le décalage est en unités absolues, alors PX, py sont en unités UME ^-1 ; Sinon, il s’agit d’une fraction inverse de la taille de la forme.

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

IVgSkewOffset

Spécifie le décalage de l’inclinaison.

Attributs Description
Valeur Chaîne. Représentation textuelle du décalage.
X Double. Composant X. Pourcentage ou mesure. Si aucune unité n’est présente, 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 les points d’entier compris entre-Infinity et Infinity.
Type Description
ShapeRelative Les valeurs du décalage sont des pourcentages (proportions) 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 constitué de deux nombres doubles .

Attributs Description
Valeur Chaîne. Représentation textuelle des deux nombres vectorisés 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 :
  • Mesure
  • Longueur
  • AngleInDegrees
  • Fraction
  • Nombre entier de pourcentage

Type de données IVgVector3D

Spécifie un vecteur à trois dimensions composé de trois nombres doubles .

Valeur Chaîne. Représentation textuelle de trois nombres vectorisés 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 :
  • Mesure
  • Longueur
  • AngleInDegrees
  • Fraction
  • Nombre
  • Pourcentage
  • Entier

Type de données de longueur

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

Type de données Measure

Nombre à virgule flottante de-Infinity à Infinity.

Type de données String

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

VgBlackWhiteMode

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

  • Couleur
  • Automatique
  • Semble
  • LightGrayScale
  • InverseGray
  • GrayOutline
  • BlackTextAndLines
  • HighContrast
  • Noir
  • White
  • Dédessiné

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 la forme d’un pourcentage. par exemple, « 50% ».

Type de données VgTriState

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

  • TRUE
  • FALSE
  • CONDITIONS MIXTES