Condividi tramite


Metodo IInkStrokeDisp::Split (msinkaut.h)

Divide il tratto nella posizione specificata del 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. Come esempi, se 0,0 è il primo punto del tratto e 1.0 è il secondo punto del tratto, 0,5 è 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 punti 37 e 38 del tratto.
 

[out, retval] NewStroke

Quando questo metodo restituisce, 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
Operazione completata.
E_POINTER
Un parametro contiene un puntatore non valido.
E_OUTOFMEMORY
Impossibile allocare l'oggetto helper del gestore del tratto.
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.

Commenti

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

Quando un IInkStrokeDisp viene diviso, la parte iniziale del tratto rimane l'ID dell'id dell'oggetto IInkStrokeDisp originale. La parte finale di IInkStrokeDisp diventa una nuova IInkStrokeDisp con un ID maggiore dell'ID più alto di IInkStrokeDisp. Se l'oggetto IInkStrokeDisp originale è presente 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 Nessuno supportato
Piattaforma di destinazione Windows
Intestazione msinkaut.h
Libreria InkObj.dll

Vedi anche

Interfaccia IInkStrokeDisp