功能类

waitbar

waitbar1

[!WARNING]

TinUI-6.0弃用但未删除，你可以在TinUI.py以及样式配置文件中取消注释。其他功可能受限。

add_waitbar1(self,pos:tuple,fg='#0078D7',bg='',okfg='lightgreen',okbg='',bd=5,r=20,anchor='nw')
  • pos::位置
  • fg::边框颜色
  • bg::内部填充颜色
  • okfg::完成时边框颜色
  • okbg::完成时内部填充颜色
  • bd::外框宽度
  • r::半径
  • anchor::对齐方向

绘制一个扇形等待框。

返回值：waitbar1, ok, uid

waitbar1::该画布对象

ok::停止等待动画的函数。当你完成你需要等待的任务后，你可以调用此函数，停止等待动画

waitbar2

[!WARNING]

TinUI-6.0弃用但未删除，你可以在TinUI.py以及样式配置文件中取消注释。其他功可能受限。

add_waitbar2(self,pos:tuple,width:int=200,fg='#3041d8',bg='#f3f3f3',okcolor='#0f7b0f',anchor='nw')
  • pos::位置
  • width::宽度
  • fg::点状颜色
  • bg::背景颜色
  • okcolor::完成时背景填充颜色
  • anchor::对齐方向

绘制一个点状运动的等待框。

返回值：back, balls, stop, uid

back::背景矩形画布对象

balls::五个圆形画布对象的列表

stop::停止等待动画的函数。当你完成你需要等待的任务后，你可以调用此函数，停止等待动画

waitbar3 

add_waitbar3(self,pos:tuple,width:int=200,fg='#3041d8',bg='#f3f3f3',okcolor='#0f7b0f',anchor='nw')
  • pos::起始位置
  • width::宽度
  • fg::动画块颜色
  • bg::背景色
  • okcolor::完成时的颜色
  • anchor::对齐方向

绘制一个带状等待框。

返回值：back, bar, stop, uid

back::背景框

bar::动画块

stop::停止等待动画的函数。当你完成你需要等待的任务后，你可以调用此函数，停止等待动画

separate 

add_separate(self,pos:tuple,width:int,direction='x',fg='grey',anchor='nw')
  • pos::位置
  • width::长度
  • direction::方向。“x”或“y”（横向 或 纵向）
  • fg::颜色
  • anchor::对齐方向

绘制一条分割线。

返回值：separate

progressbar 

add_progressbar(self,pos:tuple,width=250,fg='#868686',bg='#334ac0',back='#f3f3f3',fontc='#79b8f8',percentage=True,text='',anchor='nw')
  • pos::位置
  • width::宽度
  • fg::边框颜色
  • bg::填充颜色
  • back::未被填充的背景颜色
  • fontc::字体颜色
  • percentage::是否显示进度文本，如果为False，则显示参数text的内容
  • text::当不显示进度文本时，进度条上的文本内容
  • anchor::对齐方向

绘制一个进度条。

返回值：back, pro_tagname, text, goto, funcs, uid

back::背景矩形边框

pro_tagname::进度框矩形所代表的tag名称

text::进度条文本

goto::改变进度：goto(num:int)，其中，num∈[0,100]。这将改变组件进度指示

funcs

funcs[0]|funcs.now_running()::恢复常规样式

funcs[1]|funcs.now_paused(fg='#868686',bg='#9d5d00',fontc='#cdcdcd')::改为暂停样式

funcs[2]|funcs.now_error(fg='#868686',bg='#c42b1c',fontc='#cdcdcd')::改为因错误暂停样式

scalebar 

add_scalebar(self,pos:tuple,width=200,fg='#4554dc',activefg='#4554dc',bg='#868686',buttonbg='#ffffff',buttonoutline='#cccccc',data=(1,2,3,4,5),start=1,anchor='nw',command=None)
  • pos::位置
  • width::长度（宽度）
  • fg::选值覆盖部分颜色
  • activefg::滑动按钮激活颜色
  • bg::选值未覆盖部分颜色
  • buttonbg::按钮背景色
  • buttonoutline::按钮边框色
  • data::选值范围
  • start::初始位置，第一个位置是0，第二个位置是1……
  • command::选值完成后调用该函数，必须接受一个参数，这个参数为data中的一个值

