Proprietà InkPicture.InkEnabled

Articolo
10/29/2008

Aggiornamento: novembre 2007

Ottiene o imposta un valore che specifica se il controllo InkPicture raccoglie l'input penna.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
<BrowsableAttribute(True)> _
Public Property InkEnabled As Boolean
'Utilizzo
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)

Valore proprietà

Tipo: System.Boolean
true se il controllo InkPicture raccoglie l'input penna. Predefinito.
false se il controllo InkPicture non raccoglie l'input penna. Non vengono generati eventi correlati alla penna.

Note

L'input penna può includere inoltre pacchetti in-air, il cursore in eventi dell'intervallo e così via.

Il controllo InkPicture raccoglie l'input penna in Microsoft® Windows® XP Tablet PC Edition o in qualsiasi versione di Windows 2000, Windows Server 2003 o Windows XP in cui sia installato l'SDK di Windows XP Tablet PC Edition. Tuttavia, il riconoscimento grafia viene eseguito solo se si utilizza Windows XP Tablet PC Edition. In tutte le versioni di Windows 2000, Windows Server 2003 o Windows XP diverse da Windows XP Tablet PC Edition, la proprietà InkEnabled risulta sempre false se non è installato l'SDK di Windows XP Tablet PC Edition.

Se il rettangolo di input della finestra di un oggetto InkCollector o InkOverlay attivato (impostato nel costruttore o con il metodo SetWindowInputRectangle) è sovrapposto al rettangolo di input della finestra di un oggetto InkPicture, viene generata un'eccezione COMException.

Nota

La sovrapposizione può verificarsi senza errori se in qualsiasi momento è abilitato uno solo dei rettangoli di input.

Se non è attivato un controllo, non si ricevono eventi.

Quando si imposta la proprietà Enabled di un controllo contenitore su false, vengono disattivati anche tutti i controlli in esso contenuti.

Non è possibile impostare la proprietà InkEnabled su false mentre il controllo raccoglie l'input penna (la proprietà CollectingInk è true).

La proprietà InkEnabled deve essere impostata su false prima di impostare o chiamare proprietà e metodi specifici del controllo. Se si tenta di modificare le proprietà specificate o di chiamare i metodi specificati, viene generato un errore.

Le proprietà e i metodi seguenti non possono essere impostati o chiamati a meno che la proprietà InkEnabled non sia impostata prima su false:

Proprietà:
- Ink
- MarginX
- MarginY
Metodi:
- SetAllTabletsMode
- SetSingleTabletIntegratedMode

È necessario impostare la proprietà InkEnabled di un controllo InkPicture su false prima di chiudere un'applicazione.

Esempi

Nell'esempio seguente viene definito un gestore eventi per un evento ButtonClick. Quando l'evento viene generato, il gestore attiva o disattiva il valore della proprietà InkEnabled e aggiorna il testo dell'oggetto Button in modo da riflettere l'azione che sarà eseguita con l'evento Click successivo.

' 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";
}

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.