InkOverlay.Enabled-Eigenschaft
Ruft einen Wert ab, der angibt, ob das InkOverlay-Objekt Stifteingaben erfasst, oder legt diesen Wert fest.
Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)
Syntax
'Declaration
<BrowsableAttribute(False)> _
Public Property Enabled As Boolean
'Usage
Dim instance As InkOverlay
Dim value As Boolean
value = instance.Enabled
instance.Enabled = value
[BrowsableAttribute(false)]
public bool Enabled { get; set; }
[BrowsableAttribute(false)]
public:
property bool Enabled {
bool get ();
void set (bool value);
}
/** @property */
/** @attribute BrowsableAttribute(false) */
public boolean get_Enabled()
/** @property */
/** @attribute BrowsableAttribute(false) */
public void set_Enabled(boolean value)
public function get Enabled () : boolean
public function set Enabled (value : boolean)
Eigenschaftenwert
Typ: System.Boolean
Ein Wert, der angibt, ob das InkOverlay-Objekt Stifteingaben erfasst oder nicht.
true , wenn das InkOverlay-Objekt Stifteingaben erfasst.
false, wenn das InkOverlay-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 InkOverlay-Objekt erfasst Freihandeingaben unter Microsoft Windows Vista, 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. Handschrifteingaben werden jedoch erst ab Windows XP Tablet PC Edition erkannt. In allen Editionen von Windows 2000, Windows Server 2003 oder Windows XP außer Windows XP Tablet PC Edition ist die Enabled-Eigenschaft 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 InkOverlay ü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:
Methoden:
Sie müssen die Enabled-Eigenschaft für ein InkOverlay-Objekt auf false festlegen, bevor Sie eine Anwendung beenden.
Beispiele
In diesem C#-Beispiel wird ein InkOverlay-Objekt erstellt und aktiviert.
using Microsoft.Ink;
//...
InkOverlay theInkOverlay = new InkOverlay(Handle);
theInkOverlay.Enabled = true;
//...
In diesem Microsoft Visual Basic .NET-Beispiel wird ein InkOverlay-Objekt erstellt und aktiviert.
Imports Microsoft.Ink
'...
Dim theInkOverlay As New InkOverlay(Handle)
theInkOverlay.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.
Versionsinformationen
.NET Framework
Unterstützt in: 3.0