InkPicture.InkEnabled 屬性

發行項
10/29/2008

取得或設定值，這個值指定 InkPicture 控制項是否會收集畫筆輸入。

命名空間： Microsoft.Ink
組件： Microsoft.Ink (在 Microsoft.Ink.dll 中)

語法

'宣告
<BrowsableAttribute(True)> _
Public Property InkEnabled As Boolean
'用途
Dim instance As InkPicture
Dim value As Boolean

value = instance.InkEnabled

instance.InkEnabled = value

[BrowsableAttribute(true)]
public bool InkEnabled { get; set; }

[BrowsableAttribute(true)]
public:
property bool InkEnabled {
    bool get ();
    void set (bool value);
}

/** @property */
/** @attribute BrowsableAttribute(true) */
public boolean get_InkEnabled()
/** @property */
/** @attribute BrowsableAttribute(true) */
public  void set_InkEnabled(boolean value)

public function get InkEnabled () : boolean
public function set InkEnabled (value : boolean)

屬性值

型別：System.Boolean
如果 InkPicture 控制項會收集畫筆輸入，則為 true。預設值。
如果 InkPicture 控制項不會報告畫筆輸入，則為 false。不會引發畫筆相關的事件。

備註

除了筆墨之外，畫筆輸入還可以包含感應輸入封包、範圍內的游標事件等等。

InkPicture 控制項可以在 Microsoft® Windows® XP Tablet PC Edition 或是任何已安裝 Windows XP Tablet PC Edition SDK 的 Windows 2000、Windows Server 2003 或 Windows XP 版本中收集筆墨。只有使用 Windows XP Tablet PC Edition 才有手寫辨識功能。任何版本的 Windows 2000、Windows Server 2003 或 Windows XP (Windows XP Tablet PC Edition 除外) 如果未安裝 Windows XP Tablet PC Edition SDK，InkEnabled 屬性一定會是 false。

如果已啟用的 InkCollector 或 InkOverlay (透過建構函式或 SetWindowInputRectangle 方法設定) 的視窗輸入矩形與 InkPicture 的視窗輸入矩形重疊，則會擲回 COMException 例外狀況。

注意事項：
只要在任何時候只啟用其中一個輸入矩形，就可能發生重疊而沒有錯誤。

如果控制項未啟用，您就不會收到任何事件。

當您將容器控制項的 Enabled 屬性設為 false 時，其中包含的所有控制項也都會停用。

當控制項正在收集筆墨 (CollectingInk 屬性為 true) 時，無法將 InkEnabled 屬性設定為 false。

在設定或呼叫控制項的特定屬性和方法之前，必須先將 InkEnabled 屬性設定為 false。如果您嘗試變更指定的屬性或呼叫指定的方法，則會發生錯誤。

除非先將 InkEnabled 屬性設定為 false，否則無法設定或呼叫下列屬性或方法：

屬性：
- Ink
- MarginX
- MarginY
方法：
- SetAllTabletsMode
- SetSingleTabletIntegratedMode

您應該將 InkPicture 控制項的 InkEnabled 屬性設定為 false，然後才關閉應用程式。

範例

下列範例會為 ButtonClick 事件定義事件處理常式。當這個事件被引發時，處理常式會切換 InkEnabled 屬性的值，然後更新 Button 的文字，以反映下一個點選所要執行的動作。

' Event handler for the button's Click event.
Private Sub buttonToggle_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles buttonToggle.Click
    ' toggle the InkEnabled property and update button text
    mInkPicture.InkEnabled = Not mInkPicture.InkEnabled
    If mInkPicture.InkEnabled Then
        DirectCast(sender, Button).Text = "Disable Ink"
    Else
        DirectCast(sender, Button).Text = "Enable Ink"
    End If

End Sub

// Event handler for the button's Click event.
private void buttonToggle_Click(object sender, System.EventArgs e)
{
    // toggle the InkEnabled property and update button text
    mInkPicture.InkEnabled = !mInkPicture.InkEnabled;
    ((Button)sender).Text = (mInkPicture.InkEnabled) ? "Disable Ink" : "Enable Ink";
}