THEMECBV Function

Gibt einen RGB-Wert oder eine ganze Zahl zurück, die einen Index in der Farbpalette des Dokuments darstellt, wobei die als Argument übergebene Farbe (Zahl) durch den angegebenen Farbton- oder Schattierungswert geändert wurde, der in den Farbverlaufseinstellungen des aktiven Designs gespeichert ist.

Informationen zur Version

Hinzugefügte Version: Visio 2013

Syntax

THEMECBV( Color, gradient_stop_number)

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
color	Erforderlich	Number	Eine Zahl, die einen Index in der Farbpalette des Dokuments darstellt.
gradient_stop_number	Erforderlich	Number	Der Farbverlaufsstopp (Farbton oder Schattierung), der in den Farbverlaufseinstellungen des aktiven Designs gespeichert ist, das auf die Farbe angewendet werden soll.

Rückgabewert

Number

Hinweise

Hinweis

Die THEMECBV-Funktion führt keine Aktion für die als Argument übergebene Farbe aus, wenn der QuickStyle, der der Form zugewiesen ist, keinen Farbverlauf aufweist.

Die Farbverlaufseinstellungen in einem Design sind eine Reihe von nummerierten Farbverlaufsstopps, die einer "Aufhellung" (Farbton) oder "Abdunkung" (Schattierung) entsprechen. Diese Schattierungen und Tönungen werden auf eine Basisfarbe angewendet, um einen Farbverlaufseffekt zu erstellen.

Die THEMECBV-Funktion nimmt eine Farbeingabe an und gibt die Farbe aus, nachdem sie durch den Farbton oder Schattierung des angegebenen Farbverlaufsstopps geändert wurde. Die Farb- und Schattierungen stammen aus der Definition des Designs, wenn die aktuelle Schnellformatvorlage eine Farbverlaufsfüllung enthält. Wenn die aktive Schnellformatvorlage keine Farbverlaufsfüllung angibt oder die Form auf Kein Design festgelegt ist, gibt diese Formel einfach die Farbe zurück, die für das erste Argument übergeben wurde.

Beispiel

THEMECBV(FillForegnd, 5)

Gibt die Farbe zurück, die durch Anwenden des Farbtons oder Schattierungs im fünften Farbverlaufsstopp des Farbverlaufs auf die in der FillForegnd-Zelle angegebene Farbe erstellt wurde.

THEMECBV(RGB(255,0,0), 2)

Gibt einen Farbton oder einen Farbton von Rot zurück, der durch Anwenden des zweiten Farbverlaufsstopps auf eine Basisfarbe rot erzeugt wird.