Proprietà InkOverlay.AttachedControl

Articolo
10/29/2008

Aggiornamento: novembre 2007

Ottiene o imposta il controllo a cui è associato l'oggetto InkOverlay.

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

Sintassi

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

value = instance.AttachedControl

instance.AttachedControl = value

[BrowsableAttribute(false)]
public Control AttachedControl { get; set; }

[BrowsableAttribute(false)]
public:
property Control^ AttachedControl {
    Control^ get ();
    void set (Control^ value);
}

/** @property */
/** @attribute BrowsableAttribute(false) */
public Control get_AttachedControl()
/** @property */
/** @attribute BrowsableAttribute(false) */
public  void set_AttachedControl(Control value)

public function get AttachedControl () : Control
public function set AttachedControl (value : Control)

Valore proprietà

Tipo: System.Windows.Forms.Control
Controllo a cui è associato l'oggetto InkOverlay.

Valore	Significato
nullriferimento null (Nothing in Visual Basic)	L'oggetto InkOverlay non è associato a un controllo.
System.Windows.Forms.Control	Controllo 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 handle della finestra, mediante l'impostazione di questa proprietà l'oggetto InkOverlay viene associato a un controllo e la proprietà Handle 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.

Esempi

In questo esempio, la proprietà AttachedControl viene utilizzata per invalidare il controllo utilizzato dall'oggetto InkOverlay.

' Note: mInkOverlay was instantiated via: new InkOverlay(control)
' not via: new InkOverlay(control.Handle) - this .ctor does not set AttachedControl
mInkOverlay.AttachedControl.Invalidate()

// Note: mInkOverlay was instantiated via: new InkOverlay(control)
// not via: new InkOverlay(control.Handle) - this .ctor does not set AttachedControl
mInkOverlay.AttachedControl.Invalidate();

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.