InkOverlay.AttachMode プロパティ

InkOverlay オブジェクトを既知のウィンドウの後ろまたは前のどちらに結合するかを指定する値を取得または設定します。

名前空間 :  Microsoft.Ink
アセンブリ :  Microsoft.Ink (Microsoft.Ink.dll 内)

構文

'宣言
<BrowsableAttribute(True)> _
Public Property AttachMode As InkOverlayAttachMode
'使用
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)

プロパティ値

型 : Microsoft.Ink.InkOverlayAttachMode
InkOverlay オブジェクトを既知のウィンドウの後ろまたは前のどちらに結合するかを指定する値。

解説

メモ :
このプロパティを設定する前に InkOverlay オブジェクトが無効でない場合は、エラーが発生します。InkOverlay オブジェクトを無効にするには、Enabled プロパティを false に設定します。次に InkOverlayAttachMode プロパティを設定し、Enabled プロパティを true に設定することによりこのオブジェクトを再び有効にします。

InkOverlay オブジェクトが既知のウィンドウの前に結合されるときに、このオブジェクトでストロークを再描画するには、すべての子コントロールの再描画を強制するフォームの Invalidate(rect, true) オーバーロードを呼び出します。

注意 :
AttachMode が InFront に設定されているため、コントロールが InkOverlay の AttachedControl に追加される場合、コントロールを再結合する必要があります。まず、Enabled を false に設定して、AttachedControl プロパティを設定し、次に Enabled を true に設定します。

例

この C# の例では、InkOverlay オブジェクト theInkOverlay を作成し、それをウィンドウ フォーム上の Panel、thePanel に結合します。次に、AttachMode プロパティを使用して、パネル上の Label コントロール theLabel の上部でインク処理を有効および無効にします。

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

}
      

この Microsoft Visual Basic .NET の例では、InkOverlay オブジェクト theInkOverlay を作成し、それをウィンドウ フォーム上の Panel、thePanel に結合します。次に、AttachMode プロパティを使用して、パネル上の Label コントロール theLabel の上部でインク処理を有効および無効にします。

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

      

プラットフォーム

Windows Vista

.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。

バージョン情報

.NET Framework

サポート対象 : 3.0

参照

参照

InkOverlay クラス

InkOverlay メンバ

Microsoft.Ink 名前空間