InkPicture.InkEnabled-Eigenschaft
Ruft einen Wert ab, der angibt, ob das InkPicture-Steuerelement Stifteingaben erfasst, oder legt diesen fest.
Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)
Syntax
'Declaration
<BrowsableAttribute(True)> _
Public Property InkEnabled As Boolean
'Usage
Dim instance As InkPicture
Dim value As Boolean
value = instance.InkEnabled
instance.InkEnabled = value
[BrowsableAttribute(true)]
public bool InkEnabled { get; set; }
[BrowsableAttribute(true)]
public:
property bool InkEnabled {
bool get ();
void set (bool value);
}
/** @property */
/** @attribute BrowsableAttribute(true) */
public boolean get_InkEnabled()
/** @property */
/** @attribute BrowsableAttribute(true) */
public void set_InkEnabled(boolean value)
public function get InkEnabled () : boolean
public function set InkEnabled (value : boolean)
Eigenschaftenwert
Typ: System.Boolean
true , wenn das InkPicture-Steuerelement Stifteingaben erfasst. Standardwert.
false , wenn das InkPicture-Steuerelement 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 InkPicture-Steuerelement 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 die 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 InkEnabled-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 InkPicture ü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 InkEnabled-Eigenschaft nicht auf false festlegen, während das Steuerelement Freihandeingaben erfasst (CollectingInk-Eigenschaft ist true).
Die InkEnabled-Eigenschaft muss auf false festgelegt sein, bevor Sie bestimmte Eigenschaften und Methoden des Steuerelements 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 InkEnabled-Eigenschaft ist auf false festgelegt.
Eigenschaften:
Methoden:
Sie müssen die InkEnabled-Eigenschaft für ein InkPicture-Steuerelement auf false festlegen, bevor Sie eine Anwendung beenden.
Beispiele
Im folgenden Beispiel wird ein Ereignishandler für ein ButtonClick-Ereignis definiert. Wenn das Ereignis ausgelöst wird, schaltet der Handler den Wert der InkEnabled-Eigenschaft um und aktualisiert den Text des Button, sodass er die Aktion widerspiegelt, die beim nächsten Klicken ausgeführt wird.
' Event handler for the button's Click event.
Private Sub buttonToggle_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles buttonToggle.Click
' toggle the InkEnabled property and update button text
mInkPicture.InkEnabled = Not mInkPicture.InkEnabled
If mInkPicture.InkEnabled Then
DirectCast(sender, Button).Text = "Disable Ink"
Else
DirectCast(sender, Button).Text = "Enable Ink"
End If
End Sub
// Event handler for the button's Click event.
private void buttonToggle_Click(object sender, System.EventArgs e)
{
// toggle the InkEnabled property and update button text
mInkPicture.InkEnabled = !mInkPicture.InkEnabled;
((Button)sender).Text = (mInkPicture.InkEnabled) ? "Disable Ink" : "Enable Ink";
}
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