3.3.5. Text¶

Text 控件用於顯示文本

text_object.set_text(string, [color_r, color_g, color_b, color_a, ]align, size)¶

描述:	設置控件的文字屬性
參數:	string (string) – 需要顯示的字符串內容 [color_r, color_g, color_b, color_a] (list) – 可選參數，需要顯示的字符串的顏色，參數分別為顯示顏色 r 值、b 值、g 值，透明度，取值範圍都為 [0, 255] align (enum) – 可選參數，枚舉類型，需要顯示文字的對齊方式，詳細見表格 `align` size (int) – 顯示文字的字號大小
傳回:	無
示例:	`my_Text.set_text(120, 120, 120, 200, text_anchor.upper_left, 12)`
示例說明:	設置文字顏色的 rgb 值為（120, 120, 120），透明度為 200，字體對齊方式為頂端左對齊，字號大小為 12 號

text_object.set_text_color(r, g, b, a)¶

描述:	設置控件的文字顏色
參數:	r (int) – 文字顏色的 r 值，範圍為 [0, 255] g (int) – 文字顏色的 g 值，範圍為 [0, 255] b (int) – 文字顏色的 b 值，範圍為 [0, 255] a (int) – 文字顏色的透明度，範圍為 [0, 255]
傳回:	無
示例:	`my_Text.set_text_color(120, 120, 120, 200)`
示例說明:	設置文字的 rgb 值為（120, 120, 120），透明度為 200

text_object.set_text_align(align)¶

描述:	設置文字的對齊方式
參數:	align (enum) – 可選參數，枚舉類型，需要顯示文字的對齊方式，詳細見表格 `align`
傳回:	無
示例:	`my_Text.set_text_align(text_anchor.upper_left)`
示例說明:	設置文字的對齊方式為頂端左對齊

text_object.set_text_size(size)¶

text_object.set_border_active(active)¶

描述:	是否顯示文字邊框
參數:	active (bool) – 是否顯示文字邊框，True 表示顯示邊框，False 表示不顯示邊框
傳回:	無
示例:	`my_Text.set_border_active(True)`
示例說明:	顯示文字邊框

text_object.set_background_color(r, g, b, a)¶

描述:	設置控件的背景色
參數:	r (int) – 背景顏色的 r 值，範圍為 [0, 255] g (int) – 背景顏色的 g 值，範圍為 [0, 255] b (int) – 背景顏色的 b 值，範圍為 [0, 255] a (int) – 背景顏色的透明度，範圍為 [0, 255]
傳回:	無
示例:	`my_Text.set_background_color(200, 200, 200, 230)`
示例說明:	設置背景色的 rgb 值為 (200, 200, 200)，透明度為 230

text_object.set_background_active(active)¶

描述:	是否顯示文字背景
參數:	active (bool) – 是否顯示背景，True 表示顯示背景，False 表示不顯示背景
傳回:	無
示例:	`my_Text.set_background_active(True)`
示例說明:	顯示文字背景

text_object.append_text(content)¶

描述:	向 Text 控件中增加文本
參數:	content (string) – 需要向 Text 中增加的文本
傳回:	無
示例:	`my_Text.append_text('RoboMaster EP')`
示例說明:	向 Text 中增加的文字 `RoboMaster EP`

align¶