跳转至

tkflu.designs · designs 总览

设计规范（Fluent / WinUI3 的配色与几何）。

这个包把"组件长什么样"从"组件怎么工作"里拆了出来： 每个模块返回一份普通的 dict（颜色、透明度、圆角半径、边框宽度）， 组件绘制时查表取值。

因此换皮肤不需要改组件代码——改这里的返回值即可。

SegoeFluentIcons(size=9, weight='normal', *args, **kwargs)

加载一份 Segoe Fluent Icons 字体对象。

:param kwargs: 可含 master（多解释器场景必须传，理由同 :func:SegoeFont）

源代码位于： tkflu\designs\fonts\__init__.py 
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
def SegoeFluentIcons(size=9, weight="normal", *args, **kwargs):
    """加载一份 Segoe Fluent Icons 字体对象。

    :param kwargs: 可含 ``master``（多解释器场景必须传，理由同 :func:`SegoeFont`）
    """
    from _tkinter import TclError

    master = kwargs.pop("master", None)

    try:
        from tkextrafont import Font

        font = Font(
            root=master,
            file=segoefluenticons,
            size=size,
            family="Segoe Fluent Icons",
            *args,
            **kwargs
        )
    except TclError:
        try:
            from tkinter.font import Font

            font = Font(
                root=master,
                size=size,
                family="Segoe Fluent Icons",
                *args,
                **kwargs
            )
        except TclError:
            from tkinter.font import nametofont

            font = nametofont("TkDefaultFont")
            font.configure(size=size, weight=weight)
    return font

SegoeFont(size=9, weight='normal', master=None)

加载一份 Segoe UI 字体对象。

:param size: 字号 :param weight: 字重（"normal" / "bold"） :param master: 目标 Tk 控件；多解释器场景必须传。

.. warning:: 不传 master 时，tkextrafont / tkinter.font 都会把字体注册到 tkinter._default_root 所属的那个解释器上。同一个进程里开了第二个 FluWindow 时，第二个解释器并不认识这个名字，Tk 会静默退回 系统兜底字体（实测变成"宋体 18"），文字又大又难看。 组件层统一通过 :func:tkflu.defs.set_default_font 传入自己的 master。

源代码位于： tkflu\designs\fonts\__init__.py 
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
def SegoeFont(size=9, weight="normal", master=None):
    """加载一份 Segoe UI 字体对象。

    :param size: 字号
    :param weight: 字重（``"normal"`` / ``"bold"``）
    :param master: 目标 Tk 控件；**多解释器场景必须传**。

    .. warning::
       不传 ``master`` 时，``tkextrafont`` / ``tkinter.font`` 都会把字体注册到
       ``tkinter._default_root`` 所属的那个解释器上。同一个进程里开了第二个
       ``FluWindow`` 时，第二个解释器并不认识这个名字，Tk 会**静默退回**
       系统兜底字体（实测变成"宋体 18"），文字又大又难看。
       组件层统一通过 :func:`tkflu.defs.set_default_font` 传入自己的 ``master``。
    """
    from _tkinter import TclError

    try:
        from tkextrafont import Font

        font = Font(file=segoefont, size=size, family="Segoe UI", root=master)
    except TclError:
        try:
            from tkinter.font import Font

            font = Font(root=master, size=size, family="Segoe UI", weight=weight)
        except TclError:
            from tkinter.font import nametofont

            font = nametofont("TkDefaultFont")
            font.configure(size=size, weight=weight)
    return font