InkOverlay.AttachMode, propriété

Mise à jour : November 2007

Obtient ou définit la valeur qui spécifie si l'objet InkOverlay est attaché derrière ou devant la fenêtre connue.

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

Syntaxe

'Déclaration
<BrowsableAttribute(True)> _
Public Property AttachMode As InkOverlayAttachMode
'Utilisation
Dim instance As InkOverlay
Dim value As InkOverlayAttachMode

value = instance.AttachMode

instance.AttachMode = value

[BrowsableAttribute(true)]
public InkOverlayAttachMode AttachMode { get; set; }

[BrowsableAttribute(true)]
public:
property InkOverlayAttachMode AttachMode {
    InkOverlayAttachMode get ();
    void set (InkOverlayAttachMode value);
}

/** @property */
/** @attribute BrowsableAttribute(true) */
public InkOverlayAttachMode get_AttachMode()
/** @property */
/** @attribute BrowsableAttribute(true) */
public  void set_AttachMode(InkOverlayAttachMode value)

public function get AttachMode () : InkOverlayAttachMode
public function set AttachMode (value : InkOverlayAttachMode)

Valeur de propriété

Type : Microsoft.Ink.InkOverlayAttachMode
Valeur qui spécifie si l'objet InkOverlay est attaché derrière ou devant la fenêtre connue.

Notes

Remarque :
Une erreur se produit si l'objet InkOverlay n'est pas désactivé avant de définir cette propriété. Pour désactiver l'objet InkOverlay, affectez la valeur false à la propriété Enabled. Vous pouvez ensuite définir la propriété InkOverlayAttachMode et de nouveau activer l'objet en affectant la valeur true à la propriété Enabled.

Pour repeindre un trait dans l'objet InkOverlay lorsqu'il est attaché devant la fenêtre connue, appelez la surcharge Invalidate(rect, true) (page pouvant être en anglais) du formulaire afin de forcer tous les contrôles enfants à se repeindre.

Attention :
Si AttachMode a la valeur InFront et qu'un contrôle est ajouté au AttachedControl du InkOverlay, vous devrez attacher de nouveau le contrôle. Commencez par affecter la valeur false à la propriété Enabled, puis définissez la propriété AttachedControl. Enfin, affectez la valeur true à la propriété Enabled.

Exemples

Cet exemple C# crée un objet InkOverlay, theInkOverlay et l'attache à un Panel (page pouvant être en anglais), thePanel, sur un Windows Form. La propriété AttachMode est ensuite utilisée pour activer et désactiver l'entrée manuscrite sur un contrôle LabeltheLabel situé sur ce panneau.

using System;
using System.Windows.Forms;
using Microsoft.Ink;


public class Form1 : System.Windows.Forms.Form
{
private System.Windows.Forms.Panel thePanel;
  private System.Windows.Forms.CheckBox theCheckBox;
  private System.Windows.Forms.Label theLabel;  
  private Microsoft.Ink.InkOverlay theInkOverlay;

  // Windows Form Designer generated code
  // . . .

  public Form1()
  {
    theInkOverlay = new Microsoft.Ink.InkOverlay();
    theInkOverlay.Handle = thePanel.Handle;
    theInkOverlay.Enabled = true;  
  }

  // Toggle AttachMode between InFront and Behind.
  private void theCheckBox_CheckedChanged(object sender, System.EventArgs e)
  {
    theInkOverlay.Enabled = false;
    if (theInkOverlay.AttachMode == InkOverlayAttachMode.InFront)
    {
      theInkOverlay.AttachMode = InkOverlayAttachMode.Behind;
    }
    else
    {
      theInkOverlay.AttachMode = InkOverlayAttachMode.InFront;
    }
    theInkOverlay.Enabled = true;
  }

}
      

Cet exemple Microsoft Visual Basic .NET crée un objet InkOverlay, theInkOverlay et l'attache à un Panel (page pouvant être en anglais), thePanel, sur un Windows Form. La propriété AttachMode est ensuite utilisée pour activer et désactiver l'entrée manuscrite sur un contrôle LabeltheLabel situé sur ce panneau.

Imports Microsoft.Ink
      
Public Class Form1
    Inherits System.Windows.Forms.Form

    'Windows Form Designer generated code 
    '. . .

    Private WithEvents theInkOverlay As Microsoft.Ink.InkOverlay
    Friend WithEvents thePanel As System.Windows.Forms.Panel
    Friend WithEvents theCheckBox As System.Windows.Forms.CheckBox

  Public Sub New()
        MyBase.New()

        theInkOverlay = New Microsoft.Ink.InkOverlay()
        theInkOverlay.Handle = thePanel.Handle
        theInkOverlay.Enabled = True
    End Sub
  
'. . .

    Private Sub theCheckBox_CheckedChanged(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles theCheckBox.CheckedChanged
        theInkOverlay.Enabled = False

        If theInkOverlay.AttachMode = InkOverlayAttachMode.Behind Then
            theInkOverlay.AttachMode = InkOverlayAttachMode.InFront
        Else
            theInkOverlay.AttachMode = InkOverlayAttachMode.Behind
        End If

        theInkOverlay.Enabled = True
    End Sub
End Class

      

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.

Informations de version

.NET Framework

Pris en charge dans : 3.0

Voir aussi

Référence

InkOverlay, classe

Membres InkOverlay

Microsoft.Ink, espace de noms