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

Artigo
08/25/2023

Obtém ou define um valor que especifica se o controle InkPicture coleta entrada de caneta (pacotes no ar, cursor em eventos de intervalo e assim por diante).

Essa propriedade é leitura/gravação.

Sintaxe

HRESULT get_InkEnabled(
  VARIANT_BOOL *Collecting
);

Parâmetros

Collecting

Valor retornado

Nenhum

Comentários

O controle InkPicture coleta tinta no Windows Vista, Microsoft Windows XP Tablet PC Edition ou em qualquer edição do Windows 2000, Windows Server 2003 ou Windows XP em que o SDK (Software Development Kit) do Windows XP Tablet PC Edition está instalado. No entanto, o reconhecimento de manuscrito ocorrerá somente se o Windows Vista, o Windows XP Tablet PC Edition ou o Recognizer Pack estiver instalado.

Em qualquer edição do Windows 2000, Windows Server 2003 ou do Windows XP diferente do Windows XP Tablet PC Edition, a propriedade InkEnabled sempre será FALSE se o SDK do Tablet PC não estiver instalado.

Se o retângulo de entrada da janela de um objeto habilitado (definido no construtor ou com o Método SetWindowInputRectangle) sobrepor o retângulo de entrada da janela de outro objeto habilitado, o erro E_INK_OVERLAPPING_INPUT_RECT será retornado.

Nota A sobreposição pode ocorrer sem um erro, desde que apenas um dos retângulos de entrada esteja habilitado a qualquer momento.

Embora o controle InkPicture não esteja habilitado, você não receberá eventos.

Quando a propriedade Enabled de um controle InkPicture de contêiner é definida como VARIANT_FALSE, todos os controles contidos também são desabilitados.

Não é possível definir essa propriedade como VARIANT_FALSE enquanto o controle InkPicture estiver coletando tinta (a propriedade CollectingInk property é VARIANT_TRUE).

Para obter melhores resultados, defina a propriedade Enabled como VARIANT_FALSE quando um aplicativo for desligado.

Essa propriedade deve ser definida como VARIANT_FALSE antes de definir ou chamar propriedades e métodos específicos do controle. Se você tentar alterar as propriedades especificadas ou chamar os métodos especificados, ocorrerá um erro. As seguintes propriedades e métodos não podem ser definidos ou chamados, a menos que a propriedade Enabled seja definida primeiro como VARIANT_FALSE:

Propriedades:
Métodos:
- Método SetAllTabletsMode
- Método SetSingleTabletIntegratedMode

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