Metodo IInkStrokeDisp::GetPacketValuesByProperty (msinkaut.h)

Articolo
03/05/2024

Recupera i dati per una proprietà di pacchetto nota da uno o più pacchetti nel tratto.

Sintassi

HRESULT GetPacketValuesByProperty(
  [in]           BSTR    PropertyName,
  [in, optional] long    Index,
  [in, optional] long    Count,
  [out, retval]  VARIANT *PacketValues
);

Parametri

[in] PropertyName

Identificatore delle costanti PacketProperty utilizzate per selezionare i dati dei pacchetti recuperati.

Per altre informazioni sul tipo di dati BSTR, vedere Uso della libreria COM.

[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 punti che costituiscono i dati del tratto. Il valore predefinito ISC_AllElements, definito nel tipo di enumerazione InkSelectionConstants , specifica tutti i punti che costituiscono i dati del tratto.

[out, retval] PacketValues

Quando termina, questo metodo contiene una matrice di interi a 32 bit con segno che specifica il valore dell'oggetto PacketProperty richiesto per ogni punto richiesto dal tratto.

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.
TPC_E_INVALID_STROKE	Il tratto non è valido.
E_POINTER	Un parametro contiene un puntatore non valido.
E_FAIL	Si è verificato un errore non specificato.
E_OUTOFMEMORY	Impossibile allocare la matrice di dati dei pacchetti.
E_INVALIDARG	Proprietà index, count o packet non valida.
E_INK_EXCEPTION	Si è verificata un'eccezione all'interno del metodo .
CO_E_CLASSSTRING	Formato GUID non valido.

Commenti

Una proprietà di pacchetto specifica potrebbe non essere disponibile in un particolare oggetto IInkStrokeDisp . Un TABLET PC può avere più di un tablet per l'input dell'utente. L'insieme InkTablets contiene un elenco di tutti i tablet collegati al Tablet PC. Utilizzare il metodo IsPacketPropertySupported per determinare se una particolare proprietà di pacchetto è supportata da un oggetto IInkTablet specifico o da tutti i tablet disponibili. Utilizzare inoltre la proprietà DesiredPacketDescriptiondell'agente di raccolta input penna per controllare le proprietà dei pacchetti raccolte sui nuovi tratti.

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