樣式特性(property)

(譯者註：property一詞通常翻譯成“屬性”。鑑於文件中的attribute也可以翻譯成“屬性”。為了防止混淆，將property翻譯為“特性”。)

樣式特性與 樣式 相關，控制可視組件的顯示方式。樣式特性出現時可以沒有前綴，這種情況下樣式特性應用於所有狀態的可視組件；帶前綴的樣式特性則限制了應用組件的狀態。

樣式特性前綴

增加前綴可以從樣式特性名稱上就能看出作用於哪些狀態的可視組件，比如得到焦點或者被選擇狀態。例如，某個按鈕可以在滑鼠懸停其上的時候改變顏色，或者提示按鈕對應的選項就是目前使用的選項。

可視組件總共有5種狀態可用作樣式特性前綴。

insensitive

當用戶與無法與可視組件互動時使用。

idle

當可視組件即沒有獲得焦點也沒有被選中時使用。

hover

當可視組件獲得焦點但沒有被選中時使用。

selected_idle

當可視組件未獲得焦點但被選中時使用。

selected_hover

當可視組件獲得焦點且被選中時使用。

按鈕和條類可視組件(包括他們的各類變種)在收到事件消息後，會更新自身和子組件的狀態。例如，當用戶把滑鼠移動到某個未被選擇的按鈕上方，按鈕及其子組件都會把狀態改為hover。

樣式特性前綴名允許外延。這裡是一個前綴狀態及其能外延的所有可視組件狀態映射關係。

prefix	states implied by prefix
(no prefix)	insensitive, idle, hover, selected_idle, selected_hover
idle_	idle, selected_idle
hover_	hover, selected_hover
selected_	selected_idle, selected_hover
insensitive_	insensitive
selected_idle_	selected_idle
selected_hover_	selected_hover
selected_insensitive_	selected_insensitive

我們可以使用一個文本按鈕實際示範一下。文本按鈕使用兩個預設的樣式： button 用於按鈕本身， button_text 用於按鈕上的文本。 background 樣式特性設置按鈕的背景， color 特性設置文本顏色：

# 當按鈕為insensitive狀態時，背景為灰色；hover狀態是，背景為淺藍；
# 其他情況下，背景為深藍。
style button:
    background "#006"
    insensitive_background "#444"
    hover_background "#00a"

# 當按鈕為selected狀態時，文本為黃色；其他情況下為白色。
style button_text:
    color "#fff"
    selected_color "#ff0"

樣式特性的值

每種樣式特性對應每種特定類型的數據。許多特性值都是標準的python數據類型，有一些是novel類型。這裡會對這些novel類型的數據進行詳細說明。

position

position用於指定以左上角為原點的坐標系中的位置。(對position來說，可用區域由可視組件所在的圖層給定，如果沒有圖層就是整個界面。對anchor來說，可用區域是其自身可視組件的大小。)

position值的表示結果與數據類型有關：

int (比如 0、1、37或42)

整數的表示結果為像質數，從可用區域最左邊或頂邊算起。

float (比如 0.0、0.5或1.0)

浮點數的表示結果為可用區域的一個比例。例如，0.5表示區域內某條邊的中點，1.0表示右側邊或者底邊。

absolute(value, /)

例如，當 a 和 b 類型相同，均為float或int型時，可以使用 absolute(100.25) 或 absolute(a+b) 。

當啟用精確子像素(subpixel-precise)渲染時，absolute 類型的值表示以界面左上角開始計的像質數，

position(absolute, relative, /)

例如，position(-10, .5)。

absolute 表示絕對坐標，relative 表示相對比例。兩者(都換算成absolute類型後)相加的結果決定最後坐標。

使用該函數時必須傳兩個參數，否則會產生不確定的結果。

displayable

任意可視組件。若某個可視組件名包含某個類似“[prefix_]”的子串，就會按照如下描述進行前綴搜索。

color

