ApplicationSettings.DrawingBackgroundColor-Eigenschaft (Visio)

Artikel
01/17/2024

Bestimmt die Hintergrundfarbe des Microsoft Visio-Zeichnungsfenster. Lese-/Schreibzugriff.

Syntax

Ausdruck. DrawingBackgroundColor

Ausdruck Eine Variable, die ein ApplicationSettings-Objekt darstellt.

Rückgabewert

OLE_COLOR

Hinweise

Die folgenden Werte sind in Visio für eine OLE_COLOR-Eigenschaft gültig:

&H00 bbggrr, wobei bb der blaue Wert zwischen 0 und 0xFF (255) ist, gg den grünen Wert und rr den roten Wert.
&H800000 xx , wobei xx ein gültiger GetSysColor-Index ist.

Weitere Informationen zur GetSysColor-Funktion finden Sie im Microsoft Platform SDK auf MSDN nach " GetSysColor ".

Der Datentyp OLE_COLOR wird für Eigenschaften verwendet, die Farben zurückgeben. Wenn eine Eigenschaft als OLE_COLOR deklariert wird, zeigt die Eigenschaftenfenster ein Dialogfeld für die 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ß

Das Festlegen der BackgroundColor-Eigenschaft des aktiven Fensters auf einen anderen Wert als den Standardwert (-1) überschreibt die DrawingBackgroundColor-Einstellung für dieses Fenster. Um die Hintergrundfarbe desselben aktiven Fensters durch Festlegen der DrawingBackgroundColor-Eigenschaft zurücksetzen zu können, müssen Sie BackgroundColor auf den Standardwert -1 zurücksetzen. Wenn mehrere Fenster geöffnet sind, hat das Festlegen von BackgroundColor für ein Fenster keine Auswirkungen auf die Einstellung für andere geöffnete Fenster.

Hinweis

Wenn Benutzer im Modus für starke Kontraste arbeiten, ist die Möglichkeit zum programmgesteuerten Festlegen der Hintergrundfarbe für Zeichnungen eingeschränkt.

Beispiel

Mit dem folgenden VBA-Makro wird veranschaulicht, wie Sie mit der DrawingBackgroundColor-Eigenschaft die Hintergrundfarbe der Anwendung abrufen und festlegen. Außerdem wird gezeigt, wie ein ApplicationSettings-Objekt aus dem Application-Objekt von Visio abgerufen wird, und es wird die Beziehung zwischen der DrawingBackgroundColor-Eigenschaft und der Window.BackgroundColor-Eigenschaft veranschaulicht. In diesem Beispiel wird davon ausgegangen, dass in Visio ein Zeichnungsfenster geöffnet ist und dass anfänglich alle Hintergrundfarbeigenschaften auf ihre Standardwerte festgelegt sind.

Public Sub DrawingBackgroundColor_Example() 
 
 Dim vsoApplicationSettings As Visio.ApplicationSettings 
 Set vsoApplicationSettings = Visio.Application.Settings 
 
 'Get the current application background color. 
 Debug.Print vsoApplicationSettings.DrawingBackgroundColor 
 
 'Get the active window background color. 
 Debug.Print ActiveWindow.BackgroundColor 
 
 'Change the application background color. 
 'This will also change the active window color as 
 'well as the setting in the Color Settings dialog box 
 vsoApplicationSettings.DrawingBackgroundColor = vbRed 
 
 'Change the active window background color. 
 ActiveWindow.BackgroundColor = vbMagenta 
 
 'Change the application background color again. 
 'This time, there is no change in the current 
 'window color, but the dialog box setting changes. 
 vsoApplicationSettings.DrawingBackgroundColor = vbYellow 
 
 'Reset Window.BackgroundColor to its default value. 
 ActiveWindow.BackgroundColor = -1 
 
 'Change the application background color again. 
 'Now both the active window color 
 'and the dialog box setting change. 
 vsoApplicationSettings.DrawingBackgroundColor = vbBlue 
 
End Sub

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.

Freigeben über