GETCOLORRANGE

此函数将多个颜色的 RGBA 值返回为数组,或返回单个颜色的值。该函数用于将颜色从 Application Studio 调色板传递到 Web 扩展。

调色板包含 64 种颜色,以 8 行和 8 列网格表示。调色板中的每个颜色由从 1 到 64 的索引编号标识。索引编号在网格中由上至下、由左到右递增。

可以指定以下颜色范围:

  • 单个颜色
  • 一维数组

    例如,网格中的第 34 和第 49 种颜色

  • 二维数组

    例如,一个块组有四行,每行有三种颜色

语法

GETCOLORRANGE(initial_index,count_of_colors_per_row,count_of_rows)

示例 - 单个颜色

指定单个颜色时,count_of_rows 参数是可选的,但默认为 1。这些示例返回同一个颜色:

=GETCOLORRANGE(2,1)

=GETCOLORRANGE(2,1,1)

注意

这些示例可返回与这个 GETCOLOR 函数示例相同的结果:

=GETCOLOR(2)

示例 - 一维数组

此示例返回 16 种颜色值的数组。第 1 个颜色为网格中第 34 个颜色,第 16 个颜色为网格中第 49 个颜色。

=GETCOLORRANGE(34,l6)

示例 - 二维数组

此示例返回 12 种颜色的数组。数组包含四行,每行三种颜色。第 1 个颜色为网格中第 5 个颜色,第 12 个颜色为网格中第 31 个颜色。即,该函数指定网格中第五个颜色右侧、以及顶部向下四行的三种颜色:

=GETCOLORRANGE(5,3,4)