InkOverlay.Handle プロパティ

[アーティクル]
10/28/2008

InkOverlay オブジェクトが結合されるウィンドウのハンドルを取得または設定します。

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

構文

'宣言
<BrowsableAttribute(False)> _
Public Property Handle As IntPtr
'使用
Dim instance As InkOverlay
Dim value As IntPtr

value = instance.Handle

instance.Handle = value

[BrowsableAttribute(false)]
public IntPtr Handle { get; set; }

[BrowsableAttribute(false)]
public:
property IntPtr Handle {
    IntPtr get ();
    void set (IntPtr value);
}

/** @property */
/** @attribute BrowsableAttribute(false) */
public IntPtr get_Handle()
/** @property */
/** @attribute BrowsableAttribute(false) */
public  void set_Handle(IntPtr value)

public function get Handle () : IntPtr
public function set Handle (value : IntPtr)

プロパティ値

型 : System.IntPtr
InkOverlay オブジェクトが結合されるウィンドウハンドル。

値	説明
nullnull 参照 (Visual Basic では Nothing)	InkOverlay オブジェクトはウィンドウに結合されていません (AttachedControl も nullnull 参照 (Visual Basic では Nothing) である場合)。
System.Windows.Forms	InkOverlay オブジェクトが結合されるウィンドウハンドル。

解説

AttachedControl または Handle プロパティは InkOverlay オブジェクトが有効にされる前に設定されている必要があります。

InkOverlay オブジェクトがコントロールに結合されている場合、このプロパティを設定すると、InkOverlay オブジェクトはウィンドウに結合され、AttachedControl プロパティがクリアされます。

メモ :
このプロパティを設定する前に InkOverlay を無効にする必要があります。InkOverlay を無効にするには Enabled プロパティを false に設定します。次にこのプロパティを設定し、Enabled プロパティを true に設定することによりこのオブジェクトを再び有効にします。

アプリケーションで AttachedControl プロパティと Handle プロパティを使用する場合、インターネットゾーンでアプリケーションを実行するとセキュリティ例外になります。これは Handle プロパティがインターネットゾーンの部分信頼環境で有効にされていないので、Tablet PC のオペレーティングシステムが AttachedControl プロパティに戻るからです。

セキュリティに関するメモ :
部分信頼で使用している場合、このプロパティには InkOverlay により必要とされるアクセス許可に加えて、SecurityPermissionFlag.UnmanagedCode アクセス許可が必要です。詳細については、「Security and Trust」を参照してください。

例

次の例では、InkCollector オブジェクトまたは InkOverlay オブジェクトに、新しいコントロールでインクを収集するように指示するために使用できるメソッドを示します。

Private Sub SwitchInkObjectHandle(ByVal collectingControl As Control)
    ' mInkObject can be InkCollector or InkOverlay
    mInkObject.Enabled = False
    ' setting the Handle property sets the AttachedControl property to null
    mInkObject.Handle = collectingControl.Handle
    mInkObject.Enabled = True
End Sub

private void SwitchInkObjectHandle(Control collectingControl)
{
    // mInkObject can be InkCollector or InkOverlay
    mInkObject.Enabled = false;
    // setting the Handle property sets the AttachedControl property to null
    mInkObject.Handle = collectingControl.Handle;
    mInkObject.Enabled = true;
}