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

Artikel
08/24/2023

Ruft einen Wert ab, der angibt, ob das InkOverlay-Objekt Stifteingaben (Luftpakete, Cursor in Bereichsereignissen usw.) sammelt, oder legt ihn 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 überlappt, wird der E_INK_OVERLAPPING_INPUT_RECT Fehler zurückgegeben. Überlappungen können ohne Fehler auftreten, solange zu einem bekannten Zeitpunkt nur eines der Eingaberechtecke aktiviert ist.

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

Wenn die Enabled-Eigenschaft eines Containersteuerelements auf FALSE festgelegt ist, werden alle enthaltenen Steuerelemente ebenfalls deaktiviert.

Sie können die Enabled-Eigenschaft nicht auf FALSE festlegen, während das Objekt Freihandeingaben 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. Achten Sie darauf, einen erneuten Aufruf zu vermeiden, wenn Sie eine der folgenden Nachrichten behandeln: 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