InkCollector.Handle, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient ou définit le handle de fenêtre auquel l'objet InkCollector est attaché.

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

Syntaxe

'Déclaration
Public Property Handle As IntPtr
'Utilisation
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)

Valeur de propriété

Type : System.IntPtr
Handle de fenêtre auquel l'objet InkCollector est attaché.

Valeur	Signification
nullune référence null (Nothing en Visual Basic)	L'objet InkCollector n'est attaché à aucune fenêtre (si AttachedControl a également la valeur nullune référence null (Nothing en Visual Basic)).
System.Windows.Forms.Control.Handle	Handle de fenêtre 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 contrôle, la définition de cette propriété attache l'objet InkCollector à une fenêtre et efface la propriété AttachedControl.

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.

Note de sécurité :
Lors de l'utilisation en situation de confiance partielle, cette propriété requiert l'autorisation SecurityPermissionFlag.UnmanagedCode (page pouvant être en anglais), en plus des autorisations requises par InkCollector. Pour plus d'informations, consultez Security and Trust.

Exemples

L'exemple suivant présente une méthode qui peut être utilisée pour indiquer à un objet InkCollector ou InkOverlay de collecter l'entrée manuscrite sur un nouveau contrôle.

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;
}

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.