DrawingAttributes.Color-Eigenschaft

Artikel
11/26/2008

Ruft die Farbe der Freihandeingabe ab, die mit diesem DrawingAttributes-Objekt gezeichnet wird, oder legt die Farbe fest.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Property Color As Color
'Usage
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)

Eigenschaftenwert

Typ: System.Drawing.Color
Die Farbe der Freihandeingabe, die mit diesem DrawingAttributes-Objekt gezeichnet wird.

Wert	Bedeutung
Schwarz	Freihandeingaben werden in Schwarz gerendert.
System.Drawing.Color	Die Freihandeingaben werden in der Farbe des ausgewählten Color-Objekts gerendert.

Hinweise

Im Modus für hohe Kontraste werden Freihandeingaben stets mit der Farbeinstellung des Systems angezeigt (WindowText), und zwar unabhängig von der Color-Eigenschaft. Jedoch wird die tatsächliche Farbe der Freihandeingabe stets als die in der Color-Eigenschaft festgelegte Farbe gespeichert (oder die Standardfarbe, wenn keine Farbe festgelegt ist). Wenn beispielsweise die Color-Eigenschaft auf Rot festgelegt ist, sieht ein Benutzer die Freihandeingabe im Modus für hohe Kontraste in der Systemfarbe, in einem anderen Modus jedoch in der festgelegten Farbe Rot. Diese Funktionalität ermöglicht es einem Benutzer im Modus für hohe Kontraste, die Freihandeingabe mit der Systemeinstellung anzuzeigen, ohne die eigentliche Strichfarbe zu ändern.

Dies bedeutet, dass alle Freihandeingaben standardmäßig einer Farbe zugeordnet werden, wenn der Modus für hohe Kontraste aktiviert ist. Wenn Sie diese Standardfarbzuordnung deaktivieren und eine eigene Zuordnung implementieren möchten, verwenden Sie die SupportHighContrastInk-Eigenschaft (InkCollector.SupportHighContrastInk, InkOverlay.SupportHighContrastInk oder InkPicture.SupportHighContrastInk) des Freihanderfassungsmoduls.

Damit der Modus für hohe Kontraste wirksam aktiviert wird, müssen Sie die AutoRedraw-Eigenschaft (InkCollector.AutoRedraw, InkOverlay.AutoRedraw oder InkPicture.AutoRedraw) des Freihanderfassungsmoduls auf true festlegen. Wenn Sie die AutoRedraw-Eigenschaft auf true festlegen, werden Freihandeingaben neu gezeichnet, wenn das Fenster ungültig wird. Die Tablet PC-API (Application Programming Interface) unterstützt den Modus für hohe Kontraste nicht, wenn Sie die AutoRedraw-Eigenschaft auf false festlegen.

Beispiele

Dieses C#-Beispiel enthält Menühandler, die die Color-Eigenschaft eines DrawingAttributes-Objekts ändern.

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();
    }

Dieses Microsoft® Visual Basic® .NET-Beispiel enthält Menühandler, die die Color-Eigenschaft eines DrawingAttributes-Objekts ändern.

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

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.