Classe InkOverlay

Articolo
10/29/2008

Aggiornamento: novembre 2007

Rappresenta un oggetto utile per scenari di annotazione in cui l'interesse degli utenti non riguarda l'esecuzione del riconoscimento sull'input penna, bensì la dimensione, la forma, il colore e la posizione dell'input penna.

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

Sintassi

'Dichiarazione
<UIPermissionAttribute(SecurityAction.Demand, Window := UIPermissionWindow.SafeTopLevelWindows)> _
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
Public Class InkOverlay _
    Implements IDisposable
'Utilizzo
Dim instance As InkOverlay

[UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows)]
[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
public class InkOverlay : IDisposable

[UIPermissionAttribute(SecurityAction::Demand, Window = UIPermissionWindow::SafeTopLevelWindows)]
[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = L"FullTrust")]
public ref class InkOverlay : IDisposable

/** @attribute UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows) */
/** @attribute PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust") */
public class InkOverlay implements IDisposable

public class InkOverlay implements IDisposable

Note

Avviso

Per evitare una perdita di memoria, è necessario chiamare in modo esplicito il metodo Dispose su qualsiasi oggetto InkOverlay a cui è stato associato un gestore eventi, prima che l'oggetto esca dall'ambito.

L'oggetto InkOverlay è adatto per prendere appunti e scribacchiare. La funzione principale di questo oggetto consiste nel visualizzare l'input penna come tale.

In generale, l'interfaccia utente in fase di esecuzione per questo oggetto è una finestra trasparente con l'input penna opaco.

Gli eventi MouseDown, MouseMove, MouseUp e MouseWheel restituiscono le coordinate X e Y espresse in pixel e non in unità HIMETRIC associate allo spazio di input penna. Ciò è dovuto al fatto che questi eventi sostituiscono gli eventi del mouse di applicazioni che non sono in grado di rilevare la penna e che tali applicazioni riconoscono solo i pixel.

Avviso

Se si imposta la proprietà AttachMode dell'oggetto InkOverlay su InFront, creare l'oggetto InkOverlay nel thread nel quale il form è in esecuzione. L'applicazione potrebbe non rispondere se l'oggetto InkOverlay viene creato in un thread diverso e la proprietà AttachMode viene impostata su InFront.

Nota

L'oggetto InkOverlay non può essere rilasciato in modo sicuro su un thread di un'interfaccia non utente.

Per migliorare le prestazioni dell'applicazione, eliminare manualmente un oggetto InkOverlay quando non è più necessario.

Nota sulla sicurezza:
Se utilizzati in attendibilità parziale, questa classe e tutti i relativi metodi richiedono l'autorizzazione UIPermissionWindow.SafeTopLevelWindows. Per ulteriori informazioni, vedere Security And Trust.

Gerarchia di ereditarietà

System.Object
Microsoft.Ink.InkOverlay

Codice thread safe

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

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.