InkOverlay.AttachMode (Propiedad)

Actualización: noviembre 2007

Obtiene o establece el valor que especifica si el objeto InkOverlay se asocia delante o detrás de la ventana conocida.

Espacio de nombres:  Microsoft.Ink
Ensamblado:  Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
<BrowsableAttribute(True)> _
Public Property AttachMode As InkOverlayAttachMode
'Uso
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)

Valor de propiedad

Tipo: Microsoft.Ink.InkOverlayAttachMode
Valor que especifica si el objeto InkOverlay se asocia delante o detrás de la ventana conocida.

Valor	Significado
Behind	Valor predeterminado. El objeto InkOverlay asocia detrás de la ventana conocida. La entrada manuscrita se dibuja debajo de los controles secundarios.
InFront	El objeto InkOverlay asocia delante de la ventana conocida. La entrada manuscrita se dibuja encima de los controles secundarios.

Comentarios

Nota

Se produce un error si no se deshabilita el objeto InkOverlay antes de establecer esta propiedad. Para deshabilitar el objeto InkOverlay, establezca la propiedad Enabled en false. A continuación, puede establecer la propiedad InkOverlayAttachMode y volver a habilitar el objeto estableciendo la propiedad Enabled en true.

Para volver a dibujar un trazo en el objeto InkOverlay cuando se asocia delante de la ventana conocida, llame a la sobrecarga del formulario Invalidate(rect, true), que hace que se vuelvan a dibujar todos los controles secundarios.

Advertencia

Si la propiedad AttachMode se establece en InFront y, a continuación, se agrega un control a la propiedad AttachedControl del objeto InkOverlay, tendrá que volver a asociar el control. En primer lugar, establezca la propiedad Enabled en false y las propiedades AttachedControl y Enabled en true.

Ejemplos

En este ejemplo de C# se crea un objeto InkOverlay, theInkOverlay, y se agrega a un Panel, thePanel, en un formulario de ventana. A continuación, la propiedad AttachMode se utiliza para habilitar y deshabilitar la escritura a mano encima de un control LabeltheLabel, que está en el panel.

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

}
      

En este ejemplo de Microsoft Visual Basic .NET se crea un objeto InkOverlay, theInkOverlay y se agrega a un Panel, thePanel, en un formulario de ventana. A continuación, la propiedad AttachMode se utiliza para habilitar y deshabilitar la escritura a mano encima de un control Label, theLabel que está en el panel.

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

      

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Información de versión

.NET Framework

Compatible con: 3.0

Vea también

Referencia

InkOverlay (Clase)

InkOverlay (Miembros)

Microsoft.Ink (Espacio de nombres)