Share via

2.5.3.155 Theme

  • Article

The Theme function returns a fixed theme property value.

ABNF:

 Theme = "THEME(" val ")"

Required Arguments:

Name: ThemeProperty

Type: vThemeString

An argument that specifies the property to be returned.

Return Value:

Type: vThemeColor, vThemeEffect, PtgErr

If the ThemeProperty is a fixed theme color scheme property as specified by the value "Color" in the "Scheme" column in the vThemeString table and the value of the structure of the Value Cell_Type child element of the msvThemeColors Row_Type child element of a User Section_Type element is less than 254, this function returns vThemeColor. The fixed theme index is specified by the value of the structure of the Value Cell_Type child element of the msvThemeColors Row_Type element and the fixed theme property is specified by ThemeProperty. If the V attribute of the Value Cell_Type child element of the msvThemeColors Row_Type element has a value equal to 254 and the argument of the USE function token of the F attribute of the Value Cell_Type child element is equal to the UniqueID attribute of a Master_Type element associated with a master, the ThemeProperty argument specifies a custom fixed color scheme property value specified by the Value Cell_Type child element of the User Row_Type element specified by the "User Row_Type" column in the vThemeString table.

If the ThemeProperty is a fixed theme effect scheme property as specified by the value "Effect" in the "Scheme" column in vThemeString table and the value of the structure of the Value Cell_Type child element of the msvThemeEffects Row_Type child element of a User Section_Type element is less than 254, this function returns vThemeEffect. The fixed theme index is specified by the value of the structure of the Value Cell_Type child element of the msvThemeEffects Row_Type element and the fixed theme property is specified by ThemeProperty. If the V attribute of the Value Cell_Type child element of the msvThemeEffects Row_Type element has a value equal to 254 and the argument of the USE function token of the F attribute of the Value Cell_Type child element is equal to the UniqueID attribute of a Master_Type element associated with a master, the ThemeProperty argument specifies a custom fixed effect scheme property value specified by the Value Cell_Type child element of the User Row_Type element specified by the "User Row_Type" column in the vThemeString table.

If ThemeProperty is not found in the table of vThemeString, this function returns a PtgErr parse token with a value equal to #VALUE!.