IInkDrawingAttributes::get_Color-Methode (msinkaut.h)

Ruft die Farbe des Freihands ab, das mit diesem InkDrawingAttributes-Objekt gezeichnet wird, oder legt diese fest.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT get_Color(
  long *CurrentColor
);

Parameter

CurrentColor

Rückgabewert

Keine

Bemerkungen

Im Modus mit hohem Kontrast wird freihand immer mit der Systemfarbeinstellung (COLOR_WINDOWTEXT) angezeigt, unabhängig von der Einstellung der Color-Eigenschaft . Die tatsächliche Farbe der Freihand wird jedoch immer als Setfarbe oder als Standardfarbe (SCHWARZ) gespeichert, falls nicht festgelegt. Wenn die Color-Eigenschaft beispielsweise auf RED festgelegt ist, sieht ein Benutzer im Modus "Hoher Kontrast" die Freihandfarbe in der Systemfarbe, aber ein Benutzer, der sich nicht im Modus "Hoher Kontrast" befindet, sieht die Freihandfarbe als festgelegte Farbe ROT gezeichnet. Diese Funktion ermöglicht es einem Benutzer im Modus "Hoher Kontrast", die Freihandeingabe in der Systemeinstellung anzuzeigen, ohne die tatsächliche Strichfarbe zu ändern.

Dies bedeutet, dass im Modus mit hohem Kontrast standardmäßig alle Freihandfarben einer Farbe zugeordnet sind. Verwenden Sie die SupportHighContrastInk-Eigenschaft des Freihandsammlers, um dieses Standardverhalten bei der Farbzuordnung zu deaktivieren und ihr eigenes zu implementieren.

Um den Modus für hohen Kontrast effektiv zu aktivieren, müssen Sie die AutoRedraw-Eigenschaft des Freihandsammlers auf TRUE festlegen (dies bedeutet, dass Freihandeingabe neu gezeichnet wird, wenn das Fenster ungültig ist). Die Tablet PC-Anwendungsprogrammierschnittstelle (API) unterstützt den Modus für hohen Kontrast nicht, wenn Sie die AutoRedraw-Eigenschaft auf FALSE festlegen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	msinkaut.h
Bibliothek	InkObj.dll

Weitere Informationen

AutoRedraw-Eigenschaft

Draw-Methode [InkRenderer-Klasse]

IInkDrawingAttributes

InkDrawingAttribute-Klasse

SupportHighContrastInk-Eigenschaft