Stroke.SetPoints (Método) (Int32, array<Point[])

Artículo
11/26/2008

Actualización: noviembre 2007

Establece un intervalo de estructuras Point que se inician en el índice especificado en un objeto Stroke.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public Function SetPoints ( _
    index As Integer, _
    points As Point() _
) As Integer
'Uso
Dim instance As Stroke
Dim index As Integer
Dim points As Point()
Dim returnValue As Integer

returnValue = instance.SetPoints(index, _
    points)

public int SetPoints(
    int index,
    Point[] points
)

public:
int SetPoints(
    int index, 
    array<Point>^ points
)

public int SetPoints(
    int index,
    Point[] points
)

public function SetPoints(
    index : int, 
    points : Point[]
) : int

Parámetros

index
Tipo: System.Int32
El índice de base cero del primer punto en el objeto Stroke que se va a modificar.

points
Tipo: array<System.Drawing.Point[]
La matriz de nuevos valores de Point que van a reemplazar a los puntos en el objeto Stroke empezando por el primer punto.
index.

Valor devuelto

Tipo: System.Int32
Devuelve el número real del conjunto de puntos.

Comentarios

Este método no cambia el número de puntos en el objeto Stroke. Para cambiar el número de puntos en el objeto Stroke, se debe crear un nuevo objeto Stroke o el objeto Stroke se debe dividir.

La longitud de la matriz de puntos determina el recuento de puntos que se va a modificar en el objeto Stroke.

Este método no permite truncar el objeto Stroke. Si la matriz de puntos contiene menos puntos que el objeto Stroke, el resto de los puntos en el objeto Stroke no se modifica.

Este método no permite extender el objeto Stroke. Si la matriz de puntos contiene más puntos que el objeto Stroke, los puntos extra no se usan.

Ejemplos

En este ejemplo, la segunda mitad de cada objeto Stroke seleccionado de InkOverlay se cambia a un trazo horizontal obteniendo los puntos para la segunda mitad del objeto Stroke y, después, se estandariza cada una de las coordenadas Y. Una vez modificados los valores, se usa el método SetPoints para actualizar el objeto Stroke.

For Each S As Stroke In mInkOverlay.Selection
    Dim halfwayPt As Integer = S.PacketCount / 2
    ' get the points
    Dim pts() As Point = S.GetPoints(halfwayPt, S.PacketCount - halfwayPt)
    ' set each Y coordinate to the first Y coordinate
    For k As Integer = 0 To pts.Length - 1
        pts(k).Y = pts(0).Y
    Next
    ' update the points
    S.SetPoints(halfwayPt, pts)
Next

foreach (Stroke S in mInkOverlay.Selection)
{
    int halfwayPt = S.PacketCount / 2;
    // get the points
    Point[] pts = S.GetPoints(halfwayPt, S.PacketCount - halfwayPt);
    // set each Y coordinate to the first Y coordinate
    for (int k = 0; k < pts.Length; k++)
    {
        pts[k].Y = pts[0].Y;
    }
    // update the points
    S.SetPoints(halfwayPt, pts);
}

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.