Ren’Py中的color可以寫作以符號(#)開頭、後面接十六進位制的字串。十六進位制字串長度可以為3或4的整數倍，分別對應幾種顏色。

十六進位制字串為3的整數倍時，分別對應紅、綠、藍三種顏色。十六進位制字串為4的整數倍時，分別對應紅、綠、藍和alpha通道值。舉例：

• "#f00" 和 "#ff0000" 表現為不透明的純紅。

• "#0f08" 和 #00ff0080" 表現為某種半透明的綠色。

顏色代碼規律和用於HTML的顏色代碼相同。

color也可以用一個4元素的元組，每個元素都是介於0到255的整數，順序對應紅、綠、藍和alpha通道值。

• (0, 0, 255, 255) 表現為完全不透明的藍色。

最後，color可以是 Color 類的一個實例。

樣式前綴搜索

當某個樣式特性包含“[prefix_]”可替換前綴，就會進行前綴搜索。前綴搜索會查找沒一種狀態前綴，根據原特性已經明確聲明過的資訊。

舉例，如果我們有如下腳本：

style button:
    hover_background "[prefix_]background.png"

樣式前綴搜索會分別搜索hover和selected_hover狀態。前綴的搜索基於樣式特性定義語句中的state值。

state	search order
idle	“idle_”, “”
hover	“hover_”, “”,
insensitive	“insensitive_”, “”, “idle_”
selected_idle	“selected_idle_”, “idle_”, “selected_”, “”
selected_hover	“selected_hover_”, “hover_”, “selected_”, “”
selected_insensitive	“selected_insensitive_”, “hover_”, “selected_”, “”, “selected_idle_”, “idle_”

樣式前綴搜索按上面表格給出的順序進行。然後Ren’Py會堅持是否有符合那個名稱的可載入文件或者圖像存在。如果文件或圖像存在，樣式前綴搜索就會結束，並且使用找到的可視組件。否則，搜索會繼續嘗試下一個前綴。

樣式前綴會傳給可視組件，不需要用戶輸入。

這裡是一個樣例，示範這個功能如何使用。假設文件“idel_button.png”和“hover_button.png”存在(並且不存在其他以“button.png”字串結尾的其他文件)：

style button:
    background "[prefix_]button.png"

等效於：

style button:
    idle_background "idle_button.png"
    hover_background "hover_button.png"
    insensitive_background "idle_button.png"

    selected_idle_background "idle_button.png"
    selected_hover_background "hover_button.png"
    selected_insensitive_background "idle_button.png"

所有樣式特性的列表

樣式特性控制各種可視組件的外觀。但並不是所有特性都能應用於所有可視組件，所以我們將特性分了幾個組。

位置樣式特性

這類特性可以應用於所有可視組件，大部分通過布局(layout)控制可視組件在區域內的位置，或者不使用布局(layout)時直接控制在整個界面的位置。

alt -  string or None

當self-voicing啟用時，備選文本會用於可視組件。詳見 自動語音 章節內容。

xpos -  position

可視組件相對於可選區域左端的位置。

ypos -  position

可視組件相對於可選區域頂端的位置。

pos -  tuple of (position, position)

將xpos和ypos放入一個元組，分別作為元組的第一個和第二個元素。

xanchor -  position

錨點相對於可選區域左端的位置。

yanchor -  position

錨點相對於可選區域頂端的位置。

anchor -  tuple of (position, position)

將xanchor和yanchor放入一個元組，分別作為元組的第一個和第二個元素。

xalign -  float

將xpos和xanchor設置為相同值。根據該值將可視組件顯示在界面的某個相對位置上，0.0表示左對齊，0.5表示居中，1.0表示右對齊。

yalign -  float

將ypos和yanchor設置為相同值。根據該值將可視組件顯示在界面的某個相對位置上，0.0表示頂端對齊，0.5表示居中，1.0表示底端對齊。

align -  tuple of (float, float)

將xalign和yalign放入一個元組，分別作為元組的第一個和第二個元素。

xcenter -  position

將xpos設為該特性的值，將xanchor設為0.5。

ycenter -  position

將ypos設為該特性的值，將yanchor設為0.5。

xoffset -  int

給出了水平方向的偏移值，單位為像素。

yoffset -  int

給出了垂直方向的偏移值，單位為像素。

offset -  tuple of (int, int)

將元祖的第一和第二元素分別設為xoffset和yoffset的值。

offset -  tuple of (position, position)

同時給出水平和垂直方向的偏移值，分別使用元組的第一個和第二個元素。

xmaximum -  int

指定可視組件水平方向尺寸最大值，單位為像素。

ymaximum -  int

指定可視組件垂直方向尺寸最大值，單位為像素。

maximum -  tuple of (int, int)

使用元組指定可視組件尺寸最大值，水平和垂直方向分別使用元組的第一個和第二個元素。

xminimum -  int

設置可視組件的最小寬度，單位為像素。僅對可以改變尺寸的可視組件有效。

yminimum -  int

設置可視組件的最小高度，單位為像素。僅對可以改變尺寸的可視組件有效。

minimum -  tuple of (int, int)

使用元組設置xminimum和yminimum。

xsize -  int or float

將xminimum和xmaximum設置為相同值。該特性對可視組件的寬度生效。如果值是一個浮點數，表示區域寬度的一個比例值。

ysize -  int or float

將yminimum和ymaximum設置為相同值。該特性對可視組件的高度生效。如果值是一個浮點數，表示區域高度的一個比例值。

xysize -  tuple of (int or float, int or float)

使用元組第一個元素設置xminimum和xmaximum，使用元組的第二個元素設置yminimum和ymaximum。該特性對可視組件的尺寸生效。

xfill -  boolean

若為True，可視組件會在水平方向填滿所有可用空間。若不為True，可視組件只占用包含所有子組件的空間。

僅對可以改變尺寸的可視組件有效。

yfill -  boolean

若為True，可視組件會在垂直方向填滿所有可用空間。若不為True，可視組件只占用包含所有子組件的空間。

僅對可以改變尺寸的可視組件有效。

area -  tuple of (int, int, int, int)

元組內元素可解釋為 (xpos, ypos, width, height)。如果把某個可視組件的左上角放在 xpos 和 ypos 對應的位置，那麼它的尺寸就是 width 和 height。

這個特性會把xpos、ypos、xanchor、yanchor、xmaximum、ymaximum、xminimum、yminimum、xfill和yfill自動設置為合適的值。

但這個特性並不適用於所有的可視組件和布局(layout)。

mipmap -  boolean 或 None

該特性控制可視組件創建的紋理是否使用mipmap。該特性只適用於某些可視組件，包括 Text()，Movie() 和 dissolve。

若非None，預設值從配置項 config.mipmap_text，config.mipmap_movies 和 config.mipmap_dissolves 獲取。

文本樣式特性

antialias -  boolean

若為True，默認情況，全真字體(truetype font)文本會使用反鋸齒渲染。

adjust_spacing -  boolean or str

若為True，Ren’Py會調整繪製解析度下文本間隙以匹配虛擬解析度下渲染的文本間隙，確保frame和其他容器類內的文本不會被改變。

若設置為False，文本不會改變字號，但確保在任何窗口大小下布局文本都有足夠空間，這是創作者的職責。

當字串設置為“horizontal”時，僅在水平方向調整文本。 當字串設置為“vertical”時，僅在垂直方向調整文本。

對大多數文本來說都是用預設值True，但在需要 input 輸入的情況下使用False。

altruby_style -  style or None

如果為值非None，這應是一個樣式對象。它會用作轉換的ruby文本樣式。

axis -  dict or None

該特性可以設置 可變字體 的圓形區域軸線(axis)。 若非None，其應是一個字典，可以根據軸線名查找對應的值。例如：

style default:
    font "VariableFont.ttf"
    axis { "weight" : 500, "width" : 95 }

black_color -  color

當渲染某個基於圖像的字體時，黑色會被映射為需要的顏色。這個特性對全真(truetype)字體無效。

bold -  boolean

若為True，使用粗體渲染。對全真(truetype)字體來說，這個特性會會綜合提升字體的重量(weight)。這個特性也可能會觸發字體映射，使用 config.font_replacement_map 配置的值。

caret -  displayable or None

若非None，其應是一個可視組件。輸入部件會使用這個可視組件顯示在文本的末尾。若為空，會有一條1像素寬的線在行尾閃爍。

color -  color

文本渲染使用的色彩。當使用某個全真(truetype)字體時，字體會直接使用色彩渲染。當使用基於圖像的字體時，白色會映射為指定的色彩。

emoji_font -  string

該字體用作Emoji表情。遇到一個或多個Emoji表情時會自動替換，但不能使用文本標籤(text tag)。

first_indent -  int

首行縮進量，單位是像素。

font -  string

用於渲染文本的字體名稱字串。

對於全真(truetype)字體檔案來說，該字串通常就是包含字體的檔案名(例如 "DejaVuSans.ttf")。如果需要使用字體集的第二種字體，就在字體名前面加一個數字和@符號，(例如 “0@font.ttc” 或 “1@font.ttc”)。對於基於圖像的字體來說，該字串是字體註冊時使用的名稱。

hinting -  str

控制字體如何進行微調。可以是以下幾個字串之一：

“auto”

預設值，使用Freetype自動微調。

“auto-light”

在light模式下，強制使用Freetype自動在豎直方向上微調。

“bytecode”

使用字體中的bytecode微調資訊。

“none”

對字體不進行微調。

若該項為True，則會查找和應用 config.font_hinting 的配置。

hyperlink_functions -  tuple of (function, function, function)

這是由三個與超連結有關的函數構成的元組。

第一個元素是超連結樣式函數。當使用一個入參(超連結)調用函數時，會返回得到用於該超連結的樣式對象，比如 style.hyperlink_text 。需要注意，樣式對象並不是一個字串。

第二個元素是超連結點擊函數。當超連結被用戶選中的時候，該函數會被調用。如果該函數返回一個值並且不是None，這個值也會作為互動行為的返回值。

第三個元素是超連結焦點函數。當超連結獲取焦點時，該函數會被調用，並將超連結作為入參；當超連結失去焦點時，該函數也會被調用，入參使用空值(None)。如果該函數返回一個值並且非空，這個值也會作為互動行為的返回值。

instance -  string or None

該項是一個字串，指定 可變字體 的字體實例。 例如某個字體具有“Bold”(粗體)實例，就可以將該項設置為“Bold”，顯示的字體就是粗體。

italic -  boolean

若為True，使用斜體渲染文本。對全真(truetype)字體來說，這個特性會會綜合提升字體的傾斜度(slant)。這個特性也可能會觸發字體映射，使用 config.font_replacement_map 配置的值。

justify -  boolean

若該值為True，單字之間會插入額外的空白，每行文字左右兩端的空白也會增加。段落最後一行的結尾不會發生變化。

kerning -  float

字偶距調整，任意兩個字元之間的空白像質數會增加。(如果要縮小字元之間的空白，該值應該是負數。)

language -  string

控制語言文字族斷行。合法值如下：

"unicode" (default)

使用unicode斷行算法，大多數語言的默認項。

"japanese-strict"

使用“strict”法格式化日語文本。禁止在小寫的假名和延音記號前斷行。

"japanese-normal"

使用“normal”法格式化日語文本。允許在小寫的假名、延音標記和某些連字號號後斷行。

"japanese-loose"

使用“loose”法格式化日語文本。允許在小寫的假名、延音標記、疊字元號、不可分割字元、中心化標點符號和後綴的後面斷行；也允許在前綴的前面斷行。

"korean-with-spaces"

使用空白定界的韓語文本。防止臨近的韓語字元之間出現斷行。

"western"

只循序在空白處斷行。適用於大多數語言。

"anywhere"

沒有ruby的任意地方都可以斷行。

三種日語的斷行模式來源於 CSS3文本模組。

layout -  string

控制每行單字(字)的分配方式。合法值如下：

"tex" (default)

使用Knuth-Plass斷行算法。該算法能讓除最後一行之外，各行的長度差異盡可能小。

"subtitle"

使用Knuth-Plass斷行算法，但會使用空格盡可能讓每行長度一致。

"greedy"

每行盡可能多得放入單字(字)。

"nobreak"

不斷行。

line_leading -  int

每行所占空間的像質數。

line_overlap_split -  int

在慢速文本模式下兩行文本有重疊部分，這部分重疊像素分配給上面那行文本。如果上面那行文本的底部出現了被裁減的情況，就增加該特性的值。

line_spacing -  int

每一行下面空間的像質數。

min_width -  int

設置每行的最小寬度。如果某行的寬度小於該值，會使用兩側留白填充至該值。text_align 用於指定填充方式。

newline_indent -  boolean

若為True， first_indent 的縮進量會應用於每個新行。否則使用 rest_indent 的縮進量。

outlines -  list of tuple of (int, color, int, int)

這是一個文本後繪製的輪廓線列表。每個元組指定一種輪廓線，輪廓線從後往前繪製。

列表中包含 (size, color, xoffset, yoffset) 形式的元組。 Size 是字體外沿尺寸，單位為像素。 Color 是輪廓線色彩。 xoffset 和 yoffset 是輪廓線的位移，單位為像素。

輪廓線功能可以用於給字體添加投影，方法是將size設為0，偏移量設為非0。

默認情況下， size, xoffset 和 yoffset 會隨文本一同拉伸。當我們給定absolute類型時，就能禁止拉伸。舉例：

style default:
    outlines [ (absolute(1), "#000", absolute(0), absolute(0)) ]

這段腳本產生了1像素寬的邊界。

輪廓線只對全真(truetype)字體有效。 輪廓線只能對整個文本組件應用時才生效。 無法應該用在超連結、文本標籤和文本的部分內容。

outline_scaling -  string

遊戲窗口縮放後，該特性決定文字輪廓線的大小和偏移如何縮放。

"linear"

預設值，粗輪廓線的最佳方案。窗口縮放係數直接乘以輪廓線大小的值，然後取整。 輪廓線越粗越好，否則同心的相近粗細輪廓線可能會混在一起看不清。

縮放後的輪廓線粗細值至少為1像素。

"step"

細輪廓線或多重輪廓線的最佳方案。 窗口縮放係數向下取整，然後乘以輪廓線粗細和偏移值。 這樣可以確保多重輪廓線可以同時縮放，不會發生互相遮擋。 但在不同遊戲窗口尺寸條件下，視覺效果會略有不同。

窗口縮放係數不小於1。

prefer_emoji -  boolean

某些Unicode字元可以同時解釋為Emoji表情或其他文本。該樣式特性決定這種字元的優先顯示為Emoji表情。

rest_indent -  int

指定段落首行之外的縮進量，單位為像素。

ruby_line_leading -  int

含有 ruby文本 的文本行間距，單位是像素。該項會加在 line_leading 上並產生最終效果。

ruby_style -  style or None

如果非None，該值是一個樣式對象，用於ruby文本。

shaper -  "harfbuzz" or "freetype".

文本渲染使用的字體引擎(shaper)。該項只能是“harfbuzz”和“freetype”兩者其中之一。 harfbuzz用途更廣，但只能在Ren’Py 8上運行。而freetype還能在Ren’Py 7上運行。

字體引擎(shaper)會將一系列字元轉為一串固定位置的字形(glyphs)。其用在連寫字符、印地/婆羅米文以及Emoji表情。

size -  int

界面中字體的字號。通常字號大小就是字體高度的像素值，字體檔案中可能還會插入幾個像素。

slow_abortable -  boolean

如果為True，能傳到文本對象的點擊事件會觸發退出慢速文本模式，這意味著後面部分的文本會立刻顯示。

slow_cps -  int or True

如果是一個整數，表示每秒顯示的字元速率。如果為True，使用個性化配置中的“文本速度”。

slow_cps_multiplier -  float

文本顯示速度會乘上該值。可以用於表現某個角色的說話速度比正常速率略快的情況。

strikethrough -  boolean

若為True，每行文字會添加刪除線。

textalign -  float

當一行文本的寬度比文本組件的寬度小時，該項起作用。其決定文本左邊會有多少留白。(也就是文本的對齊。)

0.0表示左對齊，0.5表示中央對齊，1.0表示右對齊。

underline -  boolean

若為True，文本會添加下劃線。

vertical -  boolean

若為True，文本內容會渲染為垂直文本。

There are multiple caveats:

• 若 shaper 的值是“freetype”。垂直文本會有問題。

• harfbuzz渲染器遇到字體中存在的格式(form)時，會從水平格式轉成垂直格式。

• 字元會從按“從上到下，從右往左”的順序排列，而不會旋轉。即，各個字元會呈現疊羅漢似的排列方式。

• 如果字體中沒有垂直文本的相關資訊，字體渲染器則會嘗試合成，但不保證結果正確。 總體來說，表意文字的合成效果比非表意文字要好。

窗口樣式特性

窗口特性用於指定窗口、框架和按鈕的外觀。

background -  displayable or None

用作窗口背景的可視組件。通常是一個 Frame()，能根據窗口大小拉伸背景的尺寸。

若為None，不繪製背景。但其他特性函數會假設背景存在。

foreground -  displayable or None

若不為None，該可視組件會在窗口內容上繪製並覆蓋。

left_margin -  int

背景左端的透明空間量，單位為像素。

right_margin -  int

背景右端的透明空間量，單位為像素。

xmargin -  int

等效於將left_margin和right_margin設置為相同的值。

top_margin -  int

背景頂端的透明空間量，單位為像素。

bottom_margin -  int

背景底端的透明空間量，單位為像素。

ymargin -  int

等效於將top_margin和bottom_margin設置為相同的值。

margin -  tuple

如果出現的是2個元素的元組，分別將xmargin和ymargin設置為對應的兩個元素值。如果出現的是4元素元組，分別將left_margin、top_margin、right_margin和bottom_margin設置為對應的4個元素值。

left_padding -  int

背景與窗口內容左邊的空間量，單位為像素。

right_padding -  int

背景與窗口內容右邊的空間量，單位為像素。

xpadding -  int

等效於將left_padding和right_padding設置為相同的值。

top_padding -  int

背景與窗口內容頂邊的空間量，單位為像素。

bottom_padding -  int

背景與窗口內容底邊的空間量，單位為像素。

ypadding -  int

等效於將top_padding和bottom_padding設置為相同的值。

padding -  tuple

如果出現的是2個元素的元組，分別將xpadding和ypadding設置為對應的兩個元素值。如果出現的是4元素元組，分別將left_padding、top_padding、right_padding和bottom_padding設置為對應的4個元素值

size_group -  string or None

若非None，該值是一個字串。Ren’Py會使用size_group值相同的尺寸渲染所有窗口。

modal -  boolean or callable

若為True，窗口設為模態。滑鼠點擊事件值對當前窗口內的window或按鈕組件有效，不會廣播穿透。 若為False，窗口設為非模態。

該項也可以是一個可調用的函數。 其為函數時，入參使用(ev, x, y, w, h)形式的四元元組。其中ev是pygame事件消息，也可能是None籠統表示一個滑鼠事件；x和y表示窗口坐標，w和h表示窗口的寬和高。函數返回為True時，窗口視為模態，否則視為非模態。

按鈕樣式特性

child -  displayable or None

若非None，給出的可視組件會替換按鈕的子組件。例如，該可視組件(作為insensitive_child)可以用於替換insensitive的按鈕圖片內容，insensitive表示按鈕被鎖住無法使用。

hover_sound -  string

當按鈕獲取焦點時，將播放一個音效。

activate_sound -  string

當按鈕被點擊時，將播放一個音效。

hover_sound -  - string

當按鈕獲得焦點時，將播放一個音效。

activate_sound -

當按鈕被啟用(點擊)時，將播放一個音效。 也會在條(bar)和拖拽組件啟用時播放該音效。

mouse -  string

滑鼠樣式用於按鈕獲得焦點狀態。這是定義在 config.mouse 中的樣式之一。

focus_mask -  multiple

一個mask遮罩，用於控制按鈕哪些區域可以獲得焦點，哪些區域不響應點擊。該特性的類型決定了其如何被解釋。

Displayable

可視組件的不透明區域，可以讓按鈕獲得焦點。

True

按鈕自身用作可視組件(按鈕的非透明區域可以讓按鈕獲得焦點)。

callable

如果一個不可視組件被調用(像函數、方法或者帶有__call__方法的對象)，該該函數被使用兩個入參調用，從對應可視組件左上角算起，x和y軸的兩個偏移量。

如果使用兩個入參調用該函數，則函數返回一個可調用對象。 返回對象可以使用4個參數調用，x和y的偏移值，以及可視組件的寬度和高度。

若函數返回結果為True，可視組件獲得焦點。

None

如果該值為None，整個按鈕都可以獲得焦點。

keyboard_focus -  boolean

若為True，也是預設值，按鈕可以通過鍵盤的焦點機制獲得焦點，前提是這個按鈕本身允許獲得焦點。若為False，鍵盤焦點機制會跳過這個按鈕。(鍵盤焦點機制使用鍵盤或者類似鍵盤的設備，比如遊戲手把。)

keyboard_focus_insets -  (int, int, int, int) or None

若不是None，該項應該是一個包含4個整數的元組，表示一個矩形區域4個角能收縮的像質數。 當使用鍵盤讓組件獲取焦點時，將會用到該特性。

在有按鈕相互覆蓋的情況下，該特性會有用。處理鍵盤來控制焦點的算法，無法處理按鈕相互覆蓋的情況。 如果使用該特性提前在內部處理，就能解決類似問題。

key_events -  boolean

若為True，鍵盤生成的事件消息會傳給鍵盤的子組件。若為False，這些事件就不會向下廣播。默認樣式中，按鈕上有滑鼠懸停時該值為True，其他情況下該值為False。

將這個值設置為True可以用於廣播鍵盤事件消息至某個按鈕內的輸入框，而那個按鍵並不需要獲得焦點。

條(bar)樣式特性

條(bar)是一個左右兩邊帶有溝槽的組件，點擊後觸發滑塊在條內平移一小段距離。滑塊與左右兩端的間隔就是還允許移動的距離。

滑塊是條(bar)中允許用戶拖拽的部分。

當繪製一個條(bar)後，滑塊的陰影首先被繪製。然後是滑塊本身，最後是條(bar)的左/底邊和右/頂邊。

需要注意條(bar)的邊取決於bar_vertical特性的值。若bar_vertical為True，頂邊和底邊會實際繪製。否則，只有左邊和右邊。

bar_vertical -  boolean

若為True，縱向條(bar)。若為False，橫向條(bar)。

bar_invert -  boolean

若為True，條(bar)上滑塊對應的值顯示在右/上側；否則，顯示在左/下側。

bar_resizing -  boolean

若為True，重新調整條(bar)的尺寸。若為False，使用全尺寸渲染各條邊，然後裁剪。

left_gutter -  int

左邊溝槽尺寸，單位為像素。

right_gutter -  int

右邊溝槽尺寸，單位為像素。

top_gutter -  int

頂邊溝槽尺寸，單位為像素。

bottom_gutter -  int

底邊溝槽尺寸，單位為像素。

left_bar -  displayable

用於左邊的可視組件。

right_bar -  displayable

用於右邊的可視組件。

top_bar -  displayable

用於頂邊的可視組件。

bottom_bar -  displayable

用於底邊的可視組件。

base_bar -  displayable

單個可視組件用於left_bar/right_bar或者top_bar/bottom_bar，自動適配。(帶滑塊的情況下，還可以用作滑動條或者滑動欄。)

thumb -  displayable or None

若非None，這是一個繪製在條(bar)的各條邊空間內的可視組件。

thumb_shadow -  displayable or None

若非None，這是一個繪製在條(bar)的各條邊空間內的可視組件。

thumb_offset -  int

滑塊與條(bar)重疊部分的大小，單位為像素。如果想讓條(bar)的左右兩邊看起來不像被截斷的樣子，就把滑塊的寬度設為條(bar)寬度的一半。

mouse -  string

滑鼠樣式，用於按鈕獲得焦點時。該字串應是 config.mouse 定義的樣式之一。

unscrollable -  string or None

當無法滾動時，控制條(bar)的行為表現(如果滾動範圍設置為0，視點範圍內的可視組件小於其自身)。總共有3種可能的值：

None

正常渲染條(bar)。

"insensitive"

渲染insensitive狀態下條(bar)。這個值允許條(bar)改變自身樣式，儘管那很少使用。

"hide"

不渲染條(bar)。空間會預留給條(bar)，不會那段空間不繪製任何東西。

keyboard_focus -  boolean

若為True，也是預設值，按鈕可以通過鍵盤的焦點機制獲得焦點，前提是這個按鈕本身允許獲得焦點。若為False，鍵盤焦點機制會跳過這個按鈕。(鍵盤焦點機制使用鍵盤或者類似鍵盤的設備，比如遊戲手把。)

方框(box)樣式特性

這些樣式特性用於橫向和縱向的方塊布局。

spacing -  int

方塊內成員之間的空間距離，單位為像素。

first_spacing -  int

若非None，表示，方框內的第一個跟第二個成員間的空間距離，單位為像素。該值覆蓋spacing特性。

box_reverse -  boolean

若為True，方塊內物品位置將被翻轉。hbox左右鏡像翻轉，vbox上線鏡像翻轉。默認情況下的值為False。

box_wrap -  boolean

若為True，當到達方塊最後一行或列時會發生扭轉(warp)。若為False，會在每一行的結尾擴展。

box_wrap_spacing -  int

當box_wrap為True時，box_wrap_spacing項用於指定被wrap的行或列的間距。 (行間距就是被warp的hbox在垂直方向空間，列間距就是被warp的vbox在水平方向的空間。)

order_reverse -  boolean

若為False，也就是預設值，方框內元素會從前往後繪製，第一個元素下面是第二個元素。若為True，順序會倒過來，第一個元素會在方框最底層。

網格(grid)樣式特性

這些特性用於網格(grid)和虛擬樣機網格(vpgrid)可視組件中。

spacing -  int

各網格單元之間的空間，單位為像素。

xspacing -  int or None

各網格單元之間水平方向的空間，單位為像素。當這個值不是None時，優先度比spacing特性高。

yspacing -  int or None

各網格單元之間垂直方向的空間，單位為像素。當這個值不是None時，優先度比spacing特性高。

固定布局的樣式特性

這些特性用於固定布局(layout)。

fit_first -  boolean or "width" or "height"

若為True，固定寬度的布局所有單元尺寸都會嚴格等於第一個單元內元素的尺寸。如果是“width”，只有單元格寬度能改變(固定布局會在垂直方向上填滿界面)。類似的，“height”值能改變單元跟高度。

由於 fit_first 的原因，子組件的位置將被忽略。

xfit -  boolean

若為True，固定布局的尺寸在水平方向會嚴格匹配最右側子組件的尺寸。

yfit -  boolean

若為True，固定布局的尺寸在垂直方向會嚴格匹配最底部子組件的尺寸。

提供了以上特性時，固定布局的子組件們會首先根據指定整塊區域。一旦獲得子組件的尺寸和位置，再根據固定布局的尺寸應該對應的特性。

邊距樣式特性

邊距(margin)樣式特性用於增加某些可視組件周圍的透明空間。可用於：window、frame、button、grid和vpgrid。

left_margin -  int

可視組件左邊距，單位為像素。

right_margin -  int

可視組件右邊距，單位為像素。

xmargin -  int

等效於，將左邊距和右邊距設置為相同的值。

top_margin -  int

可視組件上邊距，單位為像素。

bottom_margin -  int

可視組件下邊距，單位為像素。

ymargin -  int

等效於，將上邊距和下邊距設置為相同的值。

margin -  tuple

該值可以是一個2元元組，分別設置xmargin和ymargin。 該值也可以是一個4元元組，分別設置left_margin、top_margin、right_margin和bottom_margin。