InkOverlay.AttachMode-Eigenschaft

Artikel
11/26/2008

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das InkOverlay-Objekt hinter oder vor dem bekannten Fenster angefügt ist.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

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

Eigenschaftenwert

Typ: Microsoft.Ink.InkOverlayAttachMode
Der Wert, der angibt, ob das InkOverlay-Objekt hinter oder vor dem bekannten Fenster angefügt ist.

Wert	Bedeutung
Behind	Standardwert. Das InkOverlay-Objekt wird hinter dem bekannten Fenster angefügt. Freihandeingaben werden unterhalb der untergeordneten Steuerelemente gezeichnet.
InFront	Das InkOverlay-Objekt wird vor dem bekannten Fenster angefügt. Freihandeingaben werden oberhalb der untergeordneten Steuerelemente gezeichnet.

Hinweise

Hinweis

Ein Fehler tritt auf, wenn das InkOverlay-Objekt nicht vor dem Festlegen dieser Eigenschaft deaktiviert wird. Um das InkOverlay-Objekt zu deaktivieren, legen Sie die Enabled-Eigenschaft auf false fest. Sie können die InkOverlayAttachMode-Eigenschaft festlegen und das Objekt erneut aktivieren, indem Sie die Enabled-Eigenschaft auf true festlegen.

Um einen Strich im InkOverlay-Objekt neu zu zeichnen, wenn dieses vor dem bekannten Fenster angefügt ist, rufen Sie die überladene Invalidate(rect, true)-Methode des Formulars auf. Dadurch wird das Neuzeichnen aller untergeordneten Steuerelemente erzwungen.

Warnung

Wenn AttachMode auf InFront festgelegt wurde und dann der AttachedControl-Eigenschaft von InkOverlay ein Steuerelement hinzugefügt wird, müssen Sie das Steuerelement erneut anfügen. Legen Sie zuerst Enabled auf false fest. Legen Sie dann die AttachedControl-Eigenschaft fest. Anschließend legen Sie Enabled wieder auf true fest.

Beispiele

In diesem C#-Beispiel wird das InkOverlay-Objekt theInkOverlay erstellt und an das Panel-Steuerelement thePanel in einem Formular angefügt. Dann wird die AttachMode-Eigenschaft verwendet, um Freihandeingaben auf einem Label-Steuerelement namens theLabel im Bereich zu aktivieren oder zu deaktivieren.

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 diesem Microsoft Visual Basic .NET-Beispiel wird das InkOverlay-Objekt theInkOverlay erstellt und an das Panel-Steuerelement thePanel in einem Formular angefügt. Dann wird die AttachMode-Eigenschaft verwendet, um Freihandeingaben auf einem Label-Steuerelement namens theLabel im Bereich zu aktivieren oder zu deaktivieren.

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

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Versionsinformationen

.NET Framework

Unterstützt in: 3.0

Siehe auch

Referenz

InkOverlay-Klasse

InkOverlay-Member

Microsoft.Ink-Namespace

Freigeben über