Méthode Page.DrawNURBS (Visio)

  • Article

Crée une nouvelle forme dont le chemin se compose d'un seul segment NURBS (courbe B-splinenonuniform rational).

Syntaxe

expression. DrawNURBS( _degree_ , _Flags_ , _xyArray()_ , _knots()_ , _weights_ )

Expression Variable qui représente un objet Page .

Parameters

Nom Requis/Facultatif Type de données Description
Degré Requis Integer Degré de la spline ; entier compris entre 1 et 25.
Flags Requis Integer Indicateurs influençant la manière dont la forme est tracée.
xyArray() Requis Double Tableau de valeurs x et y successives qui définissent les coordonnées des points de contrôle ; utilisez les unités de dessin interne (pouces).
knots() Requis Double Tableau de nœuds.
Poids Facultatif Variant Tableau d'épaisseurs.

Valeur renvoyée

Shape

Remarques

La méthode DrawNURBS crée une forme dont le chemin est constitué d'un seul segment NURBS, défini par les arguments.

Les points de contrôle doivent être des unités de dessin internes (pouces) par rapport à l'espace coordonné de la page, de la forme de base ou du groupe dans lequel la nouvelle forme est créée. Les tableaux TableauXY, nœuds et épaisseurs doivent être de type SAFEARRAY avec des valeurs à virgule flottante de huit octets transmises par référence (VT_R8|VT_ARRAY|VT_BYREF). C'est ainsi que Microsoft Visual Basic transmet des tableaux aux objets Automation.

L'argument nœuds n'a pas d'unités. La séquence de nœuds ne doit pas être décroissante. En d’autres termes, knots( i + 1) <knots( i ) n’est pas acceptable. knots( i + 1) = knots( i ) est autorisé, puis la valeur est répétée, mais les restrictions suivantes s’appliquent :

  • Le premier nœud ne doit pas être répété plus de degré+1 fois.
  • Le dernier nœud ne peut pas être répété.
  • Tout nœud situé entre le premier et le dernier ne peut pas être répété plus de degré fois.
  • Si le premier nœud est répété moins de degré + 1 fois, la spline est régulière.
  • La liste des épaisseurs est facultative. Son absence signifie que la spline n'est pas rationnelle. Les épaisseurs ne sont pas dotées d'une unité.

Les règles suivantes s'appliquent à la taille des listes. Pour une spline avec n points de contrôle :

  • Si la spline est périodique, n> 2. Sinon, n>degré.
  • La taille de xyArray est de 2 n.
  • La taille du tableau de poids est n (le cas échéant).
  • La taille du tableau nœuds est n + 1.

La spline non périodique conventionnelle nécessite n + degrés + 1 noeuds, mais l’application implique les nœuds répétés à la fin. Par exemple, la liste de nœuds degré 2 (0,0,0,2,5,8) est interprétée dans Visio comme la séquence de nœuds conventionnelle (0,0,0,2,5,8,8,8).

Le paramètre Indicateurs est un masque binaire définissant les options de dessin de la nouvelle forme. Sa valeur doit être zéro (0) ou visSpline1D (8). Si Flags est visSpline1D et si le premier et le dernier point de xyArray ne coïncident pas, la méthode DrawNURBS produit une forme avec un comportement unidimensionnel (1D) ; sinon, elle produit une forme avec un comportement 2D (2D).

Si le premier et le dernier point du tableau TableauXY coïncident, la méthode DrawNURBS génère une forme pleine.

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.