Compartilhar via


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

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 get_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

Confira também

Propriedade AttachMode

Propriedade CollectingInk

Propriedade CollectionMode [Classe InkCollector]

Propriedade EditingMode [Classe InkOverlay]

Iinkoverlay

Tinta

Classe InkOverlay

Propriedade MarginX

Propriedade MarginY

Método SetAllTabletsMode

Método SetSingleTabletIntegratedMode

Método SetWindowInputRectangle

Propriedade hWnd