DrawingAttributes.Color 属性

项目
10/28/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 对象的颜色进行呈现。

备注

在高对比度模式下，墨迹显示始终采用系统颜色设置 (WindowText)，而与 Color 属性的设置无关。然而，墨迹的实际颜色始终保存为 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(R) Visual Basic(R) .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