Método IInkOverlay::p ut_Enabled (msinkaut.h)

Artigo
08/24/2023

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

Essa propriedade é leitura/gravação.

Sintaxe

HRESULT put_Enabled(
  VARIANT_BOOL Collecting
);

Parâmetros

Collecting

Valor retornado

Nenhum

Comentários

Se o retângulo de entrada da janela de um objeto habilitado (definido no construtor ou com o método SetWindowInputRectangle ) de um objeto habilitado sobrepor o retângulo de entrada de janela de outro objeto habilitado, o erro E_INK_OVERLAPPING_INPUT_RECT será retornado. A sobreposição pode ocorrer sem um erro, desde que apenas um dos retângulos de entrada esteja habilitado em qualquer momento conhecido.

Embora um objeto não esteja habilitado, você não receberá nenhum evento.

Quando um controle de contêiner tem sua propriedade Enabled definida como FALSE, todos os seus controles contidos também são desabilitados.

Não é possível definir a propriedade Enabled como FALSE enquanto o objeto estiver coletando tinta (a propriedade CollectingInk é TRUE).

Recomendamos que você defina Habilitado definido como FALSE quando o aplicativo for desligado.

Nota Definir essa propriedade em determinados manipuladores de mensagens pode fazer com que a função subjacente seja inserida novamente, causando resultados inesperados. Tome cuidado para evitar uma chamada reentrada ao lidar com qualquer uma das seguintes mensagens: WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT; WM_SYSCOMMAND se wParam estiver definido como SC_HOTKEY ou SC_TASKLIST; e WM_SYSKEYDOWN (ao processar combinações de teclas Alt-Tab ou Alt-Esc). Esse é um problema com aplicativos de modelo de apartment de thread único.

Essa propriedade deve ser definida como FALSE antes de definir ou chamar propriedades e métodos específicos do objeto. Se você tentar alterar as propriedades ou 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 como FALSE:

Propriedades

Métodos

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