5 - 基础控件¶

|- 5.1-文字 draw_text¶

语法：控件对象名 = GUI对象.draw_text(x, y, w, text, color, origin, onclick, font_family,font_size)

**返回值：**文字对象
输入参数：
- x : 横坐标
- y : 纵坐标
- w : 长度，如果超出长度则自动换行，此参数可省略。
- text ：要显示的文字
- color : 文字颜色
- origin : 对齐位置，默认左上角
- onclick : 当被点击时触发的回调函数
- font_family : 指定字体
- font_size : 文字大小
用法举例（代码）：

import time
from unihiker import GUI   #导入包
gui=GUI()  #实例化GUI类
def info_text_on_click():
	print("文字被点击")

info_text = gui.draw_text(x=120, y=320, text='你好',origin='bottom' ,onclick=info_text_on_click)

info_text2 = gui.draw_text(x=0, y=100, text='1234567890')
info_text3 = gui.draw_text(x=0, y=150, w=50, text='1234567890')#换行演示

# 加载自己下载的字库文件,输入参数为本地字库文件所在路径
# 字库下载参考网站：https://www.fontspace.com/category/led
#font_family = gui.load_font('Segment7-4Gml.otf') 
#gui.draw_text(x=20, y=80, text='13:11', font_size=40, font_family=font_family) #使用字库显示

while True:
    #增加等待，防止程序退出和卡住
    time.sleep(1)

用法举例（图形化）：

unihiker库的画图控件均使用对象方式更新，因此需要给每个控件定一个对象名字，后续使用对象名调整功能。

效果截图：

|- 5.2-数码管字体 draw_digit¶

语法：控件对象名 = GUI对象.draw_digit(x, y, text, color, origin, onclick, font_size)

**返回值：**数码管对象
输入参数：
- x : 横坐标
- y : 纵坐标
- text ：要显示的文字
- color : 文字颜色
- origin : 对齐位置，默认左上角
- onclick : 当被点击时触发的回调函数
- font_size : 文字大小
用法举例：

from unihiker import GUI   #导入包
gui=GUI()  #实例化GUI类

gui.draw_digit(x=120, y=160, text='2022-02-01', origin = "center",color="red",font_size=25)#数码管字体显示

import time
while True:
    #增加等待，防止程序退出和卡住
    time.sleep(1)

自定义字体的方法：[教程]如何使用第三方字库显示点阵风格文字？

|- 5.3-图片 draw_image¶

语法：控件对象名 = GUI对象.draw_image(x, y, w, h, image,origin,onclick)

**返回值：**图片对象
输入参数：
- x : 横坐标
- y : 纵坐标
- w : 图片的宽度。按照长宽最小边等比例缩放，可省略，宽高参数都省略则保持原图分辨率。
- h : 图片的高度。按照长宽最小边等比例缩放，可省略，宽高参数都省略则保持原图分辨率。
- image : 图片源，可以传入路径或image对象
- origin : 对齐位置，默认左上角
- onclick : 当被点击时触发的回调函数
用法举例：

from unihiker import GUI   #导入包
gui=GUI()  #实例化GUI类
# 传入图片文件路径的方式
img_image = gui.draw_image(x=120, y=0, w=80, h=50,  image='logo.png', origin='center', onclick=lambda: print("image clicked"))
img_image2 = gui.draw_image(x=0, y=100, image='logo.png')
# 传入图片对象的方式
from PIL import Image
img_image3 = gui.draw_image(x=10, y=200, image= Image.open('logo.png'))

import time
while True:
    #增加等待，防止程序退出和卡住
    time.sleep(1)

用法举例（图形化）：

注：需要将图片源拖入项目中的文件处。

|- 5.3-表情 draw_emoji¶

语法：控件对象名 = GUI对象.draw_emoji(x, y, w, h, emoji,duration,origin,onclick)

**返回值：**表情对象
输入参数：
- x : 横坐标
- y : 纵坐标
- w : 表情的宽度。按照长宽最小边等比例缩放，可省略，宽高参数都省略则保持原图分辨率。
- h : 表情的高度。按照长宽最小边等比例缩放，可省略，宽高参数都省略则保持原图分辨率。
- emoji : 表情名，可以使用内置表情（Angry,Nerve,Peace,Shock,Sleep,Smile,Sweat,Think,Wink）也可以传入路径表情图片（按照名字-序号.png顺序）
- duration : 图片切换间隔时间
- origin : 对齐位置，默认左上角
- onclick : 当被点击时触发的回调函数
用法举例：

