Metodo IInkStrokeDisp::SetPoints (msinkaut.h)

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. Si tratta di un valore VARIANT contenente una matrice di valori Long con i punti rappresentati da valori alternati del formato x0, y0, x1, y1, x2, y2 e così via.

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

[in, optional] Index

Optional. 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

Optional. Numero di punti nel tratto da modificare. Il valore predefinito ISC_AllElements, definito nel tipo di enumerazione ItemSelectionConstants , specifica che tutti i punti del 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
 Successo.
E_POINTER
 Un parametro contiene un puntatore non valido.
E_INVALIDARG
 Indice non valido (non compreso nell'intervallo) o parametro points. Non era nel formato corretto.
E_INK_EXCEPTION
 Si è verificata un'eccezione all'interno del metodo .

Osservazioni:

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 il troncamento del 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 Nessuna supportata
Piattaforma di destinazione Windows
Intestazione msinkaut.h

Vedere anche

Interfaccia IInkStrokeDisp

Enumerazione ItemSelectionConstants

  • Last updated on