Metodo IInkStrokeDisp::Split (msinkaut.h)

Divide il tratto in corrispondenza della posizione specificata sul tratto.

Sintassi

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

Parametri

[in] SplitAt

Valore dell'indice a virgola mobile che rappresenta la posizione in cui dividere il tratto.

Nota Un indice a virgola mobile è un valore float che rappresenta una posizione tra due punti nel tratto. Ad esempio, se 0,0 è il primo punto del tratto e 1,0 è il secondo punto del tratto, 0,5 è a metà tra il primo e il secondo punto. Analogamente, un valore di indice a virgola mobile pari a 37,25 rappresenta una posizione del 25% lungo la linea tra i punti 37 e 38 del tratto.
 

[out, retval] NewStroke

Quando termina, questo metodo contiene un puntatore al nuovo oggetto IInkStrokeDisp creato dall'operazione di divisione.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito Descrizione
S_OK
Successo.
E_POINTER
Un parametro contiene un puntatore non valido.
E_OUTOFMEMORY
Impossibile allocare l'oggetto helper del gestore stroke.
E_INVALIDARG
Il parametro non è valido.
E_UNEXPECTED
Parametro o tipo di proprietà imprevisto.
E_INK_EXCEPTION
Si è verificata un'eccezione all'interno del metodo .

Osservazioni:

Questo metodo inserisce il nuovo tratto immediatamente dopo il tratto originale nel set di tratti e rinnumera gli indici dei tratti rimanenti.

Quando un IInkStrokeDisp viene diviso, la parte iniziale del tratto rimane l'ID dell'IInkStrokeDisp originale. La parte finale di IInkStrokeDisp diventa un nuovo IInkStrokeDisp con un ID maggiore dell'ID IInkStrokeDisp più alto. Se l'oggetto IInkStrokeDisp originale si trovava in un insieme InkStrokes (diverso da Ink.Strokes), solo la parte iniziale rimane in tale raccolta.

Requisiti

Requisito Valore
Client minimo supportato Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato Nessuna supportata
Piattaforma di destinazione Windows
Intestazione msinkaut.h

Vedere anche

Interfaccia IInkStrokeDisp