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

Artigo
03/13/2024

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. Os valores possíveis para eventID aparecem no tipo de enumeração InkCollectorEventInterest .

[in] Listen

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

Retornar valor

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

Requisito	Valor
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