maliang-docs/3.0/tutorials/chapter_03/1/

[giscus[bot]]

maliang-docs/3.0/tutorials/chapter_03/1/

maliang 的官方文档网站

https://xiaokang2022.github.io/maliang-docs/3.0/tutorials/chapter_03/1/

[liu9920ai]

期待

[Xiaokang2022]

此小节已经更新啦！

[BAYCKRC]

ProgressBar中* command: a function that is triggered when the progress of progress bar is 100%*并没有按照预期执行，或者是我使用不当，我没有找到相关例程
···python
class ProgressBar(virtual.Widget):
"""Progress bar widget, typically used to show the progress of an event"""

def __init__(
    self,
    master: containers.Canvas | virtual.Widget,
    position: tuple[int, int],
    size: tuple[int, int] = (400, 20),
    *,
    default: float | None = None,
    command: collections.abc.Callable[[float], typing.Any] | None = None,
    image: enhanced.PhotoImage | None = None,
    name: str | None = None,
    anchor: typing.Literal["n", "e", "w", "s", "nw", "ne", "sw", "se", "center"] = "nw",
    through: bool | None = None,
    animation: bool | None = None,
) -> None:
    """
    * `master`: parent canvas
    * `position`: position of the widget
    * `size`: size of the widget
    * `default`: default value of the widget
    * `command`: a function that is triggered when the progress of progress bar is 100%
    * `image`: image of the widget
    * `name`: name of the widget
    * `anchor`: anchor of the widget
    * `through`: wether detect another widget under the widget
    * `animation`: wether enable animation
    """
    self.value: float = 0
    virtual.Widget.__init__(
        self, master, position, size, name=name, anchor=anchor,
        through=through, animation=animation)
    if configs.Env.system == "Windows10":
        shapes.Rectangle(self, name=".out")
        shapes.Rectangle(
            self, name=".in", size=(0, self.size[1]*0.8),
            relative_position=(self.size[1]*0.1, self.size[1]*0.1))
    else:
        shapes.SemicircularRectangle(self, name=".out")
        shapes.SemicircularRectangle(
            self, name=".in", size=(self.size[1]*0.7, self.size[1]*0.7),
            relative_position=(self.size[1]*0.15, self.size[1]*0.15))
    if image is not None:
        images.StillImage(self, image=image)
    features.ProgressBarFeature(self)
    self.shapes[1].disappear()
    self.command = command
    if default is not None:
        self.set(default)

def get(self) -> float:
    """Get the progress of the progress bar"""
    return self.value

def set(self, value: float, *, callback: bool = False) -> None:
    """Set the progress of the progress bar"""
    self.value = 0 if value < 0 else 1 if value > 1 else value
    if callback and self.command is not None:
        self.command(value)
    if self.value == 0:
        return self.shapes[1].disappear()
    if not self.shapes[1].visible:
        self.shapes[1].disappear(False)

    if isinstance(self.shapes[1], shapes.Rectangle):
        self.shapes[1].coords(
            ((self.size[0]-self.size[1]*0.2) * self.value, self.shapes[1].size[1]))
    else:
        self.shapes[1].coords(
            (self.size[1]*0.7 + (self.size[0]-self.size[1] * 0.3-self.shapes[1].size[1])
             * self.value, self.shapes[1].size[1]))

    return None

···

[Xiaokang2022]

这里是参数的描述错了，后续将修复。

参数 command 需要的是一个包含一个 float 类型的参数，返回值任意的函数。在运行的时候，进度条控件会把当前的进度作为参数传递到这个函数中，而不是参数描述中说的 100% 才触发。