會決定 Microsoft Visio 樣板視窗目前工作階段的背景漸層色彩。 讀取/寫入。
語法
運算式。StencilBackgroundColorGradient
運算式 代表 ApplicationSettings 物件的變數。
傳回值
OLE_COLOR
註解
StencilBackgroundColorGradient 屬性設定無法從 Visio 的某個工作階段延續至下一個工作階段。
Visio 中的 OLE_COLOR 屬性的有效值可以是下列其中一項：
&H00 bbggrr， 其中 bb 是介於 0 到 0xFF (255) 之間的藍色值， gg 表示綠色值， rr 表示紅色 值。
&H800000 xx ，其中 xx 是有效的 GetSysColor 索引。
有關 GetSysColor 函數的詳細資訊，請在 MSDN 上的 Microsoft Platform SDK 中搜尋「 GetSysColor 」。
OLE_COLOR資料類型用於傳回色彩的屬性。 當屬性宣告為OLE_COLOR時，屬性視窗會顯示色彩選擇器對話方塊，讓使用者以視覺方式選取屬性的色彩，而不必記住對應的數字。
此外，您也可以使用下列 OLE_COLOR 的 Microsoft Visual Basic for Applications (VBA) 色彩常數。
| 常數 | 值 | 描述 |
|---|---|---|
| vbBlack | 0x0 | 黑色 |
| vbRed | 0xFF | 紅色 |
| vbGreen | 0xFF00 | 綠色 |
| vbYellow | 0xFFFF | 黃色 |
| vbBlue | 0xFF0000 | 藍色 |
| vbMagenta | 0xFF00FF | 洋紅色 |
| vbCyan | 0xFFFF00 | 青色 |
| vbWhite | 0xFFFFFF | 白色 |
您可以使用 ActiveWindow.Windows (n) ，為個別樣板視窗設定背景漸層色彩。BackgroundColorGradient 屬性，其中 n 代表 Windows 集合中樣板視窗的索引號碼。 當樣板視窗開啟為浮動視窗時，可能會是使用中的視窗，而您可以使用 ActiveWindow.BackgroundColorGradient 屬性來設定其背景漸層色彩。 如果您以這種方式開啟樣板視窗，將使用中樣板視窗的 BackgroundColor 屬性設定為預設 (-1 以外的值，) 會覆寫該視窗的 StencilBackgroundColorGradient 設定。 若要藉由設定 StencilBackgroundColorGradient 屬性來重設同一使用中樣板視窗的背景漸層色彩，您必須將 BackgroundColorGradient 重設為預設值 -1。 如果有多個樣板視窗開啟，則設定一個視窗的 BackgroundColorGradient 不會影響其他開啟視窗的設定。
注意事項
您可以為樣板背景指定兩種色彩。 如果使用者的畫面解析度適當，色彩會從畫面的頂端至底端漸層變化至另一個色彩。 若要使用這項功能，使用者必須將其螢幕設定為顯示 32 位元色彩。 如果使用者是以高對比模式執行，則以程式設計方式設定樣板背景色彩的能力會受到限制。
支援和意見反應
有關於 Office VBA 或這份文件的問題或意見反應嗎？ 如需取得支援服務並提供意見反應的相關指導，請參閱 Office VBA 支援與意見反應。