Proprietà InkOverlay.AttachMode

Articolo
10/29/2008

Aggiornamento: novembre 2007

Ottiene o imposta il valore che specifica se l'oggetto InkOverlay viene associato dietro o davanti alla finestra nota.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
<BrowsableAttribute(True)> _
Public Property AttachMode As InkOverlayAttachMode
'Utilizzo
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)

Valore proprietà

Tipo: Microsoft.Ink.InkOverlayAttachMode
Valore che specifica se l'oggetto InkOverlay viene associato dietro o davanti alla finestra nota.

Valore	Significato
Behind	Predefinito. L'oggetto InkOverlay viene associato dietro alla finestra nota. L'input penna viene disegnato sotto i controlli figlio.
InFront	L'oggetto InkOverlay viene associato davanti alla finestra nota. L'input penna viene disegnato sopra i controlli figlio.

Note

Nota

Se l'oggetto InkOverlay non viene disattivato prima di impostare questa proprietà, si verifica un errore. Per disattivare l'oggetto InkOverlay, impostare la proprietà Enabled su false. È possibile quindi impostare la proprietà InkOverlayAttachMode e riattivare l'oggetto impostando la proprietà Enabled su true.

Per ridisegnare un tratto nell'oggetto InkOverlay quando è associato davanti alla finestra nota, chiamare l'overload Invalidate(rect, true) del form che impone un nuovo disegno dei controlli figlio.

Avviso

Se l'oggetto AttachMode è impostato su InFront e successivamente viene aggiunto un controllo all'oggetto AttachedControl dell'oggetto InkOverlay, sarà necessario associare nuovamente il controllo. Impostare innanzitutto l'oggetto Enabled su false, quindi impostare la proprietà AttachedControl e infine impostare l'oggetto Enabled su true.

Esempi

In questo esempio di C# viene creato un oggetto InkOverlay, theInkOverlay che viene associato a un oggetto Panel, thePanel, in un Windows Form. Quindi, la proprietà AttachMode viene utilizzata per attivare e disattivare l'immissione dell'input penna sopra a un controllo Label, theLabel che si trova nel pannello.

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

}

In questo esempio di Microsoft Visual Basic .NET viene creato un oggetto InkOverlay, theInkOverlay che viene associato a un oggetto Panel, thePanel, in un Windows Form. Quindi, la proprietà AttachMode viene utilizzata per attivare e disattivare l'immissione dell'input penna sopra a un controllo Label, theLabel che si trova nel pannello.

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

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Informazioni sulla versione

.NET Framework

Supportato in: 3.0

Vedere anche

Riferimenti

InkOverlay Classe

Membri InkOverlay

Spazio dei nomi Microsoft.Ink

Condividi tramite