theme

R2026b

设置或获取图窗主题

自 R2025a 起

全页折叠

    语法

    theme(newtheme)
    theme(fig,newtheme)
    gt = theme(___)
    gt = theme
    gt = theme(fig)

    描述

    设置主题

    theme(newtheme) 将当前图窗的主题设置为指定的新主题，该主题可以是 "light"、"dark"、"auto" 或 GraphicsTheme 对象。当您指定其中一个主题名称时，此语法的圆括号是可选的。例如，theme light 与 theme("light") 相同。

    调用此函数会设置图窗的 Theme 和 ThemeMode 属性。

    示例

    theme(fig,newtheme) 设置指定图窗的主题。

    gt = theme(___) 设置主题并将其以 GraphicsTheme 对象形式返回。

    示例

    获取主题

    gt = theme 将当前图窗的主题以 GraphicsTheme 对象形式返回。

    gt = theme(fig) 返回指定图窗的主题。

    示例

    全部折叠

    打开实时脚本

    创建一个图窗，通过调用 theme 函数并将 GraphicsTheme 对象以 gt 形式返回来将其主题设置为 "dark"。然后在图窗中创建一个条形图。 

    fig = figure;
gt = theme(fig,"dark");
bar([1 2 3 4; 5 6 7 8])

    Figure contains an axes object. The axes object contains 4 objects of type bar.

    将主题更改为 "light"。

    theme(fig,"light")

    Figure contains an axes object. The axes object contains 4 objects of type bar.

    使用 GraphicsTheme 对象 gt 设置主题。

    theme(fig,gt)

    Figure contains an axes object. The axes object contains 4 objects of type bar.

    输入参数

    全部折叠

    新主题，指定为 "light"、"dark"、"auto" 或 GraphicsTheme 对象。

    目标图窗，指定为 Figure 对象或由 Figure 对象组成的数组。

    输出参量

    全部折叠

    具有以下属性的图形主题对象。

    属性描述

    Name

    主题的简短描述，以 'Light Theme' 或 'Dark Theme' 形式返回。

    BaseColorStyle

    主题的基本颜色样式，以 'light' 或 'dark' 形式返回。此属性指示主题的整体亮度或暗度。在决定图的调色板或编写 ThemeChangedFcn 回调时查询此属性。

    版本历史记录

    在 R2025a 中推出

    另请参阅

    函数

    对象

    主题