4D Doc Center : SVG

4D v14

SVG_New


SVG_New {( largeur ; hauteur {; titre {; description {; rectangle {; affichage}}}} )} -> Résultat

Paramètre	Type	Description
largeur	Entier long	Largeur du document en points
hauteur	Entier long	Hauteur du document en points
titre	Chaîne	Titre du document
description	Chaîne	Description
rectangle	Booléen	Définir le rectangle de visualisation
affichage	Entier	Format d'affichage de l'image
Résultat	Ref_SVG	Référence de l’objet SVG

Description

La commande SVG_New crée un nouveau document SVG et retourne sa référence.

Les paramètres optionnels largeur et hauteur permettent de délimiter l’espace du document SVG. Ces deux paramètres doivent être exprimés en points utilisateur ('px'). Si vous souhaitez utiliser une autre unité, utilisez la commande SVG_SET_DIMENSIONS.

Les paramètres optionnels titre et description permettent d'associer au documents des informations de contenu.

Si vous passez Vrai dans le paramètre optionnel rectangle, le rectangle de visualisation (attribut 'viewBox') est automatiquement fixé à la taille du document créé.

Note : Il est possible de modifier les coordonnées du rectangle de visualisation du graphique et de régler plus précisément l'adaptation de l'image à ce dernier avec la commande SVG_SET_VIEWBOX.

Le paramètre optionnel affichage permet d’indiquer si le graphique doit s’adapter à la taille du document. Vous pouvez passer dans ce paramètre l'une des constantes du thème "Formats d'affichage des images" de 4D suivantes : Proportionnelle centrée ou Non tronquée.

La commande retourne une chaîne de 16 caractères (Ref_SVG) constituant la référence en mémoire de la structure virtuelle du document. Cette référence devra être utilisée avec les autres commandes du composant pour désigner le document.

Important : Une fois que vous n'en avez plus besoin, n'oubliez pas d'appeler la commande SVG_CLEAR avec cette référence afin de libérer la mémoire.

Exemple

 svgRef:=SVG_New

 svgRef:=SVG_New(500;200)

 svgRef:=SVG_New(900;700;"Test composant";"Ceci est un exemple";Vrai;Non tronquée)