IInkDrawingAttributes::p ut_Color-Methode (msinkaut.h)
Ruft die Farbe der Freihandeingabe ab, die mit diesem InkDrawingAttributes-Objekt gezeichnet wird, oder legt diese fest.
Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.
Syntax
HRESULT put_Color(
long NewColor
);
Parameter
NewColor
Rückgabewert
Keine
Bemerkungen
Im Modus "Hoher Kontrast" wird freihand immer mit der Systemfarbeinstellung (COLOR_WINDOWTEXT) angezeigt, unabhängig von der Einstellung der Color-Eigenschaft . Die tatsächliche Farbe der Freihandfarbe wird jedoch immer als festgelegte Farbe oder als Standardfarbe (SCHWARZ) gespeichert, wenn sie nicht festgelegt ist. Wenn die Color-Eigenschaft beispielsweise auf ROT festgelegt ist, sieht ein Benutzer im Modus "Hoher Kontrast" die Freihandeingabe in der Systemfarbe, aber ein Benutzer, der sich nicht im Modus "Hoher Kontrast" befindet, sieht die Freihandfarbe als festgelegte Farbe ROT gezeichnet. Mit dieser Funktion kann ein Benutzer im Modus "Hoher Kontrast" die Freihandeingabe in der Systemeinstellung anzeigen, ohne die tatsächliche Strichfarbe zu ändern.
Dies bedeutet, dass alle Freihandeingaben im Modus "Hoher Kontrast" standardmäßig einer Farbe zugeordnet sind. Verwenden Sie die SupportHighContrastInk-Eigenschaft des Freihandsammlers, um dieses Standardmäßige Farbzuordnungsverhalten 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 (was bedeutet, dass freihand neu gezeichnet wird, wenn das Fenster ungültig wird). Wenn Sie die AutoRedraw-Eigenschaft auf FALSE festlegen, unterstützt die Anwendungsprogrammierschnittstelle (APPLICATION Programming Interface, API) des Tablet-PCs den Modus für hohen Kontrast nicht.
Anforderungen
| 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 |