Metodo IInkStrokeDisp::GetPacketData (msinkaut.h)

Articolo
03/05/2024

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

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

facoltativo. 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 di interi 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	Operazione completata.
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.

Commenti

Se il numero di pacchetti nel tratto è minore della somma dei parametri startingIndex e pointCount , la matrice di dati restituita 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 i valori delle proprietà 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	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	msinkaut.h
Libreria	InkObj.dll