绘制一个滑动调节框。

返回值：name, back, button, funcs, uid

name::选值覆盖区域的tag名称

back::选值未覆盖区域的画布对象

button::选值滑动按钮

funcs

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

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

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

scrollbar 

add_scrollbar(self,pos:tuple,widget,height:int=200,direction='y',bg='#f0f0f0',color='#999999',oncolor='#89898b')
  • pos::起始位置
  • widget::绑定滑动的组件，Text、Canvas、Treeview、Listbox等
  • height::长度
  • direction::方向，x或y，大小写无关
  • bg::背景色
  • color::滚动条闲置颜色
  • oncolor::滚动条激活颜色

为显示区域可变的组件绘制一个滚动条。

返回值：top, bottom, back, sc, uid

top::上（左）标识

bottom::下（右）标识

back::背景

sc::滚动块

ratingbar 

add_ratingbar(self,pos:tuple,fg='#585858',bg='#f3f3f3',onfg='#3041d8',onbg='#3041d8',size=12,num:int=5,linew:int=10,command=None)
  • pos::位置
  • fg::边框颜色
  • bg::星级色
  • onfg::激活时星级边框
  • onbg::激活时星级色
  • size::星级字符大小
  • num::总共的星级数量
  • linew::每一行有多少的星级
  • command::回调函数，必须接受一个参数，星级个数（1~…）

绘制一个评星级控件。

返回值：bars, back, funcs, uid

bars::评星级元素列表

back::矩形边框

funcs

funcs.setrate(p:int)::选择评级

当只选定一个星级，再次选择第一个星级时，取消选择，command个数为0

swipecontrol

[!WARNING]

TinUI-6.0弃用但未删除，你可以在TinUI.py以及样式配置文件中取消注释。其他功可能受限。

add_swipecontrol(self,pos:tuple,text:str='',height=50,width=400,fg='#1a1a1a',bg='#f3f3f3',line='#fbfbfb',data:dict={'left':({'text':'OK','fg':'#202020','bg':'#bcbcbc','command':print},),'right':({'text':'CLOSE'},)},font=('微软雅黑',12),anchor='nw')

  • pos-位置

  • text-文本

  • height-高度

  • width-宽度

  • fg-文本颜色

  • bg-背景色

  • line-边框颜色

  • data-滑动操作元素参数

    data结构：

    {
 'left':({
     'text':'文本',
     'fg':'文本颜色',
     'bg':'背景颜色',
 },
         ...,
        ),
 'right':({
     'text':'文本',
 },
          ...,
 )
}

    其中，字典键值 left表示往右滑动显示的左边元素，right表示往左滑动显示的右边元素。两者皆可选。 一侧元素以一个数组表示，一个及以上，不超过六个。每个元素以字典表示，文本必选，颜色有默认值。

  • font-字体

  • anchor-对齐方向

绘制一个滑动控件。

返回值：back, backitem

back::容器BasicTinUI

backitem::控件的画布元素

def add_breadcrumb(self,pos:tuple,font='微软雅黑 12',fg='#000000',bg='#ffffff',activefg='#5c5c5c',root='HOME',command=None,anchor='nw')

pos-位置

font-字体

fg-文本颜色

bg-背景色

activefg-响应鼠标文本颜色

root-根目录名称

command-回调函数，接收以根目录id开头到点击栏目文本id的元素列表

anchor-整体对齐方向

绘制一个导航栏。

返回值：root, back, funcs, uid

root::根目录文本元素

back::背景元素

funcs

funcs.get()获取全部栏目文本元素的列表

funcs.add(text)添加一个栏目

funcs.delete()删除最后一个栏目

funcs.delete_to(cid)一直删除到指定元素（指定元素不删除）