Proprietà InkOverlay.Handle

Articolo
10/29/2008

Aggiornamento: novembre 2007

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

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

Sintassi

'Dichiarazione
<BrowsableAttribute(False)> _
Public Property Handle As IntPtr
'Utilizzo
Dim instance As InkOverlay
Dim value As IntPtr

value = instance.Handle

instance.Handle = value

[BrowsableAttribute(false)]
public IntPtr Handle { get; set; }

[BrowsableAttribute(false)]
public:
property IntPtr Handle {
    IntPtr get ();
    void set (IntPtr value);
}

/** @property */
/** @attribute BrowsableAttribute(false) */
public IntPtr get_Handle()
/** @property */
/** @attribute BrowsableAttribute(false) */
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 InkOverlay.

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

Note

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

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

Nota

È necessario disattivare l'oggetto InkOverlay prima di impostare questa proprietà. Per disattivare l'oggetto InkOverlay, 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 dall'oggetto InkOverlay. 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.