样式(style) link

使用样式和样式继承 link

每个可视组件都有内建的一个样式。无论是直接创建还是使用界面系统，某个可视组件被创建后就可以在组件上应用样式特性，并且样式生效后更新可视组件的外观。在下面的样例中：

image big hello world = Text("Hello, World", size=40)

size 特性将应用于一个文本组件，允许我们修改文本的字号。如此定制化之后的文本组件会显示40像素高度的文本。

类似的，当使用screen语言时，每个用户接口语句都使用相关的样式特性：

screen big_hello_world:
    text "Hello, World" size 40

Ren’Py支持样式继承，每一种样式都有一个唯一的父类。如果某个样式特性在样式中未定义，样式的值会从亲缘最近的父类、祖父类或者其他元祖类继承。

每个可视组件都使用一个名为 style 的特性，该特性给定了这个可视组件样式的父类。

image big hello world = Text("Hello World", style="big")

screen hello_world:
    text "Hello, World" style "big"

当没有给定 style 特性的情况下，父类会基于可视组件的应用类型进行选择。父类的选择可以被 style_prefix 影响，样式前缀出现在界面语言用户接口语句的样式特性中。

当某个样式被定义位没有指定父类，就会指定一个默认的父类。如果该样式名中包含一个下划线(_)，父类就是把下划线之前的内容移除后的结果。例如，某个样式名为 my_button 就继承自 button 。继承关系可以使用style语句或者调用某个style对象方法改变。当某种不存在的样式被使用时，并且样式名中包含一个下划线，Ren’Py会使用默认的父类创建一种样式。

以下划线开头的样式名是预留给Ren’Py使用的。

Ren’Py在起始阶段建立的各类样式，除了style语句或者初始化语句块(block)之外就不应该再修改已命名的样式。

样式检查器 link

当 config.developer 的值为true时，样式检查器可用于查看某个可视组件使用的样式名。

若要启用样式检查器，将鼠标移动到某个可视组件上，按下键盘的shift+I。Ren’Py会在鼠标位置展现一个可视组件列表，列表中的组件按照在界面被绘制的先后顺序排列。(这表示，最后一个可视组件是在绘制在其他组件上层的。)

点击样式名可以展示可视组件继承的父辈类，以及每种父辈类贡献给最终组件的每一种样式特性。

定义样式：style语句 link

更好的定义样式方法是使用style语句：

style my_text is text:
    size 40
    font "gentium.ttf"

如果某种样式名不存在，style语句就会创建那种样式。相反，style语句会修改已存在的样式。

style语句一关键词 style 开头，后接需要定义的样式名。style语句第一行后面可以跟0个或多个分句，以及一个可选用的英文冒号(:)。

如果出现了英文冒号，下面必然有一个语句块(block)。语句块中每一行都包含一个或多个分句。如果style语句第一行没有冒号，整个语句就是完整的。

style语句接受使用以下分句：

style-property simple-expression

声明的简单表达式的值，会赋值给样式特性。

is parent

设置该样式的父类。 parent 是一个样式名。

clear

在style语句运行前，移除声明的样式所有特性。这个功能对继承自父类的特性值无效。

take style-name

在style语句运行前，移除声明的样式所有特性，并替换为 style-name 样式的特性。这个功能不会修改样式的父类。

variant simple-expression

计算 simple-expression 这个简单表达式，生成一个字符串或者字符串列表，详见 界面变种。 如果给定的界面变形之一是激活状态，style语句会执行，否则会被忽略。

properties simple-expression

计算 simple-expression 这个简单表达式，得到一个字典型数据。该字段能用于将样式特性名映射到具体的值，而这些值被声明为向style语句提供特性值。

style语句的样例如下：

# 创建一个新的样式，使用默认(default)继承。
style big_red:
    size 40

# 更新样式。
style big_red color "#f00"

# 名为label_text的样式使用big_red的特性，
# 前提是我们使用触控(touch)系统。

style label_text:
    variant "touch"
    take big_red

style语句通常都在初始化阶段运行。如果某个style语句没有放在初始化语句块中，其被会自动移动被初始化init 0语句块中。

定义样式：Python语句 link

在全局 style 对象中作为作用域存在着一些命名过的样式。需要创建一种新样式时，就创建一个Style类的实例，并在 style 对象的某个作用域中声明该样式。

init python:
     style.big_red = Style(style.default)

样式特性可以通过在Style对象类似于作用域的特性中声明。

init python:
     style.big_red.color = "#f00"
     style.big_red.size = 42

class Style(parent) link

创建一个新样式对象。样式特性可以在这个对象的作用域中声明。

parent

样式父类。可以是另一个样式对象，或者一个字符串。

clear() link

该函数移除样式对象的所有样式特性。对象父辈继承的值不会变。

set_parent(parent) link

将样式对象的父类设置为 parent 。

take(other) link

使用 other 的所有样式特性。 other 必须是一个样式对象。

init python:
    style.button['Foo'].background = "#f00"
    style.button['Bar'].background = "#00f"

screen indexed_style_test:
    vbox:
        textbutton "Foo" style style.button["Foo"]
        textbutton "Bar" style style.button["Bar"]

init python:
    renpy.register_style_preference("text", "decorated", style.say_dialogue, "outlines", [ (1, "#000", 0, 0) ])
    renpy.register_style_preference("text", "decorated", style.say_dialogue, "size", 22)

    renpy.register_style_preference("text", "large", style.say_dialogue, "outlines", [ ])
    renpy.register_style_preference("text", "large", style.say_dialogue, "size", 24)

textbutton "Decorated" action StylePreference("text", "decorated")
textbutton "Large" action StylePreference("text", "large")