选择类

radiobutton 

add_radiobutton(self,pos:tuple,width,text='',choices=('choose me'),fg='#1a1a1a',bg='#f2f2f2',font=('微软雅黑',12),activefg='#3c3c3c',activebg='#e9e9e9',command=None,anchor='nw')
  • pos::位置
  • width::整体宽度
  • text::单选框文本提示
  • choices::选项（list, set, map…）
  • fg::文本和边框颜色
  • bg::选项背景色
  • font::字体
  • activefg::选中字体和边框颜色
  • activebg::选中背景颜色
  • command::回调函数，有并且仅有一个参数，即该按钮所显示的文本
  • anchor::对齐方向

绘制一个单选框。

返回值：text, choices_text_list, choices_back, funcs, uid

text::文本提示画布对象

choices_text_list::可选框的文本画布对象

choices_back::可选框的背景方框画布对象

funcs

funcs[0]|funcs.select(num)::选定一个选项

funcs[1]|funcs.disable()::禁用

funcs[2]|funcs.active()::激活

combobox 

add_combobox(self,pos:tuple,width:int=200,height:int=200,text='',content:tuple=(),fg='#1a1a1a',bg='#f8f8f8',outline='#c8c8c8',activefg='#1a1a1a',activebg='#f6f6f6',activeline='#cccccc',onfg='#5d5d5d',onbg='#f5f5f5',online='#e5e5e5',listfg='#1a1a1a',listactivefg='#191919',listactivebg='#e9e9e9',listonfg='#191919',listonbg='#ececec',listsel='#b4bbea',scrollbg='#f0f0f0',scrollcolor='#999999',scrollon='#89898b',tran='#01FF11',font=('微软雅黑',12),anchor='nw',command=None)
  • pos::位置
  • width::组合框显示区宽度
  • height::下拉框高度
  • text::组合框显示区初始文字
  • content::拥有组合框所包含的内容的元组
  • fg::组合框文本、边框颜色
  • bg::组合框、下拉框背景色
  • outline::下拉框边框颜色
  • activefg::响应鼠标文本颜色
  • activebg::响应鼠标背景色
  • activeline::响应鼠标边框颜色
  • onfg::点击时文本颜色
  • onbg::点击时背景色
  • online::点击时边框颜色
  • listfg::选项文本色
  • listactivefg::鼠标进入是文本色
  • listactivebg::鼠标进入时选项背景色
  • listonfg::鼠标点击时选项文本色
  • listonbg::鼠标点击时选项背景色
  • listsel::选中项背景色
  • scrollbg::滚动条背景色
  • scrollcolor::滚动条颜色
  • scrollon::滚动条标识颜色
  • font::字体
  • anchor::对齐方向
  • command::当某一刻选择框被点击回调的函数。该函数需要接受一个参数：该选项框的文本内容。

绘制一个组合框。

返回值：main, back, bar, funcs, uid

main::显示框文字

back::显示框背景

bar::载有选项listview控件的BasicTinUI

funcs

funcs[0]|funcs.select(num)::选定选值，第一个值是0

funcs[1]|funcs.disable(fg='#9d9d9d',bg='#f5f5f5')::禁用

funcs[2]|funcs.active()::激活

spinbox 

add_spinbox(self,pos:tuple,width=150,data=('1','2','3'),now='',fg='#1b1b1b',bg='#fefefe',line='#e5e5e5',activefg='#1a1a1a',activebg='#fafafa',onfg='#868686',onbg='#f3f3f3',boxfg='#5f5f5f',boxbg='#f9f9f9',boxactivefg='#5b5b5b',boxactivebg='#f0f0f0',font=('微软雅黑',12),anchor='nw',command=None)
  • pos::位置
  • width::宽度
  • data::可选值的内容。格式：(ele1,ele2,ele3…)
  • now::当前显示值。如果为空或不在data中，则显示第一个值
  • fg::文本颜色
  • bg::输入框背景色
  • activefg::按钮响应文本颜色
  • activebg::按钮响应背景色
  • onfg::点击时按钮文本颜色
  • onbg::点击时按钮背景色
  • boxactivefg::响应鼠标进入按钮文本颜色
  • boxactivebg:: 响应鼠标进入按钮背景色
  • boxfg:: 按钮文本颜色
  • boxbg:: 按钮背景颜色
  • font::输入框字体，同时会影响按钮字体
  • anchor::对齐方向
  • command::选值时响应的函数，必须接受一个参数，这个参数是当前选定的值

