InkCollector.Enabled-Eigenschaft

Artikel
11/26/2008

Ruft einen Wert ab, der angibt, ob das InkCollector-Objekt Stifteingaben erfasst, oder legt diesen Wert fest.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Property Enabled As Boolean
'Usage
Dim instance As InkCollector
Dim value As Boolean

value = instance.Enabled

instance.Enabled = value

public bool Enabled { get; set; }

public:
property bool Enabled {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_Enabled()
/** @property */
public  void set_Enabled(boolean value)

public function get Enabled () : boolean
public function set Enabled (value : boolean)

Eigenschaftenwert

Typ: System.Boolean
true , wenn das InkCollector-Objekt Stifteingaben erfasst. false, wenn das InkCollector-Objekt Stifteingaben nicht meldet. Es werden keine stiftbezogenen Ereignisse ausgelöst.

Hinweise

Neben Freihandeingaben kann die Stifteingabe auch Ereignisse mit In-Air-Paketen oder einem Zeiger im Nahbereich usw. umfassen.

Das InkCollector-Objekt erfasst Freihandeingaben unter Microsoft® Windows® XP Tablet PC Edition oder allen Editionen von Windows 2000, Windows Server 2003 oder Windows XP, auf denen das Windows XP Tablet PC Edition SDK installiert ist. Handschrift wird jedoch nur erkannt, wenn Sie Windows XP Tablet PC Edition verwenden. In allen Editionen von Windows 2000, Windows Server 2003 oder Windows XP außer Windows XP Tablet PC Edition ist die Enabled-Eigenschaft immer false, wenn das Windows XP Tablet PC Edition SDK nicht installiert ist.

Wenn das Eingaberechteck für das Fenster eines aktivierten InkCollector oder InkOverlay (im Konstruktor oder mit der SetWindowInputRectangle-Methode festgelegt) das Eingaberechteck für das Fenster eines InkCollector überlappt, wird eine COMException-Ausnahme ausgelöst.

Hinweis

Überlappungen führen zu keinem Fehler, wenn mindestens eines der Eingaberechtecke zu jedem Zeitpunkt aktiviert ist.

Während ein Steuerelement nicht aktiviert ist, werden keine Ereignisse empfangen.

Wenn Sie die Enabled-Eigenschaft eines Containersteuerelements auf false festlegen, werden sämtliche darin enthaltenen Steuerelemente ebenfalls deaktiviert.

Sie können die Enabled-Eigenschaft nicht auf false festlegen, während das Objekt Freihandeingaben erfasst (die CollectingInk-Eigenschaft ist true).

Die Enabled-Eigenschaft muss auf false festgelegt sein, bevor Sie bestimmte Eigenschaften und Methoden des Objekts festlegen oder aufrufen. 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 ist auf false festgelegt.

Eigenschaften:
- Handle
- Ink
- MarginX
- MarginY
Methoden:
- SetAllTabletsMode
- SetSingleTabletIntegratedMode

Sie müssen die Enabled-Eigenschaft für ein InkCollector-Objekt auf false festlegen, bevor Sie eine Anwendung beenden.

Hinweis

Diese Funktion kann rekursiv ausgeführt werden, wenn die Enabled-Eigenschaft in bestimmten Meldungshandlern festgelegt wird und unerwartete Ergebnisse verursacht. Vermeiden Sie unbedingt den wieder eintretenden Aufruf, wenn Sie eine der folgenden Meldungen behandeln: WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT sowie WM_SYSCOMMAND, wenn wParam auf SC_HOTKEY oder SC_TASKLIST festgelegt ist, und WM_SYSKEYDOWN (wenn die Tastenkombinationen ALT+TAB oder ALT+ESC verarbeitet werden). Dieses Problem tritt bei Anwendungen des Singlethread-Apartment-Modells auf.

Beispiele

In diesem C#-Beispiel wird ein InkCollector-Objekt erstellt und aktiviert.

using Microsoft.Ink;
//...
InkCollector theInkCollector = new InkCollector(Handle);
theInkCollector.Enabled = true;
//...

In diesem Microsoft Visual Basic .NET-Beispiel wird ein InkCollector-Objekt erstellt und aktiviert.

Imports Microsoft.Ink
'...
Dim theInkCollector As New InkCollector(Handle)
theInkCollector.Enabled() = True
'...

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.