InkCollector.AttachedControl, propriété

Article
11/05/2008

Mise à jour : November 2007

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

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

Syntaxe

'Déclaration
Public Property AttachedControl As Control
'Utilisation
Dim instance As InkCollector
Dim value As Control

value = instance.AttachedControl

instance.AttachedControl = value

public Control AttachedControl { get; set; }

public:
property Control^ AttachedControl {
    Control^ get ();
    void set (Control^ value);
}

/** @property */
public Control get_AttachedControl()
/** @property */
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 InkCollector est attaché.

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

Notes

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

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

Remarque :
Vous devez désactiver l'objet InkCollector avant de définir cette propriété. Pour désactiver le InkCollector, 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 InkCollector.

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

// Note: mInkCollector was instantiated via: new InkCollector(control)
// not via: new InkCollector(control.Handle) - this .ctor does not set AttachedControl
mInkCollector.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.