Metodo IInkStrokeDisp::SetPoints (msinkaut.h)

Articolo
02/29/2024

Imposta i punti di IInkStrokeDisp usando una matrice di valori X, Y.

Sintassi

HRESULT SetPoints(
  [in]           VARIANT Points,
  [in, optional] long    Index,
  [in, optional] long    Count,
  [out, retval]  long    *NumberOfPointsSet
);

Parametri

[in] Points

Matrice di nuovi punti per sostituire i punti nel tratto a partire dall'indice. Valore VARIANT contenente una matrice long con i punti rappresentati da valori alternati del formato x0, y0, x1, y1, x2, y2, y2 e così via.

Per altre informazioni sulla struttura VARIANT, vedere Uso della libreria COM.

[in, optional] Index

facoltativo. Indice in base zero del primo punto del tratto da modificare. Il valore predefinito ISC_FirstElement, definito nel tipo di enumerazione ItemSelectionConstants , specifica che il primo punto del tratto viene modificato.

[in, optional] Count

facoltativo. Numero di punti nel tratto da modificare. Il valore predefinito ISC_AllElements, definito nel tipo di enumerazione ItemSelectionConstants , specifica che tutti i punti nel tratto vengono modificati.

[out, retval] NumberOfPointsSet

Quando termina, questo metodo contiene il numero effettivo di pacchetti impostati.

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_INVALIDARG	Indice non valido (non compreso nell'intervallo) o parametro points. Il formato non è corretto.
E_INK_EXCEPTION	Si è verificata un'eccezione all'interno del metodo .

Commenti

Questo metodo non modifica il numero di punti nel tratto. Per modificare il numero di punti nel tratto, è necessario creare un nuovo tratto oppure dividere il tratto.

Questo metodo non fornisce per troncare il tratto. Se la matrice di punti contiene meno punti rispetto al tratto, il resto dei punti nel tratto non verrà modificato.

Questo metodo non fornisce l'estensione del tratto. Se la matrice di punti contiene più punti del tratto, i punti aggiuntivi non vengono utilizzati. Se il conteggio supera il numero di punti nella matrice, vengono modificati solo il numero di punti nella matrice.

Per disegnare il tratto dopo aver chiamato SetPoints, chiamare la funzione InvalidateRect .

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

Enumerazione ItemSelectionConstants

Condividi tramite