框架类

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的交互控件的回调