Table of contents
TOC
Réduire la table des matières
Développer la table des matières

Shape.DrawPolyline, méthode (Visio)Shape.DrawPolyline Method (Visio)

office 365 dev account|Dernière mise à jour: 14/03/2018
|
2 Collaborateurs

Crée une forme dont le chemin correspond à une polyligne passant par un ensemble de points donné.Creates a shape whose path is a polyline along a given set of points.

SyntaxeSyntax

expression . DrawPolyline ( TableauXY() , indicateurs )expression . DrawPolyline( xyArray() , Flags )

expression Variable qui représente un objet Shape .expression A variable that represents a Shape object.

ParamètresParameters

NomNameRequis/FacultatifRequired/OptionalType de donnéesData TypeDescriptionDescription
TableauXY()xyArray()ObligatoireRequiredDoubleDoubleTableau de valeurs x et y successives qui définit les points de chemin d’accès de la nouvelle forme.An array of alternating x and y values that defines points in the new shape's path.
IndicateursFlagsObligatoireRequiredEntierIntegerIndicateurs influençant la manière dont la forme est tracée.Flags that influence how the shape is drawn.

Valeur renvoyéeReturn Value

ShapeShape

RemarquesRemarks

La méthode DrawPolyline crée une forme dont le chemin se compose d’une séquence de segments de droite et dont les extrémités correspondent aux points définis dans le tableau xyArray . Appeler la méthode DrawPolyline est équivalent à l’appel de la méthode DrawSpline avec une tolérance zéro (0) et un indicateur de visSplineAbrupt .The DrawPolyline method creates a new shape whose path consists of a sequence of line segments and whose endpoints match the points specified in xyArray . Calling the DrawPolyline method is equivalent to calling the DrawSpline method with a tolerance of zero (0) and a flag of visSplineAbrupt .

Les points de contrôle doivent être exprimés en 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. Le tableau transmis doit être de type SAFEARRAY avec des valeurs à virgule flottante de 8 octets transmises par référence (VT_R8|VT_ARRAY|VT_BYREF). C'est de cette façon que Microsoft Visual Basic transmet des tableaux aux objets Automation.The control points should be in internal drawing units (inches) with respect to the coordinate space of the page, master, or group in which the new shape is being created. The passed array should be a type SAFEARRAY of 8-byte floating point values passed by reference (VT_R8|VT_ARRAY|VT_BYREF). This is how Microsoft Visual Basic passes arrays to Automation objects.

L’argument Flags est un masque de bits qui spécifie les options de dessin de la nouvelle forme. Sa valeur peut inclure visPolyline1D (8) ou visPolyarcs (256). Si l’indicateur comprend :The Flags argument is a bitmask that specifies options for drawing the new shape. Its value can include visPolyline1D (8) or visPolyarcs (256). If Flags includes:

  • visPolyline1D et si le premier et le dernier point du tableau xyArray ne coïncide pas, la méthode DrawPolyline génère une forme avec un comportement unidimensionnel (1D) ; dans le cas contraire, elle génère une forme à deux dimensions (2 D) problème.visPolyline1D and if the first and last points in xyArray don't coincide, the DrawPolyline method produces a shape with one-dimensional (1-D) behavior; otherwise, it produces a shape with two-dimensional (2-D) behavior.

  • visPolyarcs , Microsoft Visio génère une séquence d’arcs et non une séquence de segments de ligne ; xyArray doit indiquer le point initial x, y de la séquence de suivi de triples courbes x, y . Visio génère une forme avec des lignes EllipticalArcTo dans laquelle la courbure de l’arc correspond à la valeur spécifiée.visPolyarcs , Microsoft Visio will produce a sequence of arcs rather than a sequence of line segments; xyArray should specify the initial x,y point of the sequence followed by x,y bow triples. Visio will produce a shape with EllipticalArcTo rows where the bow of the arc matches the specified value.

Si le premier et le dernier point du tableau xyArray coïncide, la méthode DrawPolyline génère une forme pleine.If the first and last points in xyArray coincide, the DrawPolyline method produces a filled shape.

ExempleExample

L'exemple suivant indique comment dessiner deux formes polylignes qui ont, respectivement, un comportement 1D et 2D sur la page active.The following example shows how to draw two polyline shapes that have 2-D and 1-D behavior, respectively, on the active page.


Public Sub DrawPolyline_Example() 

 Dim vsoShape As Visio.Shape 
 Dim adblXYPoints(1 To 8) As Double 
 Dim intCounter As Integer 

 'Initialize array with coordinates. 
 adblXYPoints(1) = 1 
 adblXYPoints(2) = 1 
 adblXYPoints(3) = 3 
 adblXYPoints(4) = 3 
 adblXYPoints(5) = 5 
 adblXYPoints(6) = 1 
 adblXYPoints(7) = 1 
 adblXYPoints(8) = 2 

 'Use the DrawPolyline method to draw a shape that has 2-D behavior. 
 Set vsoShape = ActivePage.DrawPolyline(adblXYPoints, 0) 

 'Increase the Y-coordinate of the array by 4 to separate 
 'the next shape drawn from the first. 
 For intCounter = 2 To UBound(adblXYPoints) Step 2 
 adblXYPoints(intCounter) = adblXYPoints(intCounter) + 4 
 Next intCounter 

 'Use the DrawPolyline method to draw a shape that has 1-D behavior. 
 Set vsoShape = ActivePage.DrawPolyline(adblXYPoints, visPolyline1D) 

End Sub
© 2018 Microsoft