ApplicationSettings.StencilBackgroundColorGradient-Eigenschaft (Visio)

Bestimmt den Farbverlauf des Hintergrunds in einem Schablonenfenster in Microsoft Visio für die aktuelle Sitzung. Lese-/Schreibzugriff.

Syntax

Ausdruck verwendet werden. StencilBackgroundColorGradient

Ausdruck Eine Variable, die ein ApplicationSettings-Objekt darstellt.

Rückgabewert

OLE_COLOR

Hinweise

Die Einstellung der StencilBackgroundColorGradient-Eigenschaft bleibt zwischen den einzelnen Visio-Sitzungen nicht bestehen.

In Visio kann einer der folgenden Werte als gültiger Wert für die OLE_COLOR-Eigenschaft verwendet werden:

  • &H00 bbggrr, wobei bb der Blauwert zwischen 0 und 0xFF (255), gg der Grünwert und rr der Rotwert ist.

  • &H800000 xx , wobei xx ein gültiger GetSysColor-Index ist.

Weitere Informationen zur Funktion "GetSysColor " erhalten Sie, wenn Sie im Microsoft Platform SDK auf MSDN nach " GetSysColor " suchen.

Der Datentyp OLE_COLOR wird für Eigenschaften verwendet, die Farben zurückgeben. Wenn eine Eigenschaft als OLE_COLOR deklariert ist, zeigt die Eigenschaftenfenster ein Dialogfeld zur Farbauswahl an, in dem der Benutzer die Farbe für die Eigenschaft visuell auswählen kann, anstatt sich die numerische Entsprechung merken zu müssen.

Weiterhin können die folgenden VBA-Farbkonstanten (Microsoft Visual Basic für Applikationen) für den Datentyp OLE_COLOR verwendet werden.

Konstante Wert Beschreibung
vbBlack 0x0 Black
vbRed 0xFF Rot
vbGreen 0xFF00 Grün
vbYellow 0xFFFF Gelb
vbBlue 0xFF0000 Blau
vbMagenta 0xFF00FF Magenta
vbCyan 0xFFFF00 Cyan
vbWhite 0xFFFFFF Weiß

Sie können die Hintergrundfarbe des Farbverlaufs für ein einzelnes Schablonenfenster mithilfe von ActiveWindow.Windows(n) festlegen. BackgroundColorGradient-Eigenschaft, wobei n die Indexnummer des Schablonenfensters in der Windows-Auflistung darstellt. Wenn ein Schablonenfenster als unverankertes Fenster geöffnet wird, kann es sich um ein aktives Fenster handeln, und Sie können dessen Hintergrundverlaufsfarbe mithilfe der ActiveWindow.BackgroundColorGradient-Eigenschaft festlegen. Wenn Sie ein Schablonenfenster auf diese Weise geöffnet haben, wird die Einstellung StencilBackgroundColorGradient für dieses Fenster überschrieben, indem Sie die BackgroundColor-Eigenschaft des aktiven Schablonenfensters auf einen anderen Wert als den Standardwert (-1) festlegen. Um die Hintergrundverlaufsfarbe desselben aktiven Schablonenfensters durch Festlegen der StencilBackgroundColorGradient-Eigenschaft zurücksetzen zu können, müssen Sie BackgroundColorGradient auf den Standardwert -1 zurücksetzen. Wenn mehrere Schablonenfenster dieses Typs geöffnet sind, hat die Einstellung von BackgroundColorGradient für ein Fenster keine Auswirkungen auf die Einstellung für andere geöffnete Fenster.

Hinweis

Sie können zwei Farben für den Schablonenhintergrund angeben. Wenn die Bildschirmauflösung des Benutzers entsprechend eingestellt ist, geht eine der Farben vom oberen zum unteren Bildschirmrand in die andere Farbe über. Damit Benutzer dieses Feature verwenden können, muss für den Monitor eine Auflösung von 32 Bit eingestellt werden. Die Möglichkeit, die Farben des Schablonenhintergrunds programmgesteuert festzulegen, ist für Benutzer beschränkt, die den Modus mit hohem Kontrast verwenden.

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.