Table of contents
TOC
Recolher sumário
Expandir sumário

Método Shape.DrawPolyline (Visio)Shape.DrawPolyline Method (Visio)

office 365 dev account|Última Atualização: 22/03/2018
|
2 Colaboradores

Cria uma forma cujo caminho é uma polilinha com um determinado conjunto de pontos.Creates a shape whose path is a polyline along a given set of points.

SintaxeSyntax

expressão . DrawPolyline ( xyarray () , sinalizadores )expression . DrawPolyline( xyArray() , Flags )

expressão Uma variável que representa um objeto Shape .expression A variable that represents a Shape object.

ParâmetrosParameters

NomeNameObrigatório/opcionalRequired/OptionalTipo de dadosData TypeDescriçãoDescription
xyarray)xyArray()ObrigatórioRequiredDoubleDoubleUma matriz de valores x e y de alternados que definem pontos no caminho da nova forma.An array of alternating x and y values that defines points in the new shape's path.
SinalizadoresFlagsObrigatórioRequiredIntegerIntegerSinalizadores que influenciam a maneira como a forma é desenhada.Flags that influence how the shape is drawn.

Valor retornadoReturn Value

FormaShape

ComentáriosRemarks

O método DrawPolyline cria uma nova forma cujo caminho consiste em uma sequência de segmentos de linha e pontos de extremidade cujos correspondem os pontos, especificada em xyArray . Chamar o método DrawPolyline é equivalente a chamar o método DrawSpline com uma tolerância de zero (0) e um sinalizador 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 .

Os pontos de controle devem estar em unidades de desenho internas (polegadas) com relação ao espaço de coordenadas da página, mestre ou grupo no qual a nova forma é criada. A matriz passada deve ser do tipo SAFEARRAY de valores de ponto flutuante de 8 bytes passados por referência (VT_R8|VT_ARRAY|VT_BYREF). É assim que o Microsoft Visual Basic passa matrizes para objetos 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.

O argumento Flags é uma bitmask que especifica as opções para a nova forma de desenho. Seu valor pode incluir visPolyline1D (8) ou visPolyarcs (256). Se Flags incluir: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 e se o primeiro e último em xyArray não coincidirem, o método DrawPolyline produzirá uma forma com comportamento de unidimensional (1D); Caso contrário, ele produzirá uma forma com comportamento de bidimensional (2D).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 , o Microsoft Visio produzirá uma sequência de arcos em vez de uma sequência de segmentos de linha; xyArray deve especificar o ponto inicial x, y da sequência seguido x, y triples da curva. Visio produzirá uma forma com linhas EllipticalArcTo onde a curva do arco corresponde ao valor especificado.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.

Se o primeiro e último em xyArray coincidirem, o método DrawPolyline produzirá uma forma preenchida.If the first and last points in xyArray coincide, the DrawPolyline method produces a filled shape.

ExemploExample

O exemplo a seguir mostra como desenhar duas formas de polilinha com comportamento 2-D e 1-D, respectivamente, na página ativa.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