InkOverlay.Handle, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient ou définit le handle de fenêtre à laquelle l'objet InkOverlay est attaché.

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

Syntaxe

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

Valeur de propriété

Type : System.IntPtr
Handle de la fenêtre à laquelle l'objet InkOverlay est attaché.

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

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.

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 InkOverlay. 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.