maliang.core¶

Configurations for default environment values.

方法：

• reset –

  Reset all configuration options.

• get_default_system –

  Get the system of environment.

reset() -> None

get_default_system() -> str

Configurations for default font.

方法：

• reset –

  Reset all configuration options.

• get_default_family –

  Get the default font family.

reset() -> None

get_default_family() -> str

All Constants.

属性：

• GOLDEN_RATIO (typing.Final[float]) –

  The golden ratio, which is needed to automatically calculate the color

• PREDEFINED_EVENTS (typing.Final[tuple[str, ...]]) –

  Predefined events that can be used directly without registration. It is

• PREDEFINED_VIRTUAL_EVENTS (typing.Final[tuple[str, ...]]) –

  Predefined virtual events that can be used directly without

GOLDEN_RATIO: typing.Final[float] = math.sqrt(5) - 1 / 2

PREDEFINED_EVENTS: typing.Final[tuple[str, ...]] = (
    "<KeyPress>",
    "<KeyRelease>",
    "<Button-1>",
    "<Button-2>",
    "<Button-3>",
    "<Button-4>",
    "<Button-5>",
    "<ButtonRelease-1>",
    "<ButtonRelease-2>",
    "<ButtonRelease-3>",
    "<MouseWheel>",
    "<Motion>",
    "<B1-Motion>",
    "<B2-Motion>",
    "<B3-Motion>",
    "<Configure>",
)

PREDEFINED_VIRTUAL_EVENTS: typing.Final[tuple[str, ...]] = (
    "<<Copy>>",
    "<<Paste>>",
    "<<Cut>>",
    "<<SelectAll>>",
    "<<Redo>>",
    "<<Undo>>",
)

Bases: tkinter.Tk, Misc

Main window.

In general, there is only one main window. But after destroying it, another one can be created.

• size: size of the window
• position: position of the window, based on the upper left (nw) corner. And negative numbers are based on the bottom right (se) corner.
• title: title of the window, default value is "tk"
• icon: icon of the window, default value is the icon of tk
• **kwargs: compatible with other parameters of class tkinter.Tk

方法：

• theme –

  Change the color theme of the window

• geometry –

  Change the size and position of the window and return the current

• center –

  Center the container

• icon –

  Set the icon of the window.

• alpha –

  Set or get the transparency of the window

• topmost –

  Set or get whether the window is pinned or not

• fullscreen –

  Set or get whether the window is full-screen.

• toolwindow –

  Set or get whether the window is tool-window.

• transparentcolor –

  Set or get the penetration color of the window.

• modified –

  Set or get whether the window is modified.

• transparent –

  Set or get whether the window is transparent.

• destroy –

  Destroy this and all descendants widgets.

• at_exit –

  Set a function that will be called when the window is closed.

属性：

• ratios (tuple[float, float]) –

  Return the aspect zoom ratio of the container.

ratios: tuple[float, float]

theme(
    value: typing.Literal["light", "dark"],
    *,
    include_children: bool = True,
    include_canvases: bool = True
) -> None

geometry(
    *, size: tuple[int, int] | None = None, position: tuple[int, int] | None = None
) -> tuple[int, int, int, int] | None

center(*, refer: tkinter.Misc | None = None) -> None

icon(value: str | enhanced.PhotoImage) -> None

alpha(value: float | None = None) -> float | None

topmost(value: bool | None = True) -> bool | None

fullscreen(value: bool | None = True) -> bool | None

toolwindow(value: bool | None = True) -> bool | None

transparentcolor(value: str | None = None) -> str | None

modified(value: bool | None = None) -> bool | None

transparent(value: bool | None = None) -> bool | None

destroy() -> None

at_exit(command: collections.abc.Callable[[], typing.Any], *, ensure_destroy: bool = True) -> None

Bases: tkinter.Toplevel, Tk, Misc

Toplevel window.

It can be used as a pop-up window, or it can be customized to put anything you want to show.

• master: parent widget
• size: size of the window, default value is 960x540(px)
• position: position of the window, default value indicates random
• title: title of window, default is the same as title of master
• icon: icon of the window, default is the same as title of master
• grab: set grab for this window
• focus: whether direct input focus to this window
• **kwargs: compatible with other parameters of class tkinter.Toplevel

方法：

• destroy –

  Destroy this and all descendants widgets.

destroy() -> None

Bases: tkinter.Canvas, Misc

Main contrainer: Canvas.

The parent widget of all virtual widgets is Canvas.

• master: parent widget
• expand: the mode of expand, x is horizontal, and y is vertical
• auto_zoom: whether or not to scale its items automatically
• keep_ratio: the mode of aspect ratio, min follows the minimum value, max follows the maximum value
• free_anchor: whether the anchor point is free-floating
• auto_update: whether the theme manager update it automatically
• zoom_all_items: (Experimental) whether or not to scale its all items
• kwargs: compatible with other parameters of class tkinter.Canvas

方法：

• theme –

  Change the color theme of the Canvas and its items

• zoom –

  Resize and position the Canvas based on the relevant parameters.

• destroy –

  Destroy this and all descendants widgets.

• clear –

  Clear all things in the Canvas.

• create_text –

  Create text with coordinates x, y.

• on_motion –

  Events to move the mouse

• on_click –

  Events to active the mouse

• on_release –

  Events to release the mouse

• on_wheel –

  Events to scroll the mouse wheel

• on_key_press –

  Events for typing

• on_key_release –

  Events for typing

• register_event –

  Register a event to process.

属性：

• ratios (tuple[float, float]) –

  Return the aspect zoom ratio of the widget.

ratios: tuple[float, float]

theme(value: typing.Literal['light', 'dark']) -> None

zoom() -> None

destroy() -> None

clear() -> None

create_text(x: float, y: float, /, *args, **kwargs) -> int

on_motion(event: tkinter.Event, name: str) -> None

on_click(event: tkinter.Event, name: str) -> None

on_release(event: tkinter.Event, name: str) -> None

on_wheel(event: tkinter.Event, type_: bool | None) -> None

on_key_press(event: tkinter.Event) -> None

on_key_release(event: tkinter.Event) -> None

register_event(name: str, *, add: bool | typing.Literal['', '+'] | None = None) -> str