InkOverlay.AttachedControl, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient ou définit le contrôle auquel l'objet InkOverlay est attaché.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
<BrowsableAttribute(False)> _
Public Property AttachedControl As Control
'Utilisation
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)

Valeur de propriété

Type : System.Windows.Forms.Control
Contrôle auquel l'objet InkOverlay est attaché.

Valeur	Signification
nullune référence null (Nothing en Visual Basic)	L'objet InkOverlay n'est attaché à aucun contrôle.
System.Windows.Forms.Control	Contrôle auquel l'objet InkOverlay est attaché.

Notes

Vous devez définir la propriété AttachedControl ou Handle avant d'activer l'objet InkOverlay.

Si l'objet InkOverlay est attaché à un handle de fenêtre, la définition de cette propriété attache l'objet InkOverlay à un contrôle et efface la propriété Handle.

Remarque :
Vous devez désactiver l'objet InkOverlay avant de définir cette propriété. Pour désactiver le InkOverlay, affectez la valeur false à la propriété Enabled. Vous pouvez définir cette propriété et réactiver l'objet en affectant la valeur true à la propriété Enabled.

Si vous utilisez les propriétés AttachedControl et Handle dans votre application, une exception de sécurité est levée lorsque vous lancez l'application dans la zone Internet. En effet, la propriété Handle n'étant pas valide dans l'environnement de confiance partielle de la zone Internet, le système d'exploitation du Tablet PC rétablit la propriété AttachedControl.

Exemples

Dans cet exemple, la propriété AttachedControl est utilisée pour invalider le contrôle utilisé par l'objet 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();

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.