IInkPicture::get_InkEnabled-Methode (msinkaut.h)

Artikel
08/25/2023

Ruft einen Wert ab, der angibt, ob das InkPicture-Steuerelement Stifteingaben sammelt (In-Air-Pakete, Cursor in Bereichsereignissen usw.).

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 Freihand in Windows Vista, Microsoft Windows XP Tablet PC Edition oder einer beliebigen Edition von Windows 2000, Windows Server 2003 oder Windows XP, auf der das Windows XP Tablet PC Edition Software Development Kit (SDK) installiert ist. Die Handschrifterkennung erfolgt jedoch nur, wenn Windows Vista, Windows XP Tablet PC Edition oder das Erkennungspaket installiert ist.

In einer anderen Edition von Windows 2000, Windows Server 2003 oder Windows XP als Windows XP Tablet PC Edition ist die InkEnabled-Eigenschaft immer FALSE , 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 Eine Überlappung kann ohne Fehler auftreten, solange jederzeit nur eines der Eingaberechtecke aktiviert ist.

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

Wenn die Enabled-Eigenschaft eines Container-InkPicture-Steuerelements auf 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).

Um optimale Ergebnisse zu erzielen, legen Sie die Enabled-Eigenschaft auf VARIANT_FALSE fest, wenn eine Anwendung heruntergefahren wird.

Diese Eigenschaft muss auf VARIANT_FALSE festgelegt werden, bevor bestimmte Eigenschaften und Methoden des Steuerelements festgelegt oder aufgerufen 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

Anforderung	Wert
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