command返回值为 string:TinUIString，string为值本身，来自于 data。

string.num为值在 data中的索引，从 0开始。

绘制一个选值框。

返回值：wentry, button1, button2, back, outline, button, uid

wentry::输入框组件

button1::上调按钮

button2::下调按钮

back::背景元素

outline::边框元素

button::打开调节框的按钮

listbox 

add_listbox(self,pos:tuple,width:int=200,height:int=200,font='微软雅黑 12',data=('a','b','c'),fg='#1a1a1a',bg='#f2f2f2',activefg='#191919',activebg='#e9e9e9',onfg='#191919',onbg='#ececec',sel='#b4bbea',scrollbg='#f0f0f0',scrollcolor='#999999',scrollon='#89898b',anchor='nw',command=None)
  • pos::起始位置
  • width::列表框宽度而非框架宽度
  • height::列表框高度而非框架高度
  • font::字体
  • data::选项
  • bg::背景颜色
  • fg::文本颜色
  • activefg::鼠标进入时文本色
  • activebg::鼠标进入时背景色
  • onfg::鼠标点击时文本色
  • onbg::鼠标点击时背景色
  • sel::被选中的背景颜色
  • scrollbg::滚动条背景色
  • scrollcolor::滚动条颜色
  • scrollon::滚动条响应颜色
  • anchor::对齐方式
  • command::回调函数，必须接受一个选项参数 result
    • 这个参数来自data，使用 result.index获取该选项当前的位置，仅对触发时准确

绘制一个列表框。

返回值：box, allback, funcs, uid

box::绘制列表框功能区的BasicTinUI

allback::背景元素

funcs

funcs.add(text:str)::在尾部添加新选项

funcs.delete(index:int)::删除指定序数的元素，第一个元素序号为0

funcs.clear()::清空

radiobox 

add_radiobox(self,pos:tuple,fontfg='black',font='微软雅黑 12',fg='#8b8b8b',bg='#ededed',activefg='#898989',activebg='#e5e5e5',onfg='#3041d8',onbg='#ffffff',content:tuple=('1','','2'),padx=15,pady=10,anchor='nw',command=None)
  • pos::位置
  • fontfg::文本颜色
  • fg::标识符边框颜色
  • bg::标识符背景颜色
  • activefg::鼠标进入标识符边框颜色
  • activebg::鼠标进入标识符背景颜色
  • onfg::选定标识符边框颜色
  • onbg::选定标识符背景颜色
  • content::选择文本内容。如果为空字符串则代表换行
  • padx::水平间距
  • pady::行间距
  • anchor::对齐方向
  • command::回调函数，必须接受一个参数，所选选项的文本

绘制一个单选组控件。

返回值：boxes, funcs, uid

boxes::元素组：(标识符背景, 标识符, 文本, 背景元素)

funcs

funcs.active()::激活控件

funcs.disable(fg='#c1c1c1',bg='#f3f3f3')::禁用控件

funcs.select(index)::选中第几个参数

pivot 

add_pivot(self,pos:tuple,fg='#959595',bg='',activefg='#525252',activecolor='#5969e0',content=(('a-title','tag1'),('b-title','tag2'),'',('c-title','tag3')),font='微软雅黑 16',padx=10,pady=10,anchor='nw',command=None)
  • pos::位置
  • fg::字体颜色
  • bg::保留参数，忽略
  • activefg::字体激活颜色
  • activecolor::提示色
  • content::内容，（文本，标签）
  • font::字体
  • padx::横方向间距
  • pady::纵方向间距
  • anchor::对齐方向
  • command::响应函数，必须接受一个参数，所选选项的标签

绘制一个支点标题。

return: texts, funcs, uid

texts::[(文本,文本标签,文本uid),...]

funcs

funcs.select(index, send=False):: 选择第几个元素（包括空行，但不可选），当send=False，不会触发回调函数。

listview

[!CAUTION]

TinUI-6.2版本开始，listview内部元素使用圆角背景，由内部ui实现，圆角矩形在视图最底层，一般情况下，即便使用delete('all')，内部ui也会在下次需要展示时重新绘制背景。

