Metodo IInkStrokeDisp::Split (msinkaut.h)

Articolo
02/29/2024

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

Condividi tramite