Condividi tramite


Metodo IInkStrokeDisp::GetPacketData (msinkaut.h)

Recupera i dati del pacchetto per un intervallo di pacchetti all'interno dell'oggetto IInkStrokeDisp .

Sintassi

HRESULT GetPacketData(
  [in, optional] long    Index,
  [in, optional] long    Count,
  [out, retval]  VARIANT *PacketData
);

Parametri

[in, optional] Index

Optional. Punto iniziale dell'indice in base zero a un pacchetto all'interno del tratto. Il valore predefinito ISC_FirstElement, definito nel tipo di enumerazione InkSelectionConstants , specifica il primo pacchetto.

[in, optional] Count

Optional. Numero di set di dati di pacchetti di punti che devono essere restituiti, a partire dal pacchetto specificato nel parametro startingIndex . Il valore predefinito ISC_AllElements, definito nel tipo di enumerazione InkSelectionConstants , specifica tutti i punti che costituiscono i dati del tratto.

[out, retval] PacketData

Quando termina, questo metodo contiene una matrice integer a 32 bit con segno contenente i dati del pacchetto per i punti richiesti nel tratto. La matrice contiene i dati per il primo punto, quindi i dati per il secondo punto e così via.

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

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_FAIL
Si è verificato un errore non specificato.
E_OUTOFMEMORY
Impossibile allocare l'oggetto helper del gestore stroke.
E_INVALIDARG
Il tratto non è valido.
E_INK_EXCEPTION
Si è verificata un'eccezione all'interno del metodo .
E_UNEXPECTED
Parametro o tipo di proprietà imprevisto.

Osservazioni:

Se il numero di pacchetti nel tratto è minore della somma dei parametri startingIndex e pointCount , la matrice restituita di dati contiene informazioni sui pacchetti per un numero inferiore di punti rispetto al conteggio richiesto.

Per recuperare la descrizione dei dati del pacchetto, utilizzare la proprietà PacketDescription del tratto. Questa proprietà restituisce una matrice di identificatore univoco globale (GUID) che indica quali valori di proprietà vengono restituiti dal metodo GetPacketData per ogni punto. Le costanti PacketProperty contengono i GUID delle proprietà del pacchetto disponibili.

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

Metodo GetPacketDescriptionPropertyMetrics

Metodo GetPacketValuesByProperty

Interfaccia IInkStrokeDisp

Enumerazione ItemSelectionConstants

PacketCount, proprietà

PacketDescription, proprietà

PacketSize, proprietà

Metodo SetPacketValuesByProperty