Condividi tramite


Classe InkPicture

Aggiornamento: novembre 2007

Il controllo InkPicture consente di posizionare un'immagine in un'applicazione, a cui gli utenti possono inoltre sovrapporre l'input penna. È previsto per scenari nei quali l'input penna non è riconosciuto come testo, ma è archiviato invece come input penna.

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

Sintassi

'Dichiarazione
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
<UIPermissionAttribute(SecurityAction.Demand, Window := UIPermissionWindow.SafeTopLevelWindows)> _
Public Class InkPicture _
    Inherits PictureBox
'Utilizzo
Dim instance As InkPicture
[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
[UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows)]
public class InkPicture : PictureBox
[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = L"FullTrust")]
[UIPermissionAttribute(SecurityAction::Demand, Window = UIPermissionWindow::SafeTopLevelWindows)]
public ref class InkPicture : public PictureBox
/** @attribute PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust") */
/** @attribute UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows) */
public class InkPicture extends PictureBox
public class InkPicture extends PictureBox

Note

Avviso

È necessario chiamare il metodo Dispose su questo oggetto prima che esca dall'ambito. Questo oggetto gestisce risorse non gestite. Utilizzando la finalizzazione per questo oggetto si possono verificare perdite di memoria ed eccezioni all'interno dell'applicazione.

Per un esempio di eliminazione di oggetti gestiti, vedere Using the Managed Library.

L'interfaccia utente in fase di esecuzione di questo controllo è una finestra con sfondo opaco (colore singolo, immagine di sfondo o entrambi) contenente input penna opaco.

È possibile utilizzare il controllo InkPicture per eseguire il rendering dell'input penna in Microsoft Windows 2000, Windows Server 2003, qualsiasi edizione di Windows XP e qualsiasi versione di Windows Vista. Tuttavia, è possibile immettere input penna, accettare movimenti o riconoscere la grafia solo se si verificano le seguenti condizioni:

  • L'input penna può essere immesso e riconosciuto solo se è installata la Tecnologia Windows per Tablet PC.

  • I movimenti possono essere riconosciuti solo se è installato il Riconoscimento movimenti Microsoft.

  • La grafia può essere riconosciuta come testo se ha avuto origine altrove e se sono presenti i sistemi di riconoscimento.

In caso di utilizzo di Windows 2000, di Windows Server 2003 o di qualsiasi altra edizione di Windows XP diversa da Tablet PC Edition, è possibile assegnare valori alle proprietà di ambiente del controllo InkPicture, nonché copiare e incollare l'input penna in altre applicazioni, ma il valore della proprietà InkEnabled risulta sempre false.

Gli oggetti Ink salvati in modo permanente possono essere caricati e visualizzati in tutte le versioni di Windows XP (inclusa Tablet PC Edition). Tuttavia, gli oggetti Ink possono essere convertiti in testo (riconosciuto) solo se è installato Windows XP Tablet PC Edition.

Per ulteriori informazioni sui controlli dell'input penna, vedere Ink Controls.

Per informazioni sui thread che generano eventi particolari, vedere Threads on Which an Event Can Fire.

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

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

Gerarchia di ereditarietà

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Windows.Forms.Control
        System.Windows.Forms.PictureBox
          Microsoft.Ink.InkPicture

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.

Informazioni sulla versione

.NET Framework

Supportato in: 3.0

Vedere anche

Riferimenti

Membri InkPicture

Spazio dei nomi Microsoft.Ink

InkOverlay

Altre risorse

Ink Controls

Threads on Which an Event Can Fire