DrawingAttributes.Color 屬性

發行項
10/29/2008

取得或設定使用這個 DrawingAttributes 物件所繪製「筆墨」的色彩。

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

語法

'宣告
Public Property Color As Color
'用途
Dim instance As DrawingAttributes
Dim value As Color

value = instance.Color

instance.Color = value

public Color Color { get; set; }

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

/** @property */
public Color get_Color()
/** @property */
public  void set_Color(Color value)

public function get Color () : Color
public function set Color (value : Color)

屬性值

型別：System.Drawing.Color
使用這個 DrawingAttributes 物件所繪製「筆墨」的色彩。

值	意義
Black	以 Black (英文) 呈現筆墨。
System.Drawing.Color	以選取之 Color (英文) 物件的色彩呈現筆墨。

備註

在 [高對比] 模式中，無論 Color 屬性設定為何，一定會使用系統色彩設定 (WindowText (英文)) 顯示筆墨。不過，實際筆墨色彩一定會儲存為 Color 中設定的色彩 (如果未設定的話，則為預設色彩)。例如，Color 屬性設定為 Red (英文)，[高對比] 模式下的使用者會看到使用系統色彩的筆墨，但非 [高對比] 模式下的使用者則會看到以設定的色彩 (Red (英文)) 繪製的筆墨。這個功能可讓 [高對比] 模式下的使用者以系統設定檢視筆墨，而不需修改實際筆劃色彩。

這表示，在 [高對比] 模式時，所有筆墨預設都會對應至單色。若要停用此預設色彩對應行為，並實作自己的色彩對應行為，請使用「筆墨收集器」的 SupportHighContrastInk 屬性 (InkCollector.SupportHighContrastInk、InkOverlay.SupportHighContrastInk 或 InkPicture.SupportHighContrastInk)。

若要有效啟用 [高對比] 模式，您必須將筆墨收集器的 AutoRedraw 屬性 (InkCollector.AutoRedraw、InkOverlay.AutoRedraw 或 InkPicture.AutoRedraw) 設定為 true。如果您將 AutoRedraw 屬性設定為 true，則會在視窗失效時重繪筆墨。將 AutoRedraw 屬性設定為 false 時，Tablet PC 應用程式發展介面 (API) 便不支援 [高對比] 模式。

範例

這個 C# 範例包含功能表處理常式，可變更 DrawingAttributes 物件的 Color 屬性。

using Microsoft.Ink;
using System.Drawing;
//...
    private System.Windows.Forms.MenuItem menuInkColorRed;
    private System.Windows.Forms.MenuItem menuInkColorBlue;
    private InkCollector theInkCollector;
    private System.Windows.Forms.MenuItem checkedColor;

//...
    private void menuInkColorRed_Click(
    object sender, System.EventArgs e)
    {
        checkedColor.Checked = false;
        theInkCollector.DefaultDrawingAttributes.Color = Color.Red;
        checkedColor = menuInkColorRed;
        checkedColor.Checked = true;
        Refresh();
    }

    private void menuInkColorBlue_Click(
    object sender, System.EventArgs e)
    {
        checkedColor.Checked = false;
        theInkCollector.DefaultDrawingAttributes.Color = Color.Blue;
        checkedColor = menuInkColorBlue;
        checkedColor.Checked = true;
        Refresh();
    }

這個 Microsoft® Visual Basic® .NET 範例包含功能表處理常式，可變更 DrawingAttributes 物件的 Color 屬性。

Imports Microsoft.Ink
Imports System.Drawing
'...
    Dim MenuInkColorRed As System.Windows.Forms.MenuItem
    Dim MenuInkColorBlue As System.Windows.Forms.MenuItem
    Dim CheckedColor As System.Windows.Forms.MenuItem
    Dim theInkCollector As InkCollector
'...
    Private Sub MenuInkColorRed_Click( _
    ByVal sender As Object, ByVal e As System.EventArgs)
        CheckedColor.Checked = False
        theInkCollector.DefaultDrawingAttributes.Color = Color.Red
        CheckedColor = MenuInkColorRed
        CheckedColor.Checked = True
        Refresh()
    End Sub

    Private Sub MenuInkColorBlue_Click( _
    ByVal sender As Object, ByVal e As System.EventArgs)
        CheckedColor.Checked = False
        theInkCollector.DefaultDrawingAttributes.Color = Color.Blue
        CheckedColor = MenuInkColorBlue
        CheckedColor.Checked = True
        Refresh()
    End Sub