Share via


Método IInkCollector::SetEventInterest (msinkaut.h)

Modifica um valor que indica se um objeto ou controle tem interesse em um evento especificado.

Sintaxe

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

Parâmetros

[in] EventId

O evento a ser escutado.

[in] Listen

VARIANT_TRUE para indicar que o evento está sendo usado; VARIANT_FALSE se estiver sendo ignorado.

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
Êxito.
E_POINTER
Um parâmetro continha um ponteiro inválido.
E_INVALIDARG
Interesse de evento inválido.
E_INK_EXCEPTION
Ocorreu uma exceção durante o processamento.

Comentários

Todos os eventos do coletor de tinta podem ser alternados usando esse método. A maioria desses eventos é desativada por padrão por motivos de desempenho. Os únicos eventos que estão ativados por padrão são Stroke, CursorInRange e CursorOutOfRange.

Use os eventos NewPackets, NewInAirPackets e CursorDown com cuidado, especialmente porque eles podem ter um efeito adverso no desempenho da tinta se muito código for executado nos manipuladores de eventos.

Requisitos

   
Cliente mínimo com suporte Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho msinkaut.h
Biblioteca InkObj.dll

Confira também

Evento CursorDown

Evento CursorInRange

Método GetEventInterest

IInkCollector

Classe InkCollector

Enumeração InkCollectorEventInterest

Evento NewPackets

Evento Stroke