from unihiker import GUI   #导入包
import time
gui=GUI()  #实例化GUI类
# 传入图片文件路径的方式
emj1 = gui.draw_emoji(x=0, y=0, w=100, h=100, emoji="Wink", duration=0.1, onclick=lambda:cb("emojis clicked"))
emj2 = gui.draw_emoji(x=120, y=200, w=100, h=100, emoji="Smile", duration=1,origin="center" , onclick=lambda:cb("emojis clicked"))
while True:
    time.sleep(1) #等待防止程序退出看不到效果

|- 5.4-按钮 add_button¶

注：按钮控件为特殊控件，一直显示在最顶层。
注：unihiker库中图片及填充矩形也具有onclick事件，因此如需更好看的效果可以使用其他控件实现。

语法：控件对象名 = GUI对象.add_button(x, y, w, h, text, origin, state,onclick)

**返回值：**按钮对象
输入参数：
- x : 横坐标
- y : 纵坐标
- w : 图片的宽度
- h : 图片的高度
- text : 按钮上显示的文字
- origin : 对齐位置，默认左上角
- state : 按钮使能，设置为 disabled 时按钮无法点击，设置为 normal 则回复到正常可点击状态
- onclick : 当被点击时触发的回调函数。注意函数中勿执行需要长时间运行的程序，否则会卡住按钮，可以启动一个新的线程来执行需要耗费较长时间的程序。
用法举例：

from unihiker import GUI   #导入包
gui=GUI()  #实例化GUI类
gui.add_button(x=120, y=110, w=100, h=30, text="按钮", origin='center', onclick=lambda: print("button clicked"))
gui.add_button(x=120, y=210, w=100, h=30, text="按钮", origin='center', onclick=lambda: print("button clicked"),state="disabled")

import time
while True:
    #增加等待，防止程序退出和卡住
    time.sleep(1)

用法举例（图形化）：

|- 5.5-时钟 draw_clock¶

语法：控件对象名 = GUI对象.draw_clock(x, y, r, h, m, s, color, onclick)

**返回值：**时钟对象
输入参数：
- x : 横坐标
- y : 纵坐标
- r : 半径
- h : 时
- m : 分
- s : 秒
- color : 边框颜色
- origin : 对齐位置，默认左上角
- onclick : 当被点击时触发的回调函数
用法举例：

from unihiker import GUI   #导入包
gui=GUI()  #实例化GUI类
gui.draw_clock(x=120, y=160, r=80, h=10, m=8, s=0, color="#f8ad30", onclick=lambda: print("clock clicked"))

import time
while True:
    #增加等待，防止程序退出和卡住
    time.sleep(1)

|- 5.6-填充时钟 fill_clock¶

语法：控件对象名 = GUI对象.fill_clock(x, y, r, h, m, s, color,fill,style, onclick)

**返回值：**填充时钟对象
输入参数：
- x : 横坐标，默认中心对齐
- y : 纵坐标
- r : 半径
- h : 时
- m : 分
- s : 秒
- color : 边框颜色
- fill : 填充颜色
- style : 预设模式，当前仅有两种，dark和light
- onclick : 当被点击时触发的回调函数
用法举例：

from unihiker import GUI   #导入包
gui=GUI()  #实例化GUI类
gui.fill_clock(x=120, y=100, r=60, h=3, m=4, s=5, color=(255, 255, 255), fill="#57b5ff", onclick=lambda: print("clock1 clicked"))
gui.fill_clock(x=120, y=230, r=60, h=6, m=7, s=8, style='dark', onclick=lambda: print("clock2 clicked"))

import time
while True:
    #增加等待，防止程序退出和卡住
    time.sleep(1)

|- 5.7-二维码 draw_qr_code¶

语法：控件对象名 = GUI对象.draw_qr_code(x, y, w, text, origin, onclick)

**返回值：**二维码对象
输入参数：
- x : 横坐标
- y : 纵坐标
- w : 二维码的边长
- text : 二维码扫描后得到的内容
- origin : 对齐位置，默认左上角
- onclick : 当被点击时触发的回调函数
用法举例：

from unihiker import GUI   #导入包
gui=GUI()  #实例化GUI类
gui.draw_qr_code(x=100, y=200, w=100, text="https://unihiker.com", origin ="center",onclick=lambda:print("qr clicked"))

import time
while True:
    #增加等待，防止程序退出和卡住
    time.sleep(1)