框架类
labelframe
add_labelframe(self,widgets:tuple=(),title='',font='微软雅黑 10',fg='#A8A8A8',bg='')
- widgets::需要标题框囊括的画布对象
- title::标题
- font::字体
- fg::边框及标题颜色
- bg::背景色
绘制一个标题框,以包含所制定的所有画布对象。
返回值:label, back, outline, uid
label::标题文本
back::背景元素
outline::边框元素
back
add_back(self,pos:tuple,uids:tuple=(),fg='',bg='',linew=0)
- pos::起始位置,可用(0,0)忽略
- uids::包含的所有画布对象,优先考虑该参数,若只有一个元素,使用
(id,)
表示 - fg::边框颜色
- bg::背景色
- linew::边框宽度
绘制一个背景框或间隔框,优先考虑 uids
参数。
返回值:back
效果见tooltip控件中绑定的label控件背景。
canvas
[!WARNING]
TinUI-6.0弃用但未删除,你可以在
TinUI.py
以及样式配置文件中取消注释。其他功可能受限。
add_canvas(self,pos:tuple,width:int=200,height:int=200,bg='white',outline='#808080',scrollbg='#f0f0f0',scrollcolor='#999999',scrollon='#89898b',linew=1,scrollbar=False,anchor='nw')
- pos::位置
- width::宽度
- height::高度
- bg::背景颜色
- outline::边框颜色
- scrollbg::滚动条背景色
- scrollcolor::滚动条颜色
- scrollon::滚动条响应颜色
- linew::边框宽度
- scrollbar::是否添加滚动条
- anchor::对齐方位
绘制一个画布。
返回值:canvas, re_scrollregion, uid
canvas::画布组件
re_scrollregion::刷新滚动范围函数,默认为“all”
ui
add_ui(self,pos:tuple,width:int=200,height:int=200,bg='white',scrollbg='#f0f0f0',scrollcolor='#999999',scrollon='#89898b',scrollbar=False,region='man',anchor='nw')
- pos::位置
- width::宽度
- height::高度
- bg::背景颜色
- scrollbg::滚动条背景色
- scrollcolor::滚动条颜色
- scrollon::滚动条响应颜色
- scrollbar::是否添加滚动条
- region::范围控制,手动“man”或自动“auto”
- anchor::对齐方位
添加一个内嵌BasicTinUI。
返回值:ui, re_scrollregion, ui_xml, uid
ui::BasicTinUI类
re_scrollregion::刷新滚动范围,如果
region
参数为“auto”可忽略ui_xml::该BasicTinUI类的TinUIXml绑定
pipspager
add_pipspager(self,pos:tuple,width:int=200,height:int=200,bg='#f3f3f3',fg='#898989',buttonfg='#8a8a8a',buttonbg='#f9f9f9',activefg='#5f5f5f',activebg='#f9f9f9',buttononfg='#5f5f5f',buttononbg='#f9f9f9',num:int=2)
- pos::位置
- width::主视图宽度
- height::主视图高度
- bg::背景颜色
- fg::导航栏前景色
- buttonfg:: 按钮文本颜色
- buttonbg::按钮背景颜色
- activefg::响应时按钮文本颜色
- activebg::响应时按钮背景色
- buttononfg:: 点击时按钮文本颜色
- buttononbg:: 点击时按钮背景颜色
- num::视图数量
绘制一个横向翻页视图。
返回值:: uilist, dotlist, move_to, uid
uilist::视图列表结构。
[(id-1,tinui-1,tinuixml-1),...]
dotlist::导航栏列表结构。
[dot_id-1,...]
move_to::需要一个数字参数num,转到第num个视图,第一个视图num为0
notebook
add_notebook(self,pos:tuple,width:int=400,height:int=400,color='#f3f3f3',fg='#5d5d5d',bg='#f3f3f3',activefg='#595959',activebg='#e9e9e9',onfg='#1a1a1a',onbg='#f9f9f9',scrollbg='#f0f0f0',scrollcolor='#999999',scrollon='#89898b',anchor='nw')
- pos::位置
- width::页面宽度
- height::页面高度
- color::视图背景色
- fg::文本颜色
- bg::标签栏标签颜色
- activefg::鼠标进入时提示色
- activebg::鼠标进入时提示色
- onfg::被点击时激活色
- onbg::被点击时激活色
- scrollbg::滚动条背景色
- scrollcolor::滚动条标识符颜色
- scrollon::滚动条响应时颜色
- anchor::对齐方向
绘制一个标签栏视图。
return: tbu, scro, back, notebook, uid
tbu::标签栏BasicTinUI
scro::滚动条TinUI返回值
back::背景元素
notebook::TinUINum函数结构体
notebook.addpage(title,flag=None,scrollbar=False,cancancel=True)->flag
title
标签栏标签标题
flag
标识符,如果没有给定,会自动生成并返回
scrollbar
是否使用TinUI,默认BasicTinUI
cancancel
该页面是否能被删除notebook.showpage(flag)
flag
需要显示的页面的标识符notebook.deletepage(flag)
flag
需要删除的页面的标识符notebook.getuis(flag)->(tinui,uixml,uiid)
flag
页面标识符。返回TinUI组件、TinUIXml绑定、组件的画布对象notebook.gettitles(flag)->(title,cb,bu)
flag
页面标识符。返回标题tbu对象、删除键tbu对象、标签tbu对象notebook.getvdic()->vdict
返回页面字典
notebook.gettbdict()->tbdict
返回标签栏字典
notebook.cannew(can=False,newfunc=None)
can
是否响应&显示新界面按钮
newfunc
响应函数,如果为None则不执行notebook.newtitle(flag,title_text=’’)
flag
需要更换标题的页面的标识符
title_text
新标题文本
expander
add_expander(self,pos:tuple,title='expand content',tfg='black',tbg='#fbfbfb',bg='#f4f4f4',sep='#e5e5e5',buttonfg='#1b1b1b',buttonbg='#fbfbfb',buttonline='#fbfbfb',activefg='#1a1a1a',activebg='#f2f2f2',activeline='#f2f2f2',onfg='#1a1a1a',onbg='#f5f5f5',online='#f5f5f5',width=200,height=200,scrollbar=False,font='微软雅黑 12')
- pos::位置
- title::标题
- tfg::标题颜色
- tbg::标题背景色
- bg::UI颜色
- sep::大背景色、分割线颜色
- buttonfg:: 按钮文本颜色
- buttonbg:: 按钮背景颜色
- buttonline:: 按钮边框颜色
- activefg:: 按钮响应鼠标文本颜色
- activebg:: 按钮响应鼠标背景颜色
- activeline:: 按钮响应鼠标边框颜色
- onfg:: 按钮点击时文本颜色
- onbg:: 按钮点击时背景颜色
- online:: 按钮点击时边框颜色
- width::控件宽度,文本宽度为
- height::UI高度
- scrollbar::是否添加滚动条(是否使用TinUI)
- font::标题字体
绘制一个可折叠UI。
返回值:toptext, ui, ux, uid
toptext::标题文本
ui::BasicTinUI或TinUI
ux::绑定到UI的TinUIXml
waitframe
add_waitframe(self,pos:tuple,width=300,height=300,fg='#e0e0e0',bg='#ececee',anchor='nw')
- pos::位置
- width::宽度
- height::盖度
- fg::前景色
- bg::背景色
- anchor::对齐方向
绘制一个元素等待框。
return: frame, itemfg, itembg, funcs, uid
frame::元素框控件(BasicTinUI)
itemfg::标识元素1
itembg::标识元素2
funcs
funcs.start()
::开启等待覆盖
funcs.end()
::结束等待覆盖
flyout
add_flyout(self, fid, width:int=250, height:int=150, bind='<Button-1>', line='#dcdcdc', bg='#f9f9f9', anchor='n', offset:tuple[int, int]=(0,0))
- fid-需要绑定的控件元素
- width-宽度
- height-高度
- bind-绑定的事件
- line-边框颜色
- bg-背景颜色
- anchor-相对于绑定元素的浮出位置,默认在上方
- offset-浮出控件相的偏移量,偏移方向与tkinter画布坐标一致
绘制一个浮出ui控件
返回值:ui, uixml, hide, uid
ui::浮出元素BasicTinUI
uixml::绑定在ui上的TinUIXml
hide::窗口关闭函数,接受一个event参数,因此可直接绑定在浮出控件内部的按钮等关闭浮出ui的交互控件的回调