按钮类

button

add_button(self,pos:tuple,text:str,fg='black',bg='#CCCCCC',line='#CCCCCC',linew=3,activefg='black',activebg='#999999',activeline='#7a7a7a',font=('微软雅黑',12),minwidth=0,maxwidth=0,command=None,anchor='nw')
  • pos::位置
  • text::标题文字
  • fg::文字颜色
  • bg::按钮颜色
  • line::边框颜色
  • linew::边框宽度
  • activefg::响应鼠标的文本颜色
  • activebg::响应鼠标的按钮颜色
  • activeline::响应鼠标的边框颜色
  • font::字体名称+大小
  • minwidth::最小宽度,为0忽略
  • maxwidth::最大宽度,为0忽略
  • command::绑定的函数。该函数必须要有event参数,因为TinUI的按钮会传递点击事件的event
  • anchor::对齐方向

绘制一个方形按钮。

返回值:button_text, button_back, funcs, uid

button_text::按钮文本

button_back::按钮背景

funcs

funcs[0]|funcs.change_command(new_func)::为按钮绑定新函数

funcs[1]|funcs.disable(fg='#7a7a7a',bg='#cccccc')::禁用按钮

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


button2

add_button2(self,pos:tuple,text:str,icon=None,compound='left',fg='#1b1b1b',bg='#fbfbfb',line='#CCCCCC',linew=1,activefg='#5d5d5d',activebg='#f5f5f5',activeline='#cccccc',onfg='#5d5d5d',onbg='#f5f5f5',online='#e5e5e5',font=('微软雅黑',12),minwidth=0,maxwidth=0,command=None,anchor='nw')
  • pos::位置
  • text::标题文字
  • icon::Segoe Fluent Icons符号编号,为None忽略
  • compound::存在icon时,文本相对于符号的位置,left, right, top, bottom
  • fg::文字颜色
  • bg::按钮颜色
  • line::边框颜色
  • linew::边框宽度
  • activefg::响应鼠标的文本颜色
  • activebg::响应鼠标的按钮颜色
  • activeline::响应鼠标的边框颜色
  • onfg::鼠标点击时文本颜色
  • onbg::鼠标点击时按钮颜色
  • online::鼠标点击时边框颜色
  • font::字体名称+大小
  • minwidth::最小宽度,为0忽略
  • maxwidth::最大宽度,为0忽略
  • command::绑定的函数。该函数必须要有event参数,因为TinUI的按钮会传递点击事件的event
  • anchor::对齐方向

绘制一个圆角按钮。

返回值:button, back, outline, funcs, uid> button::按钮文本

back::背景元素

outline::边框元素

funcs

funcs.change_command(new_func)

new_func切换的新函数

