Metodo IInkPicture::SetEventInterest (msinkaut.h)

Articolo
03/05/2024

Modifica un valore che indica se un oggetto o un controllo ha interesse per un evento specificato.

Sintassi

HRESULT SetEventInterest(
  [in] InkCollectorEventInterest EventId,
  [in] VARIANT_BOOL              Listen
);

Parametri

[in] EventId

Evento da ascoltare. I valori possibili per eventID vengono visualizzati nel tipo di enumerazione InkCollectorEventInterest .

[in] Listen

VARIANT_TRUE per indicare che l'evento è in uso; VARIANT_FALSE per indicare che l'evento viene ignorato.

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_INVALIDARG	Interesse per gli eventi non valido.
E_INK_EXCEPTION	Si è verificata un'eccezione durante l'elaborazione.

Commenti

È possibile attivare o disattivare tutti gli eventi dell'agente di raccolta input penna tramite questo metodo. La maggior parte di questi eventi è disattivata per impostazione predefinita per motivi di prestazioni. Gli unici eventi attivati per impostazione predefinita sono Stroke, CursorInRange e CursorOutOfRange.

Usare attentamente gli eventi NewPackets, NewInAirPackets e CursorDown , in particolare perché potrebbero avere un effetto negativo sulle prestazioni dell'input penna se nei gestori eventi viene eseguita una quantità eccessiva di codice.

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