IInkCollector::p ut_Enabled-Methode (msinkaut.h)

Artikel
08/24/2023

Ruft einen Wert ab, der angibt, ob das InkCollector-Objekt Stifteingaben (In-Air-Pakete, Cursor in Bereichsereignissen usw.) sammelt, oder legt diesen fest.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT put_Enabled(
  VARIANT_BOOL Collecting
);

Parameter

Collecting

Rückgabewert

Keine

Bemerkungen

Wenn das Fenstereingaberechteck eines aktivierten Objekts (festgelegt im Konstruktor oder mit der SetWindowInputRectangle-Methode ) eines aktivierten Objekts das Fenstereingaberechteck eines anderen aktivierten Objekts überschneidet, wird der E_INK_OVERLAPPING_INPUT_RECT-Fehler zurückgegeben. Eine Überlappung kann ohne Fehler auftreten, solange nur eines der Eingaberechtecke zu einem bekannten Zeitpunkt aktiviert ist.

Während ein Objekt nicht aktiviert ist, erhalten Sie keine Ereignisse.

Wenn für ein Containersteuerelement die Enabled-Eigenschaft auf FALSE festgelegt ist, werden alle enthaltenen Steuerelemente ebenfalls deaktiviert.

Sie können die Enabled-Eigenschaft nicht auf FALSE festlegen, während das Objekt Freihand sammelt (CollectingInk-Eigenschaft ist TRUE).

Es wird empfohlen, aktiviert auf FALSE festzulegen, wenn die Anwendung heruntergefahren wird.

Hinweis Das Festlegen dieser Eigenschaft in bestimmten Nachrichtenhandlern kann dazu führen, dass die zugrunde liegende Funktion erneut eingegeben wird, was zu unerwarteten Ergebnissen führt. Vermeiden Sie beim Behandeln einer der folgenden Nachrichten einen erneuten Aufruf: WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT; WM_SYSCOMMAND , wenn wParam auf SC_HOTKEY oder SC_TASKLIST festgelegt ist; und WM_SYSKEYDOWN (bei der Verarbeitung Alt-Tab oder Alt-Esc Tastenkombinationen). Dies ist ein Problem mit Singlethread-Apartmentmodellanwendungen.

Diese Eigenschaft muss auf FALSE festgelegt werden , bevor bestimmte Eigenschaften und Methoden des Objekts festgelegt oder aufgerufen werden. Wenn Sie versuchen, die angegebenen Eigenschaften oder Methoden zu ändern, 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 FALSE festgelegt:

Eigenschaften

Methoden

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