IInkPicture::get_InkEnabled-Methode (msinkaut.h)

Artikel
03/20/2023
2 Minuten Lesedauer

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das InkPicture-Steuerelement Stifteingaben (In-Air-Pakete, Cursor in Bereichsereignissen usw.) sammelt.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT get_InkEnabled(
  VARIANT_BOOL *Collecting
);

Parameter

Collecting

Rückgabewert

Keine

Bemerkungen

Das InkPicture-Steuerelement sammelt Freihandeingaben in Windows Vista, Microsoft Windows XP Tablet PC Edition oder einer beliebigen Version von Windows 2000, Windows Server 2003 oder Windows XP, auf dem das Windows XP Tablet PC Edition Software Development Kit (SDK) installiert ist. Die Handschrifterkennung tritt jedoch nur auf, wenn Windows Vista, Windows XP Tablet PC Edition oder das Erkennungspaket installiert ist.

In jeder Edition von Windows 2000, Windows Server 2003 oder windows XP außer Windows XP Tablet PC Edition ist die InkEnabled-Eigenschaft immer FALSCH , wenn das Tablet PC SDK nicht installiert ist.

Wenn das Fenstereingaberechteck eines aktivierten Objekts (festgelegt im Konstruktor oder mit der SetWindowInputRectangle-Methode) das Fenstereingaberechteck eines anderen aktivierten Objekts überschneidet, wird der E_INK_OVERLAPPING_INPUT_RECT Fehler zurückgegeben.

Hinweis Überlappungen können ohne Fehler auftreten, solange jeweils nur ein Eingaberechteck aktiviert ist.

Während das InkPicture-Steuerelement nicht aktiviert ist, erhalten Sie keine Ereignisse.

Wenn die Enabled-Eigenschaft eines Container-InkPicture-Steuerelementsauf VARIANT_FALSE festgelegt ist, werden alle enthaltenen Steuerelemente ebenfalls deaktiviert.

Sie können diese Eigenschaft nicht auf VARIANT_FALSE festlegen, während das InkPicture-Steuerelement Freihand sammelt (die CollectingInk-Eigenschaft ist VARIANT_TRUE).

Legen Sie für optimale Ergebnisse die Enabled-Eigenschaft auf VARIANT_FALSE fest, wenn eine Anwendung heruntergefahren wird.

Diese Eigenschaft muss vor dem Festlegen oder Aufrufen bestimmter Eigenschaften und Methoden des Steuerelements auf VARIANT_FALSE festgelegt werden. Wenn Sie versuchen, die angegebenen Eigenschaften zu ändern oder die angegebenen Methoden aufzurufen, tritt ein Fehler auf. Die folgenden Eigenschaften und Methoden können nicht festgelegt oder aufgerufen werden, es sei denn, die Enabled-Eigenschaft wird zuerst auf VARIANT_FALSE festgelegt:

Eigenschaften:
Methoden:
- SetAllTabletsMode-Methode
- SetSingleTabletIntegratedMode-Methode

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP Tablet PC Edition [Nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	msinkaut.h
Bibliothek	InkObj.dll