add_listview(self,pos:tuple,width=300,height=300,linew=80,bg='#f3f3f3',activebg='#eaeaea',oncolor='#3041d8',scrobg='#f8f8f8',scroc='#999999',scrooc='#89898b',num=5,anchor='nw',command=None)
  • pos::位置
  • width::宽度
  • height::高度
  • linew::单元素高度
  • bg::背景色
  • activebg::响应鼠标提示色
  • oncolor::选中提示色
  • scrobg::滚动条背景色
  • scroc::滚动条颜色
  • scrooc::滚动条提示色
  • num::元素数量
  • anchor::对齐方向
  • command::选定时响应函数，需要一个参数：选中项的位次，从0开始

绘制一个列表视图。

返回值：ui, scro, items, funcs, uid

ui::列表框架BasicTinUI

scro::滚动条返回值，add_scrollbar

items::元素列表，每个元素为ui返回值，add_ui。进返回初始元素列表

funcs

funcs.getitems()获取当前所有元素列表

funcs.getui(index)获取index对应的add_ui返回值

funcs.delete(index)删除index位的UI元素

funcs.add()在末尾追加新元素，并且返回add_ui返回值

funcs.clear()清除所有元素

funcs.getsel()获取当前选中项序号，-1为未选择

funcs.select(index)选择当前index对应的项目，不会触发回调函数

treeview 

add_treeview(self,pos:tuple,fg='#1a1a1a',bg='#f3f3f3',onfg='#1a1a1a',onbg='#eaeaea',oncolor='#3041d8',signcolor='#8a8a8a',width=200,height=300,font='微软雅黑 12',content=(('one',('1','2','3')),'two',('three',('a',('b',('b1','b2','b3')),'c')),'four'),command=None)
  • pos::位置
  • fg::文本颜色
  • bg::背景色
  • onfg::选中时文本颜色
  • onbg::选中时元素背景色
  • oncolor::标识符颜色
  • signcolor::滚动条提示色
  • width::宽度
  • height::高度
  • font::字体
  • content::内容数据。(一级,一级,(一级,(二级)),一级)可嵌套
  • command::回调函数，需要一个参数：选中项id的级次从属列表

绘制一个树状图。

返回值：items, items_dict, box, uid

items::所有元素id对应的文本id、背景id，以及可能的伸缩提示文本id的字典

items_dict::所有含子级元素id对应下一级id的字典

box::作为树状图父组件的BasicTinUI

picker 

add_picker(self,pos:tuple,height=250,fg='#1b1b1b',bg='#fbfbfb',outline='#ececec',activefg='#1b1b1b',activebg='#f6f6f6',onfg='#eaecfb',onbg='#3748d9',buttonfg='#1a1a1a',buttonbg='#f9f9f9',buttonactivefg='#1a1a1a',buttonactivebg='#f3f3f3',buttononfg='#5d5d5d',buttononbg='#f5f5f5',font=('微软雅黑',10),text=(('year',60),('season',100),),data=(('2022','2023','2024'),('spring','summer','autumn','winter')),tran='#01FF11',anchor='nw',command=None)
  • pos-位置
  • height-选择框高度
  • fg-文本颜色
  • bg-背景色
  • outline-边框色
  • activefg-选择时文本颜色
  • activebg-响应鼠标背景色
  • onfg-选定时文本颜色
  • onbg-选定时背景颜色
  • buttonfg-按钮文本颜色
  • buttonbg-按钮背景颜色
  • buttonactivefg-按钮相应鼠标文本颜色
  • buttonactivebg-按钮和选项响应鼠标背景颜色
  • buttononfg-按钮点击时文本颜色
  • buttononbg-按钮点击时背景颜色
  • font-字体
  • text-文本内容，需要与 data对应。((选值文本,元素宽度),...)
  • data-选值内容，需要与 text对应
  • tran-透明处理规避颜色
  • anchor-对齐方向
  • command-响应接受函数。需要接受一个参数：所有选值列表，全被选定时触发

绘制一个滚动选值框。

返回值：picker, bar, texts, pickerbars, uid

picker::选择器所在的窗口

bar::选择器所在的BasicTinUI

texts::文本元素列表

pickerbars::元素选择BasicTinUI列表