Proprietà InkCollector.Handle

Articolo
10/29/2008

Aggiornamento: novembre 2007

Ottiene o imposta l'handle della finestra a cui è associato l'oggetto InkCollector.

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

Sintassi

'Dichiarazione
Public Property Handle As IntPtr
'Utilizzo
Dim instance As InkCollector
Dim value As IntPtr

value = instance.Handle

instance.Handle = value

public IntPtr Handle { get; set; }

public:
property IntPtr Handle {
    IntPtr get ();
    void set (IntPtr value);
}

/** @property */
public IntPtr get_Handle()
/** @property */
public  void set_Handle(IntPtr value)

public function get Handle () : IntPtr
public function set Handle (value : IntPtr)

Valore proprietà

Tipo: System.IntPtr
Handle della finestra a cui è associato l'oggetto InkCollector.

Valore	Significato
nullriferimento null (Nothing in Visual Basic)	L'oggetto InkCollector non è associato a una finestra (se la proprietà AttachedControl è anche nullriferimento null (Nothing in Visual Basic)).
System.Windows.Forms.Control.Handle	Handle della finestra a cui è associato l'oggetto InkCollector.

Note

La proprietà AttachedControl o Handle deve essere impostata prima di poter attivare l'oggetto InkCollector.

Se l'oggetto InkCollector è associato a un controllo, mediante l'impostazione di questa proprietà l'oggetto InkCollector viene associato a una finestra e la proprietà AttachedControl viene cancellata.

Nota

È necessario disattivare l'oggetto InkCollector prima di impostare questa proprietà. Per disattivare l'oggetto InkCollector, impostare la proprietà Enabled su false. È possibile quindi impostare questa proprietà e riattivare l'oggetto impostando la proprietà Enabled su true.

Se si utilizzano la proprietà AttachedControl e la proprietà Handle nell'applicazione, si otterrà un'eccezione di sicurezza quando si esegue l'applicazione nell'area Internet. Ciò è dovuto al fatto che la proprietà Handle non è valida nell'ambiente parzialmente attendibile dell'area Internet; pertanto sul sistema operativo del Tablet PC viene ripristinata la proprietà AttachedControl.

Nota sulla sicurezza:
Se utilizzata in attendibilità parziale, questa proprietà richiede l'autorizzazione SecurityPermissionFlag.UnmanagedCode, oltre alle autorizzazioni richieste da InkCollector. Per ulteriori informazioni, vedere Security And Trust.

Esempi

Nell'esempio seguente viene illustrato un metodo che può essere utilizzato per imporre a un oggetto InkCollector o a un oggetto InkOverlay di raccogliere l'input penna su un nuovo controllo.

Private Sub SwitchInkObjectHandle(ByVal collectingControl As Control)
    ' mInkObject can be InkCollector or InkOverlay
    mInkObject.Enabled = False
    ' setting the Handle property sets the AttachedControl property to null
    mInkObject.Handle = collectingControl.Handle
    mInkObject.Enabled = True
End Sub

private void SwitchInkObjectHandle(Control collectingControl)
{
    // mInkObject can be InkCollector or InkOverlay
    mInkObject.Enabled = false;
    // setting the Handle property sets the AttachedControl property to null
    mInkObject.Handle = collectingControl.Handle;
    mInkObject.Enabled = true;
}

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.