Metodo IInkTablet::GetPropertyMetrics (msinkaut.h)

Articolo
08/25/2023

Recupera i dati delle metriche per una proprietà specificata.

Sintassi

HRESULT GetPropertyMetrics(
  [in]  BSTR                     propertyName,
  [out] long                     *Minimum,
  [out] long                     *Maximum,
  [out] TabletPropertyMetricUnit *Units,
  [out] float                    *Resolution
);

Parametri

[in] propertyName

Proprietà per cui si desidera determinare le metriche.

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

[out] Minimum

Valore minimo, in unità logiche, segnalato dal tablet per questa proprietà. Ad esempio, un tablet che segnala valori x da 0 a 9000 ha un minimo logico pari a 0.

[out] Maximum

Valore massimo, in unità logiche, segnalato dal tablet per questa proprietà. Ad esempio, un tablet che segnala valori x da 0 a 9000 avrà un massimo logico di 9000.

[out] Units

Unità fisiche della proprietà, ad esempio pollici o gradi. Per un elenco delle unità di proprietà, vedere il tipo di enumerazione TabletPropertyMetricUnit .

[out] Resolution

Specifica il valore di risoluzione o incremento per il membro unità . Ad esempio, un tablet che segnala 400 punti per pollice (dpi) ha un valore di risoluzione pari a 400.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
TPC_E_UNKNOWN_PROPERTY	Il tablet non supporta la proprietà specificata.
E_FAIL	Si è verificato un errore non specificato.
E_POINTER	Un parametro contiene un puntatore non valido.
CO_E_CLASSSTRING	Formato GUID non valido.
E_INVALIDARG	Stringa di proprietà sconosciuta.
E_INK_EXCEPTION	Eccezione durante l'elaborazione.

Commenti

Le proprietà per cui si recuperano le metriche possono includere il tempo in cui è stato generato un pacchetto o la pressione verso il basso della punta della penna sulla superficie del tablet.

Per un elenco completo delle proprietà per cui è possibile recuperare le metriche, vedere le costanti PacketProperty .

Nota L'accesso a questa proprietà all'interno di determinati gestori di messaggi può comportare la reinsezione della funzione sottostante, causando risultati imprevisti. Prestare attenzione a evitare una chiamata ricorsiva durante la gestione di uno dei messaggi seguenti: WM_ACTIVATE, WM_ACTIVATEAPP, WMNCACTIVATE, WM_PAINT; WM_SYSCOMMAND se wParam è impostato su SC_HOTKEY o SC_TASKLIST; e WM_SYSKEYDOWN (durante l'elaborazione di combinazioni di tasti di Alt-Tab o di Alt-Esc). Si tratta di un problema con le applicazioni di modello apartment a thread singolo.

Requisiti


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