Compartir a través de


Stroke.Split (Método)

Actualización: noviembre 2007

Divide el objeto Stroke en la ubicación especificada en el objeto Stroke y devuelve el nuevo objeto Stroke.

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

Sintaxis

'Declaración
Public Function Split ( _
    findex As Single _
) As Stroke
'Uso
Dim instance As Stroke
Dim findex As Single
Dim returnValue As Stroke

returnValue = instance.Split(findex)
public Stroke Split(
    float findex
)
public:
Stroke^ Split(
    float findex
)
public Stroke Split(
    float findex
)
public function Split(
    findex : float
) : Stroke

Parámetros

  • findex
    Tipo: System.Single
    El valor de índice de punto flotante que representa dónde dividir el objeto Stroke.

Valor devuelto

Tipo: Microsoft.Ink.Stroke
El nuevo objeto Stroke que se crea como resultado de llamar a este método.

Comentarios

Un índice de punto flotante es un valor flotante que representa una ubicación situada en algún lugar entre dos puntos del trazo. Por ejemplo, si 0,0 es el primer punto del trazo y 1,0 el segundo punto, 0,5 se encontrará a mitad de camino entre el primer y el segundo punto. De igual forma, un valor de índice de punto flotante de 37,25 representa una ubicación que se encuentra en el 25 por ciento de la línea que une los puntos 37 y 38 del trazo.

Cuando se divide un objeto Stroke, una parte del trazo retiene la propiedad Id del objeto Stroke original. La otra parte de Stroke se convierte en un nuevo objeto Stroke con una propiedad Id que es uno mayor que la mayor propiedad Id existente. Si el objeto Stroke original se encontraba en una colección Strokes (diferente de Ink.Strokes), solamente la parte inicial permanecerá en esa colección.

Ejemplos

En este ejemplo, se examinan todos los objetos Stroke seleccionados de un objeto InkOverlay. Si Stroke tiene al menos una intersección con el resto de la colección Strokes del objeto Ink, Stroke se divide en el primer punto de intersección.

' Access to the Strokes property returns a copy of the Strokes object.
' This copy must be implicitly (via using statement) or explicitly
' disposed of in order to avoid a memory leak.
Using allStrokes As Strokes = mInkOverlay.Ink.Strokes
    For Each S As Stroke In mInkOverlay.Selection
        ' find the intersections
        Dim intersections() As Single = S.FindIntersections(allStrokes)
        ' if we have at least 1 intersection, split the stroke
        If intersections.Length > 0 Then
            S.Split(intersections(0))
        End If
    Next
End Using
// Access to the Strokes property returns a copy of the Strokes object.
// This copy must be implicitly (via using statement) or explicitly
// disposed of in order to avoid a memory leak.
using (Strokes allStrokes = mInkOverlay.Ink.Strokes)
{
    foreach (Stroke S in mInkOverlay.Selection)
    {
        // find the intersections
        float[] intersections = S.FindIntersections(allStrokes);
        // if we have at least 1 intersection, split the stroke
        if (intersections.Length > 0)
        {
            S.Split(intersections[0]);
        }
    }
}

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.

Información de versión

.NET Framework

Compatible con: 3.0

Vea también

Referencia

Stroke (Clase)

Stroke (Miembros)

Microsoft.Ink (Espacio de nombres)