InkCollector.Handle プロパティ

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

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

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

構文

'宣言
Public Property Handle As IntPtr
'使用
Dim instance As InkCollector
Dim value As IntPtr

value = instance.Handle

instance.Handle = value

public IntPtr Handle { get; set; }

public:
property IntPtr Handle {
    IntPtr get ();
    void set (IntPtr value);
}

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

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

プロパティ値

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

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

解説

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

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

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

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

セキュリティに関するメモ :
部分信頼で使用している場合、このプロパティには InkCollector により必要とされるアクセス許可に加えて、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;
}