Método IInkOverlay::GetGestureStatus (msinkaut.h)

Recupera um valor que determina se o objeto InkCollector ou InkOverlay está interessado em um gesto de aplicativo específico.

Sintaxe

HRESULT GetGestureStatus(
  [in]          InkApplicationGesture Gesture,
  [out, retval] VARIANT_BOOL          *Listening
);

Parâmetros

[in] Gesture

O gesto do qual você deseja a status.

[out, retval] Listening

VARIANT_TRUE se o controle InkCollector tiver interesse em um gesto de aplicativo específico; caso contrário, VARIANT_FALSE.

Esse método retorna um valor que indica o interesse do objeto InkCollector ou InkOverlay em um gesto de aplicativo conhecido. Se VARIANT_TRUE, o objeto InkCollector ou InkOverlay estará interessado no gesto e o evento Gesture do objeto InkCollector ou InkOverlay será acionado quando o gesto for reconhecido.

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_INK_INVALID_MODE	O modo de coleta deve estar no modo de gesto.
E_OUTOFMEMORY	Não é possível alocar memória para executar a ação.
E_INK_EXCEPTION	Ocorreu uma exceção.
E_INVALIDARG	O sinalizador é inválido.

Comentários

Esse método gerará uma exceção se o parâmetro de gesto estiver definido como IAG_AllGestures.

Para definir o interesse do objeto InkCollector ou InkOverlay em um gesto específico, chame o método SetGestureStatus do objeto InkCollector ou InkOverlay.

Nota Por padrão, os objetos InkCollector e InkOverlay não têm interesse em nenhum dos gestos do aplicativo.

 

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

Confira também

Evento gesto

Iinkoverlay

Enumeração InkApplicationGesture

Classe InkOverlay

Método SetGestureStatus