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

Artículo
03/08/2023

Obtiene o establece un valor que especifica si el control InkPicture recopila la entrada del lápiz (paquetes en aire, cursor en eventos de intervalo, etc.).

Esta propiedad es de lectura y escritura.

Sintaxis

HRESULT get_InkEnabled(
  VARIANT_BOOL *Collecting
);

Parámetros

Collecting

Valor devuelto

None

Observaciones

El control InkPicture recopila tinta en Windows Vista, Microsoft Windows XP Tablet PC Edition o cualquier edición de Windows 2000, Windows Server 2003 o Windows XP en la que está instalado el Kit de desarrollo de software (SDK) de Windows XP Tablet PC Edition. Sin embargo, el reconocimiento de escritura a mano solo se produce si Windows Vista, Windows XP Tablet PC Edition o recognizer Pack está instalado.

En cualquier edición de Windows 2000, Windows Server 2003 o de Windows XP que no sea Windows XP Tablet PC Edition, la propiedad InkEnabled siempre es FALSE si el SDK del PC tableta no está instalado.

Si el rectángulo de entrada de ventana de un objeto habilitado (establecido en el constructor o con el método SetWindowInputRectangle) se superpone al rectángulo de entrada de ventana de otro objeto habilitado, se devuelve el error E_INK_OVERLAPPING_INPUT_RECT.

Nota La superposición puede producirse sin un error siempre que solo se habilite uno de los rectángulos de entrada en cualquier momento.

Aunque el control InkPicture no está habilitado, no recibirá ningún evento.

Cuando la propiedad Enabled de un control InkPicture contenedor se establece en VARIANT_FALSE, todos sus controles contenidos también están deshabilitados.

No se puede establecer esta propiedad en VARIANT_FALSE mientras el control InkPicture está recopilando tinta (la propiedad CollectingInk property es VARIANT_TRUE).

Para obtener los mejores resultados, establezca la propiedad Enableden VARIANT_FALSE cuando se cierre una aplicación.

Esta propiedad debe establecerse en VARIANT_FALSE antes de establecer o llamar a propiedades y métodos específicos del control. Si intenta cambiar las propiedades especificadas o llamar a los 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 VARIANT_FALSE:

Propiedades:
Métodos:
- SetAllTabletsMode (método)
- SetSingleTabletIntegratedMode (método)

Requisitos

Requisito	Value
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