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
- Exemple
- Configuration de VML
- Informations de référence sur VML OM
- Sous-éléments de l’élément Shape
- Types de données utilisés dans le modèle d’objet VML
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 :
Le schéma doit être configuré dans la < > balise HTML initiale comme suit :
<HTML xmlns:v="urn:schemas-microsoft-com:vml">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 :
|
| 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 :
|
| Rendu | Vg3DRenderMode. Les valeurs sont les suivantes :
|
| 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 :
|
| 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 :
|
||||||||
| 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 :
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 :
|
é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 :
|
É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 :
|
É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 :
|
||||||||||||||
| EndArrow | VgArrowheadStyle. Pointe de flèche pour la fin de la ligne. Les valeurs sont les suivantes :
|
||||||||||||||
| EndArrowLength | VgArrowHeadLength. Longueur de la flèche pour la fin de la ligne. Les valeurs sont les suivantes :
|
||||||||||||||
| EndArrowWidth | VgArrowheadWidth. Largeur de la flèche pour la fin de la ligne. Les valeurs sont les suivantes :
|
||||||||||||||
| Extrem | VgLineEndCapStyle. Les valeurs sont les suivantes :
|
||||||||||||||
| FillType | VgLineFillType. Les valeurs sont les suivantes :
|
||||||||||||||
| 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 :
|
||||||||||||||
| 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 :
|
||||||||||||||
| LineStyle | VgLineStyle. Les valeurs sont les suivantes :
|
||||||||||||||
| 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 :
|
||||||||||||||
| StartArrowLength | VgArrowHeadLength. Longueur de la flèche pour le début de la ligne. Les valeurs sont les suivantes :
|
||||||||||||||
| StartArrowWidth | VgArrowheadWidth. Largeur de la flèche pour le début de la ligne. Les valeurs sont les suivantes :
|
||||||||||||||
| Poids | VgLength. Largeur de la ligne. Est compris entre 0 et 1584.
[!Note]
|
É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
- Fixe
- Integer
- IVgAdjustments
- IVgColor
- IVgEquation
- IVgFixedRectangle
- IVgFixedRectangleArray
- IVgFormula
- IVgFormulas
- IVgGradientColorArray
- IVgPoints
- IVgSkewMatrix
- IVgSkewOffset
- IVgVector2D
- IVgVector3D
- Durée
- Mesure
- Chaîne
- VgBlackWhiteMode
- VgFraction
- VgTriState
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 :
|
| Type | VgColorType. Type de couleur. L’un des types suivants :
|
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 :
|
||||||||||||||||||||||||||||||||||||||
| Param1 | Integer. Premier paramètre. | ||||||||||||||||||||||||||||||||||||||
| Paramtype1 | VgFormulaParamType. Type du premier paramètre. Les valeurs suivantes sont admises :
|
||||||||||||||||||||||||||||||||||||||
| 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 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 :
|
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 :
|
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