THEMEVAL 函數
從使用中的主題擷取值。
版本資訊
Version Added: Visio 2013
語法
THEMEVAL ([ “theme_value”][， default])
參數
| 名稱 | 必要/選用 | 資料類型 | 描述 |
|---|---|---|---|
|
“theme_value” |
選用 |
字串 |
主題定義中要從中取得值的儲存格名稱。 |
|
default |
選用 |
各種 |
如果文件沒有主題 (沒有主題定義) ，則為預設值。 |
註解
如果 THEMEVAL 函式 未收到任何自變數，則會傳回主單元格的主題值。 這是儲存在目前主題定義中的值。 主單元格必須能夠以主題方式傳回值;如果儲存格無法進行主題處理， THEMEVAL 會傳回錯誤。
如果 THEMEVAL 函式收到單一自變數，它會從以自變數形式傳入的主題定義中擷取值。 第一個參數傳入的自變數必須是整數或下表所列的其中一個確切字串。
THEMEVAL 函式也可以接受第一個參數的整數，做為介於 1 到 8 之間的值。 使用整數值會依索引從主題的色彩配置擷取色彩。 因此，值 '1' 會傳回主題中的「深色」色彩、'2' 會傳回「淺色」色彩、'3' 會傳回「輔色 1」色彩等等。
如果 THEMEVAL 函式收到兩個自變數，它會從傳入的主題定義中擷取值，做為第一個自變數。 不過，如果檔沒有套用主題，則 THEMEVAL 函式會使用指定的值做為第二個自變數。
“theme_value” 參數的可能自變數
| 值 | 描述 |
|---|---|
| “深色” |
從主題定義擷取深色 RGB 色彩。 |
| “Light” |
從主題定義擷取淺色 RGB 色彩。 |
| “BackgroundColor” |
從主題定義擷取背景 RGB 色彩。 |
| “AccentColor” |
從主題定義擷取 Accent1 RGB 色彩。 |
| “AccentColor2” |
從主題定義擷取 Accent2 RGB 色彩。 |
| “AccentColor3” |
從主題定義擷取 Accent3 RGB 色彩。 |
| “AccentColor4” |
從主題定義擷取 Accent4 RGB 色彩。 |
| “AccentColor5” |
從主題定義擷取 Accent5 RGB 色彩。 |
| “AccentColor6” |
從主題定義擷取 Accent6 RGB 色彩。 |
| “LinePattern” |
從主題定義擷取LinePattern單元格值。 |
| “LineWeight” |
從主題定義擷取 LineWeight 單元格值。 |
| “LineColor” |
從主題定義擷取LineColor單元格值。 |
| “LineCap” |
從主題定義擷取LineCap單元格值。 |
| “LineBegin” |
從主題定義擷取 BeginArrow 單元格值。 |
| “LineEnd” |
從主題定義擷取 EndArrow 單元格值。 |
| “LineColorTrans” |
從主題定義擷取 LineColorTrans 單元格值。 |
| “LineCompoundtype” |
從主題定義擷取 CompoundType 單元格值。 |
| “LineBegin” |
從主題定義擷取 BeginArrow 單元格值。 |
| “LineEnd” |
從主題定義擷取 EndArrow 單元格值。 |
| “LineBeginSize” |
從主題定義擷取 BeginArrowSize 單元格值。 |
| “LineEndSize” |
從主題定義擷取 EndArrowSize 單元格值。 |
| “LineRounding” |
從主題定義擷取捨入單元格值。 |
| “ConnectorColor” |
從主題定義擷取LineColor單元格值。 |
| “ConnectorPattern” |
從主題定義擷取LinePattern單元格值。 |
| “ConnectorWeight” |
從主題定義擷取 LineWeight 單元格值。 |
| “ConnectorTransparency” |
從主題定義擷取 LineColorTrans 單元格值。 |
| “ConnectorRounding” |
從主題定義擷取捨入單元格值。 |
| “ConnectorBegin” |
從主題定義擷取 BeginArrow 單元格值。 |
| “ConnectorEnd” |
從主題定義擷取 EndArrow 單元格值。 |
| “ConnectorBeginSize” |
從主題定義擷取 BeginArrowSize 單元格值。 |
| “ConnectorEndSize” |
從主題定義擷取 EndArrowSize 單元格值。 |
| “FillColor” |
從主題定義擷取 FillForegnd 單元格值。 |
| “FillColor2” |
從主題定義擷取 FillBkgnd 單元格值。 |
| “FillTransparency” |
從主題定義擷取 FillForegndTrans 單元格值。 |
| “FillPattern” |
從主題定義擷取 FillPattern 儲存格值。 |
| “LineGradientEnabled” |
從主題定義擷取 LineGradientEnabled 單元格值。 |
| “LineGradientDir” |
從主題定義擷取 LineGradientDir 單元格值。 |
| “LineGradientAngle” |
從主題定義擷取 LineGradientAngle 單元格值。 |
| “FillGradientEnabled” |
從主題定義擷取 FillGradientEnabled 單元格值。 |
| “FillGradientDir” |
從主題定義擷取 FillGradientDir 單元格值。 |
| “FillGradientAngle” |
從主題定義擷取 FillGradientAngle 單元格值。 |
| “RotateGradientWithShape” |
從主題定義擷取 RotateGradientWithShape 單元格值。 |
| “UseGroupGradient” |
從主題定義擷取UseGroupGradient單元格值。 |
| “ShadowType” |
從主題定義擷取 ShapeShdwType 單元格值。 |
| “ShadowColor” |
從主題定義擷取ShdwColor單元格值。 |
| “ShadowTransparency” |
從主題定義擷取 ShdwColorTrans 單元格值。 |
| “ShadowMagnification” |
從主題定義擷取 ShapeShdwScaleFactor 單元格值。 |
| “ShadowBlur” |
從主題定義擷取 ShapeShdwBlur 單元格值。 |
| “ShadowXOffset” |
從主題定義擷取 ShapeShdwOffsetX 單元格值。 |
| “ShadowYOffset” |
從主題定義擷取 ShapeShdwOffsetY 單元格值。 |
| “ShadowDirection” |
從主題定義擷取 ShapeShdwObliqueAngle 儲存格值。 |
| “ShadowPattern” |
從主題定義擷取 ShdwPattern 儲存格值。 |
| “BevelTopType” |
從主題定義擷取 BevelTopType 單元格值。 |
| “BevelTopWidth” |
從主題定義擷取 BevelTopWidth 單元格值。 |
| “BevelTopHeight” |
從主題定義擷取 BevelTopHeight 單元格值。 |
| “BevelMaterial” |
從主題定義擷取 BevelMaterialType 單元格值。 |
| “BevelLighting” |
從主題定義擷取 BevelLightingType 單元格值。 |
| “BevelLightingAngle” |
從主題定義擷取 BevelLightingAngle 儲存格值。 |
| “BevelContourColor” |
從主題定義擷取 BevelContourColor 單元格值。 |
| “BevelContourSize” |
從主題定義擷取 BevelContourSize 單元格值。 |
| “ReflectionBlur” |
從主題定義擷取 ReflectionBlur 單元格值。 |
| “ReflectionDist” |
從主題定義擷取 ReflectionDist 單元格值。 |
| “ReflectionSize” |
從主題定義擷取 ReflectionSize 單元格值。 |
| “ReflectionTrans” |
從主題定義擷取 ReflectionTrans 單元格值。 |
| “SoftEdgesSize” |
從主題定義擷取 SoftEdgesSize 單元格值。 |
| “GlowSize” |
從主題定義擷取 GlowSize 單元格值。 |
| “GlowColor” |
從主題定義擷取 GlowColor 單元格值。 |
| “GlowTransparency” |
從主題定義擷取 GlowColorTrans 單元格值。 |
| “SketchAmount” |
從主題定義擷取 SketchAmount 單元格值。 |
| “SketchEnabled” |
從主題定義擷取 SketchEnabled 單元格值。 |
| “SketchFillChange” |
從主題定義擷取 SketchFillChange 單元格值。 |
| “SketchLineChange” |
從主題定義擷取 SketchLineChange 單元格值。 |
| “SketchLineWeight” |
從主題定義擷取 SketchLineWeight 單元格值。 |
| “LatinFont” |
從主題定義擷取 Font 單元格值。 |
| “TextColor” |
從主題定義擷取 Color 單元格值。 |
| “TextStyle” |
從主題定義擷取 Character.Style 儲存格值。 |
| “ComplexFont” |
從主題定義擷取 ComplexScriptFont 單元格值。 |
| “AsianFont” |
從主題定義擷取 AsianFont 單元格值。 |
| “FillStop[x]Color” |
從主題定義擷取數據列 x 中的 Color 單元格值。 |
| “FillStop[x]Transparency” |
從主題定義擷取列 x 中的 ColorTrans 單元格值。 |
| “FillStop[x]Position” |
從主題定義擷取數據列 x 中的 Position 單元格值。 |
| “LineStop[x]Color” |
從主題定義擷取數據列 x 中的 Color 單元格值。 |
| “LineStop[x]Transparency” |
從主題定義擷取列 x 中的 ColorTrans 單元格值。 |
| “LineStop[x]Position” |
從主題定義擷取數據列 x 中的 Position 單元格值。 |
範例
THEMEVAL("5")
從主題定義傳回 「Accent 3」 色彩。
THEMEVAL("LineWeight", "0.7 pt.")
從主題定義傳回 「LineWeight」 儲存格的值。 如果包含此函式的圖形未套用主題，則函式會傳回 『0.7 pt.』。