InkOverlay.AttachedControl プロパティ

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

InkOverlay オブジェクトが結合されるコントロールを取得または設定します。

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

構文

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

value = instance.AttachedControl

instance.AttachedControl = value

[BrowsableAttribute(false)]
public Control AttachedControl { get; set; }

[BrowsableAttribute(false)]
public:
property Control^ AttachedControl {
    Control^ get ();
    void set (Control^ value);
}

/** @property */
/** @attribute BrowsableAttribute(false) */
public Control get_AttachedControl()
/** @property */
/** @attribute BrowsableAttribute(false) */
public  void set_AttachedControl(Control value)

public function get AttachedControl () : Control
public function set AttachedControl (value : Control)

プロパティ値

型 : System.Windows.Forms.Control
InkOverlay オブジェクトが結合されているコントロール。

値	説明
nullnull 参照 (Visual Basic では Nothing)	InkOverlay オブジェクトはコントロールに結合されていません。
System.Windows.Forms.Control	InkOverlay オブジェクトが結合されているコントロール。

解説

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

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

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

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

例

この例では、AttachedControl プロパティを使用して、InkOverlay オブジェクトによって使用されるコントロールを無効にします。

' Note: mInkOverlay was instantiated via: new InkOverlay(control)
' not via: new InkOverlay(control.Handle) - this .ctor does not set AttachedControl
mInkOverlay.AttachedControl.Invalidate()

// Note: mInkOverlay was instantiated via: new InkOverlay(control)
// not via: new InkOverlay(control.Handle) - this .ctor does not set AttachedControl
mInkOverlay.AttachedControl.Invalidate();