樣式(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")