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

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á medio 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 de retorno

Este método puede devolver uno de estos valores.

Código de retorno Descripción
S_OK
 Éxito.
E_POINTER
 Un parámetro contenía un puntero no válido.
E_OUTOFMEMORY
 No se puede asignar el objeto auxiliar del controlador stroke.
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 .

Observaciones

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 trazo 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 (distinto de Ink.Strokes), solo la parte inicial permanece en esa colección.

Requisitos

Requisito Importancia
Cliente mínimo compatible Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo admitido No se admite ninguno
de la plataforma de destino de Windows
Header msinkaut.h

Consulte también

IInkStrokeDisp (interfaz)

  • Last updated on