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

Artículo
03/08/2023

Obtiene o establece un valor que especifica si el objeto InkOverlay recopila entradas de lápiz (paquetes en aire, cursor en eventos de intervalo, etc.).

Esta propiedad es de lectura y escritura.

Sintaxis

HRESULT put_Enabled(
  VARIANT_BOOL Collecting
);

Parámetros

Collecting

Valor devuelto

Ninguno

Observaciones

Si el rectángulo de entrada de ventana de un objeto habilitado (establecido en el constructor o con el método SetWindowInputRectangle ) de un objeto habilitado se superpone al rectángulo de entrada de ventana de otro objeto habilitado, se devuelve el error E_INK_OVERLAPPING_INPUT_RECT. La superposición puede producirse sin un error siempre y cuando solo se habilite uno de los rectángulos de entrada en cualquier momento conocido.

Aunque un objeto no está habilitado, no recibirá ningún evento.

Cuando un control de contenedor tiene su propiedad Enabled establecida en FALSE, también se deshabilitan todos sus controles contenidos.

No se puede establecer la propiedad Enabled en FALSE mientras el objeto está recopilando entrada de lápiz (la propiedad CollectingInk es TRUE).

Se recomienda establecer Habilitado establecido en FALSE cuando se cierre la aplicación.

Nota Establecer esta propiedad dentro de determinados controladores de mensajes puede dar lugar a que se vuelva a escribir la función subyacente, lo que provoca resultados inesperados. Tenga cuidado de evitar una llamada reentrant cuando controle cualquiera de los siguientes mensajes: WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT; WM_SYSCOMMAND si wParam está establecido en SC_HOTKEY o SC_TASKLIST; y WM_SYSKEYDOWN (al procesar combinaciones de teclas Alt-Tab o Alt-Esc). Se trata de un problema con las aplicaciones de modelo de apartamento de un solo subproceso.

Esta propiedad debe establecerse en FALSE antes de establecer o llamar a propiedades y métodos específicos del objeto. Si intenta cambiar las propiedades o métodos especificados, se produce un error. No se pueden establecer ni llamar a las siguientes propiedades y métodos a menos que la propiedad Enabled se establezca primero en FALSE:

Propiedades

Métodos

Requisitos


Cliente mínimo compatible	Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	msinkaut.h
Library	InkObj.dll