Método IInkStrokeDisp::Split (msinkaut.h)

  • Artículo

Divide el trazo en la ubicación especificada del trazo.

Sintaxis

HRESULT Split(
  [in]          float          SplitAt,
  [out, retval] IInkStrokeDisp **NewStroke
);

Parámetros

[in] SplitAt

Valor de índice de punto flotante que representa dónde dividir el trazo.

Nota Un índice de punto flotante es un valor float que representa una ubicación entre dos puntos del trazo. Como ejemplo, si 0,0 es el primer punto del trazo y 1,0 es el segundo punto del trazo, 0,5 está a la mitad entre los puntos primero y segundo. Del mismo modo, un valor de índice de punto flotante de 37,25 representa una ubicación del 25 por ciento a lo largo de la línea entre los puntos 37 y 38 del trazo.
 

[out, retval] NewStroke

Cuando este método vuelve, contiene un puntero al nuevo objeto IInkStrokeDisp que se crea a partir de la operación de división.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 Correcto.
E_POINTER
 Un parámetro contenía un puntero no válido.
E_OUTOFMEMORY
 No se puede asignar el objeto auxiliar del controlador de trazos.
E_INVALIDARG
 El parámetro no es válido.
E_UNEXPECTED
 Parámetro o tipo de propiedad inesperados.
E_INK_EXCEPTION
 Se produjo una excepción dentro del método .

Comentarios

Este método inserta el nuevo trazo inmediatamente después del trazo original en el conjunto de trazos y vuelve a numerar los índices de trazos restantes.

Cuando se divide un IInkStrokeDisp , la parte inicial del trazo sigue siendo el identificador del IInkStrokeDisp original. La parte final de IInkStrokeDisp se convierte en un nuevo IInkStrokeDisp con un identificador que es uno mayor que el id. de IInkStrokeDisp más alto. Si el IInkStrokeDisp original estaba en una colección InkStrokes (aparte de Ink.Strokes), solo la parte inicial permanece en esa colección.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado msinkaut.h
Library InkObj.dll

Consulte también

IInkStrokeDisp (Interfaz)