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 オブジェクトの色でレンダリングされます。

解説

ハイコントラストモードでは、Color プロパティの設定に関係なく、インクは常にシステムカラー設定 (WindowText) で表示されます。ただし、インクの実際の色は、常に Color プロパティに設定された色として保存されます (設定されていない場合は既定の色)。たとえば、Color プロパティが設定されている (Red) 場合、ハイコントラストモードのユーザーはシステムカラーのインクを参照し、ハイコントラストモード以外のユーザーは設定された色の Red が描画されるインクを参照します。この機能を使用すると、ハイコントラストモードのユーザーは、実際のストロークの色を変更せずにシステム設定のインクを表示できます。

これは、ハイコントラストモードのときは、すべてのインクが既定で 1 つの色に割り当てられていることを示します。この既定の色へのマップ動作を無効にして独自の色を実装するには、インクコレクタの 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