funcs.disable(fg=’#9d9d9d’,bg=’#f5f5f5’)

禁用按钮

funcs.active()

激活按钮

除此之外,button2还分别延伸出accentbuttontoolbutton,完全基于button2,只是单独用作theme控件名称。


checkbutton

add_checkbutton(self,pos:tuple,text:str,fontfg='black',fg='#868686',bg='#ededed',activefg='#868686',activebg='#e5e5e5',onfg='white',onbg='#334ac0',font=('微软雅黑',12),command=None,anchor='nw')

绘制一个复选框。

返回值:check_text, check_mark, funcs, uid

check_text::复选框文本

check_mark::复选框矩形标记部件,除边框

funcs

funcs[0]|funcs.flash()::切换复选框状态

funcs[1]|funcs.on()::选定

funcs[2]|funcs.off()::取消选定

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

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


add_link(self,pos:tuple,text,url,fg='#4f62ca',activefg='red',activebg='#eaeaea',font:tuple=('微软雅黑',12),anchor='nw')
  • pos::位置
  • text::网页链接 或者 要执行的函数,函数需要接受 event参数
  • url::链接或执行函数,当command为None时执行
  • fg::文本颜色
  • activefg::响应鼠标时文本颜色
  • activebg::响应鼠标时背景颜色
  • font::字体
  • anchor::对齐方向
  • command::目标函数,必须接受一个参数,链接目标(网页链接)字符串

绘制一个链接文本,指向网页或者执行函数或者指向目标函数。

返回值:link, back, funcs, uid

link::链接文本

back::背景元素

funcs

funcs[0]|funcs.disable(fg='#b0b0b0')::禁用链接

funcs[1]|funcs.active()::恢复链接


onoff

add_onoff(self,pos:tuple,fg='#5a5a5a',bg='#ededed',activefg='#575757',activebg='#e5e5e5',onactivefg='#ffffff',onactivebg='#1975c5',onfg='#FFFFFF',onbg='#3041d8',anchor='nw',bd:int=40,command=None)
  • pos::位置
  • fg::关闭状态下的边框颜色
  • bg::关闭状态下的背景颜色
  • activefg::关闭状态下响应鼠标边框颜色
  • activebg::关闭状态下响应鼠标背景色
  • onfg::开启状态下的文本颜色
  • onbg::开启状态下的边框、背景颜色
  • onactivefg::开启状态下响应鼠标边框颜色
  • onactivebg::开启状态下响应鼠标背景色
  • anchor::对齐方向
  • bd::字体大小
  • command::当被点击时调用的函数,函数只有一个参数:布尔值。调用参数True表示开启,False表示关闭

绘制一个开关。

返回值:state, back, outline, funcs, uid

state::开关标识符

back::背景

outline::边框,与背景为同一个类型,比背景尺寸稍大

funcs

funcs.on::开启

funcs.off::关闭

funcs.active::启用

fucns.disable(dfg='#f0f0f0',dbg='#bfbfbf')::禁用


togglebutton

add_togglebutton(self,pos:tuple,text:str,fg='#1b1b1b',bg='#fbfbfb',line='#CCCCCC',linew=1,activefg='#f3f4fd',activebg='#3041d8',activeline='#5360de',font=('微软雅黑',12),command=None,anchor='nw')
  • pos::位置
  • text::文本
  • fg::文本颜色
  • bg::背景色
  • line::边框颜色
  • linew::边框宽度
  • activefg::开启状态文本颜色
  • activebg::开启状态背景色
  • activeline::开启状态边框颜色
  • font::字体
  • command::响应函数,接受一个参数:True开启,False关闭
  • anchor::对齐方向

绘制一个状态开关按钮。

返回值:button, back, outline, funcs, uid

button::文本元素

back::背景元素

outline::边框元素

funcs

funcs.change_command()::更换响应函数

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

funcs.active()::启用

funcs.on()::开启

funcs.off()::关闭


barbutton

add_barbutton(self,pos:tuple,font='微软雅黑 14',fg='#636363',bg='#f3f3f3',line='#f3f3f3',linew=0,activefg='#191919',activebg='#eaeaea',activeline='#eaeaea',onfg='#5a5a5a',onbg='#ededed',online='#ededed',sepcolor='#e6e6e6',content=(('保存','\uE74E',None),('','\uE792',None),'',('','\uE74D',None)),anchor='nw')
  • pos-位置

  • font-字体

  • fg-文本颜色

  • bg-背景颜色

  • line-边框颜色

  • linew-边框宽度

  • activefg-响应时文本颜色

  • activebg-响应时背景色

  • activeline-响应时边框颜色

  • onfg-点击时文本颜色

  • onbg-点击时背景颜色

  • online-点击时边框颜色

  • sepcolor-分割线颜色

  • content-按钮内容

    (
    ('text','Segoe Fluent Icons code',command),
    ...,
    '',#分割线
    ('text','Segoe Fluent Icons code',command),
    )
    

    文本和图标参数皆可为空,但至少应该有一个是有值的

  • anchor-对齐方向

绘制一个工具栏按钮组件。

返回值:outline, back, buttons, uid

outline::边框元素

back::背景板元素

buttons::按顺序的所有按钮列表,每一个值为 add_button2()的返回值