import _tkinter

import sys

from _typeshed import FileDescriptorLike, Incomplete, MaybeNone, StrOrBytesPath

from collections.abc import Callable, Iterable, Mapping, Sequence

from tkinter.constants import *

from tkinter.font import _FontDescription

from types import GenericAlias, TracebackType

from typing import Any, ClassVar, Final, Generic, Literal, NamedTuple, Protocol, TypedDict, TypeVar, overload, type_check_only

from typing_extensions import TypeAlias, TypeVarTuple, Unpack, deprecated, disjoint_base

if sys.version_info >= (3, 11):

from enum import StrEnum

else:

from enum import Enum

__all__ = [

"TclError",

"NO",

"FALSE",

"OFF",

"YES",

"TRUE",

"ON",

"N",

"S",

"W",

"E",

"NW",

"SW",

"NE",

"SE",

"NS",

"EW",

"NSEW",

"CENTER",

"NONE",

"X",

"Y",

"BOTH",

"LEFT",

"TOP",

"RIGHT",

"BOTTOM",

"RAISED",

"SUNKEN",

"FLAT",

"RIDGE",

"GROOVE",

"SOLID",

"HORIZONTAL",

"VERTICAL",

"NUMERIC",

"CHAR",

"WORD",

"BASELINE",

"INSIDE",

"OUTSIDE",

"SEL",

"SEL_FIRST",

"SEL_LAST",

"END",

"INSERT",

"CURRENT",

"ANCHOR",

"ALL",

"NORMAL",

"DISABLED",

"ACTIVE",

"HIDDEN",

"CASCADE",

"CHECKBUTTON",

"COMMAND",

"RADIOBUTTON",

"SEPARATOR",

"SINGLE",

"BROWSE",

"MULTIPLE",

"EXTENDED",

"DOTBOX",

"UNDERLINE",

"PIESLICE",

"CHORD",

"ARC",

"FIRST",

"LAST",

"BUTT",

"PROJECTING",

"ROUND",

"BEVEL",

"MITER",

"MOVETO",

"SCROLL",

"UNITS",

"PAGES",

"TkVersion",

"TclVersion",

"READABLE",

"WRITABLE",

"EXCEPTION",

"EventType",

"Event",

"NoDefaultRoot",

"Variable",

"StringVar",

"IntVar",

"DoubleVar",

"BooleanVar",

"mainloop",

"getint",

"getdouble",

"getboolean",

"Misc",

"CallWrapper",

"XView",

"YView",

"Wm",

"Tk",

"Tcl",

"Pack",

"Place",

"Grid",

"BaseWidget",

"Widget",

"Toplevel",

"Button",

"Canvas",

"Checkbutton",

"Entry",

"Frame",

"Label",

"Listbox",

"Menu",

"Menubutton",

"Message",

"Radiobutton",

"Scale",

"Scrollbar",

"Text",

"OptionMenu",

"Image",

"PhotoImage",

"BitmapImage",

"image_names",

"image_types",

"Spinbox",

"LabelFrame",

"PanedWindow",

]

# Using anything from tkinter.font in this file means that 'import tkinter'

# seems to also load tkinter.font. That's not how it actually works, but

# unfortunately not much can be done about it. https://github.com/python/typeshed/pull/4346

TclError = _tkinter.TclError

wantobjects: int

TkVersion: Final[float]

TclVersion: Final[float]

READABLE: Final = _tkinter.READABLE

WRITABLE: Final = _tkinter.WRITABLE

EXCEPTION: Final = _tkinter.EXCEPTION

# Quick guide for figuring out which widget class to choose:

# - Misc: any widget (don't use BaseWidget because Tk doesn't inherit from BaseWidget)

# - Widget: anything that is meant to be put into another widget with e.g. pack or grid

#

# Don't trust tkinter's docstrings, because they have been created by copy/pasting from

# Tk's manual pages more than 10 years ago. Use the latest manual pages instead:

#

# $ sudo apt install tk-doc tcl-doc

# $ man 3tk label # tkinter.Label

# $ man 3tk ttk_label # tkinter.ttk.Label

# $ man 3tcl after # tkinter.Misc.after

#

# You can also read the manual pages online: https://www.tcl.tk/doc/

# manual page: Tk_GetCursor

_Cursor: TypeAlias = str | tuple[str] | tuple[str, str] | tuple[str, str, str] | tuple[str, str, str, str]

if sys.version_info >= (3, 11):

@type_check_only

class _VersionInfoTypeBase(NamedTuple):

major: int

minor: int

micro: int

releaselevel: str

serial: int

if sys.version_info >= (3, 12):

class _VersionInfoType(_VersionInfoTypeBase): ...

else:

@disjoint_base

class _VersionInfoType(_VersionInfoTypeBase): ...

if sys.version_info >= (3, 11):

class EventType(StrEnum):

Activate = "36"

ButtonPress = "4"

Button = ButtonPress

ButtonRelease = "5"

Circulate = "26"

CirculateRequest = "27"

ClientMessage = "33"

Colormap = "32"

Configure = "22"

ConfigureRequest = "23"

Create = "16"

Deactivate = "37"

Destroy = "17"

Enter = "7"

Expose = "12"

FocusIn = "9"

FocusOut = "10"

GraphicsExpose = "13"

Gravity = "24"

KeyPress = "2"

Key = "2"

KeyRelease = "3"

Keymap = "11"

Leave = "8"

Map = "19"

MapRequest = "20"

Mapping = "34"

Motion = "6"

MouseWheel = "38"

NoExpose = "14"

Property = "28"

Reparent = "21"

ResizeRequest = "25"

Selection = "31"

SelectionClear = "29"

SelectionRequest = "30"

Unmap = "18"

VirtualEvent = "35"

Visibility = "15"

else:

class EventType(str, Enum):

Activate = "36"

ButtonPress = "4"

Button = ButtonPress

ButtonRelease = "5"

Circulate = "26"

CirculateRequest = "27"

ClientMessage = "33"

Colormap = "32"

Configure = "22"

ConfigureRequest = "23"

Create = "16"

Deactivate = "37"

Destroy = "17"

Enter = "7"

Expose = "12"

FocusIn = "9"

FocusOut = "10"

GraphicsExpose = "13"

Gravity = "24"

KeyPress = "2"

Key = KeyPress

KeyRelease = "3"

Keymap = "11"

Leave = "8"

Map = "19"

MapRequest = "20"

Mapping = "34"

Motion = "6"

MouseWheel = "38"

NoExpose = "14"

Property = "28"

Reparent = "21"

ResizeRequest = "25"

Selection = "31"

SelectionClear = "29"

SelectionRequest = "30"

Unmap = "18"

VirtualEvent = "35"

Visibility = "15"

_W = TypeVar("_W", bound=Misc)

# Events considered covariant because you should never assign to event.widget.

_W_co = TypeVar("_W_co", covariant=True, bound=Misc, default=Misc)

class Event(Generic[_W_co]):

serial: int

num: int

focus: bool

height: int

width: int

keycode: int

state: int | str

time: int

x: int

y: int

x_root: int

y_root: int

char: str

send_event: bool

keysym: str

keysym_num: int

type: EventType

widget: _W_co

delta: int

if sys.version_info >= (3, 14):

def __class_getitem__(cls, item: Any, /) -> GenericAlias: ...

def NoDefaultRoot() -> None: ...

class Variable:

def __init__(self, master: Misc | None = None, value=None, name: str | None = None) -> None: ...

def set(self, value) -> None: ...

initialize = set

def get(self): ...

def trace_add(self, mode: Literal["array", "read", "write", "unset"], callback: Callable[[str, str, str], object]) -> str: ...

def trace_remove(self, mode: Literal["array", "read", "write", "unset"], cbname: str) -> None: ...

def trace_info(self) -> list[tuple[tuple[Literal["array", "read", "write", "unset"], ...], str]]: ...

if sys.version_info >= (3, 14):

@deprecated("Deprecated since Python 3.14. Use `trace_add()` instead.")

def trace(self, mode, callback) -> str: ...

@deprecated("Deprecated since Python 3.14. Use `trace_add()` instead.")

def trace_variable(self, mode, callback) -> str: ...

@deprecated("Deprecated since Python 3.14. Use `trace_remove()` instead.")

def trace_vdelete(self, mode, cbname) -> None: ...

@deprecated("Deprecated since Python 3.14. Use `trace_info()` instead.")

def trace_vinfo(self) -> list[Incomplete]: ...

else:

def trace(self, mode, callback) -> str: ...

def trace_variable(self, mode, callback) -> str: ...

def trace_vdelete(self, mode, cbname) -> None: ...

def trace_vinfo(self) -> list[Incomplete]: ...

def __eq__(self, other: object) -> bool: ...

def __del__(self) -> None: ...

__hash__: ClassVar[None] # type: ignore[assignment]

class StringVar(Variable):

def __init__(self, master: Misc | None = None, value: str | None = None, name: str | None = None) -> None: ...

def set(self, value: str) -> None: ...

initialize = set

def get(self) -> str: ...

class IntVar(Variable):

def __init__(self, master: Misc | None = None, value: int | None = None, name: str | None = None) -> None: ...

def set(self, value: int) -> None: ...

initialize = set

def get(self) -> int: ...

class DoubleVar(Variable):

def __init__(self, master: Misc | None = None, value: float | None = None, name: str | None = None) -> None: ...

def set(self, value: float) -> None: ...

initialize = set

def get(self) -> float: ...

class BooleanVar(Variable):

def __init__(self, master: Misc | None = None, value: bool | None = None, name: str | None = None) -> None: ...

def set(self, value: bool) -> None: ...

initialize = set

def get(self) -> bool: ...

def mainloop(n: int = 0) -> None: ...

getint = int

getdouble = float

def getboolean(s) -> bool: ...

_Ts = TypeVarTuple("_Ts")

@type_check_only

class _GridIndexInfo(TypedDict, total=False):

minsize: float | str

pad: float | str

uniform: str | None

weight: int

@type_check_only

class _BusyInfo(TypedDict):

cursor: _Cursor

class Misc:

master: Misc | None

tk: _tkinter.TkappType

children: dict[str, Widget]

def destroy(self) -> None: ...

def deletecommand(self, name: str) -> None: ...

def tk_strictMotif(self, boolean=None): ...

def tk_bisque(self) -> None: ...

def tk_setPalette(self, *args, **kw) -> None: ...

def wait_variable(self, name: str | Variable = "PY_VAR") -> None: ...

waitvar = wait_variable

def wait_window(self, window: Misc | None = None) -> None: ...

def wait_visibility(self, window: Misc | None = None) -> None: ...

def setvar(self, name: str = "PY_VAR", value: str = "1") -> None: ...

def getvar(self, name: str = "PY_VAR"): ...

def getint(self, s) -> int: ...

def getdouble(self, s) -> float: ...

def getboolean(self, s) -> bool: ...

def focus_set(self) -> None: ...

focus = focus_set

def focus_force(self) -> None: ...

def focus_get(self) -> Misc | None: ...

def focus_displayof(self) -> Misc | None: ...

def focus_lastfor(self) -> Misc | None: ...

def tk_focusFollowsMouse(self) -> None: ...

def tk_focusNext(self) -> Misc | None: ...

def tk_focusPrev(self) -> Misc | None: ...

# .after() can be called without the "func" argument, but it is basically never what you want.

# It behaves like time.sleep() and freezes the GUI app.

def after(self, ms: int | Literal["idle"], func: Callable[[Unpack[_Ts]], object], *args: Unpack[_Ts]) -> str: ...

# after_idle is essentially partialmethod(after, "idle")

def after_idle(self, func: Callable[[Unpack[_Ts]], object], *args: Unpack[_Ts]) -> str: ...

def after_cancel(self, id: str) -> None: ...

if sys.version_info >= (3, 13):

def after_info(self, id: str | None = None) -> tuple[str, ...]: ...

def bell(self, displayof: Literal[0] | Misc | None = 0) -> None: ...

if sys.version_info >= (3, 13):

# Supports options from `_BusyInfo``

def tk_busy_cget(self, option: Literal["cursor"]) -> _Cursor: ...

busy_cget = tk_busy_cget

def tk_busy_configure(self, cnf: Any = None, **kw: Any) -> Any: ...

tk_busy_config = tk_busy_configure

busy_configure = tk_busy_configure

busy_config = tk_busy_configure

def tk_busy_current(self, pattern: str | None = None) -> list[Misc]: ...

busy_current = tk_busy_current

def tk_busy_forget(self) -> None: ...

busy_forget = tk_busy_forget

def tk_busy_hold(self, **kw: Unpack[_BusyInfo]) -> None: ...

tk_busy = tk_busy_hold

busy_hold = tk_busy_hold

busy = tk_busy_hold

def tk_busy_status(self) -> bool: ...

busy_status = tk_busy_status

def clipboard_get(self, *, displayof: Misc = ..., type: str = ...) -> str: ...

def clipboard_clear(self, *, displayof: Misc = ...) -> None: ...

def clipboard_append(self, string: str, *, displayof: Misc = ..., format: str = ..., type: str = ...) -> None: ...

def grab_current(self): ...

def grab_release(self) -> None: ...

def grab_set(self) -> None: ...

def grab_set_global(self) -> None: ...

def grab_status(self) -> Literal["local", "global"] | None: ...

def option_add(

self, pattern, value, priority: int | Literal["widgetDefault", "startupFile", "userDefault", "interactive"] | None = None

) -> None: ...

def option_clear(self) -> None: ...

def option_get(self, name, className): ...

def option_readfile(self, fileName, priority=None) -> None: ...

def selection_clear(self, **kw) -> None: ...

def selection_get(self, **kw): ...

def selection_handle(self, command, **kw) -> None: ...

def selection_own(self, **kw) -> None: ...

def selection_own_get(self, **kw): ...

def send(self, interp, cmd, *args): ...

def lower(self, belowThis=None) -> None: ...

def tkraise(self, aboveThis=None) -> None: ...

lift = tkraise

if sys.version_info >= (3, 11):

def info_patchlevel(self) -> _VersionInfoType: ...

def winfo_atom(self, name: str, displayof: Literal[0] | Misc | None = 0) -> int: ...

def winfo_atomname(self, id: int, displayof: Literal[0] | Misc | None = 0) -> str: ...

def winfo_cells(self) -> int: ...

def winfo_children(self) -> list[Widget | Toplevel]: ...

def winfo_class(self) -> str: ...

def winfo_colormapfull(self) -> bool: ...

def winfo_containing(self, rootX: int, rootY: int, displayof: Literal[0] | Misc | None = 0) -> Misc | None: ...

def winfo_depth(self) -> int: ...

def winfo_exists(self) -> bool: ...

def winfo_fpixels(self, number: float | str) -> float: ...

def winfo_geometry(self) -> str: ...

def winfo_height(self) -> int: ...

def winfo_id(self) -> int: ...

def winfo_interps(self, displayof: Literal[0] | Misc | None = 0) -> tuple[str, ...]: ...

def winfo_ismapped(self) -> bool: ...

def winfo_manager(self) -> str: ...

def winfo_name(self) -> str: ...

def winfo_parent(self) -> str: ... # return value needs nametowidget()

def winfo_pathname(self, id: int, displayof: Literal[0] | Misc | None = 0): ...

def winfo_pixels(self, number: float | str) -> int: ...

def winfo_pointerx(self) -> int: ...

def winfo_pointerxy(self) -> tuple[int, int]: ...

def winfo_pointery(self) -> int: ...

def winfo_reqheight(self) -> int: ...

def winfo_reqwidth(self) -> int: ...

def winfo_rgb(self, color: str) -> tuple[int, int, int]: ...

def winfo_rootx(self) -> int: ...

def winfo_rooty(self) -> int: ...

def winfo_screen(self) -> str: ...

def winfo_screencells(self) -> int: ...

def winfo_screendepth(self) -> int: ...

def winfo_screenheight(self) -> int: ...

def winfo_screenmmheight(self) -> int: ...

def winfo_screenmmwidth(self) -> int: ...

def winfo_screenvisual(self) -> str: ...

def winfo_screenwidth(self) -> int: ...

def winfo_server(self) -> str: ...

def winfo_toplevel(self) -> Tk | Toplevel: ...

def winfo_viewable(self) -> bool: ...

def winfo_visual(self) -> str: ...

def winfo_visualid(self) -> str: ...

def winfo_visualsavailable(self, includeids: bool = False) -> list[tuple[str, int]]: ...

def winfo_vrootheight(self) -> int: ...

def winfo_vrootwidth(self) -> int: ...

def winfo_vrootx(self) -> int: ...

def winfo_vrooty(self) -> int: ...

def winfo_width(self) -> int: ...

def winfo_x(self) -> int: ...

def winfo_y(self) -> int: ...

def update(self) -> None: ...

def update_idletasks(self) -> None: ...

@overload

def bindtags(self, tagList: None = None) -> tuple[str, ...]: ...

@overload

def bindtags(self, tagList: list[str] | tuple[str, ...]) -> None: ...

# bind with isinstance(func, str) doesn't return anything, but all other

# binds do. The default value of func is not str.

@overload

def bind(

self,

sequence: str | None = None,

func: Callable[[Event[Misc]], object] | None = None,

add: Literal["", "+"] | bool | None = None,

) -> str: ...

@overload

def bind(self, sequence: str | None, func: str, add: Literal["", "+"] | bool | None = None) -> None: ...

@overload

def bind(self, *, func: str, add: Literal["", "+"] | bool | None = None) -> None: ...

# There's no way to know what type of widget bind_all and bind_class

# callbacks will get, so those are Misc.

@overload

def bind_all(

self,

sequence: str | None = None,

func: Callable[[Event[Misc]], object] | None = None,

add: Literal["", "+"] | bool | None = None,

) -> str: ...

@overload

def bind_all(self, sequence: str | None, func: str, add: Literal["", "+"] | bool | None = None) -> None: ...

@overload

def bind_all(self, *, func: str, add: Literal["", "+"] | bool | None = None) -> None: ...

@overload

def bind_class(

self,

className: str,

sequence: str | None = None,

func: Callable[[Event[Misc]], object] | None = None,

add: Literal["", "+"] | bool | None = None,

) -> str: ...

@overload

def bind_class(self, className: str, sequence: str | None, func: str, add: Literal["", "+"] | bool | None = None) -> None: ...

@overload

def bind_class(self, className: str, *, func: str, add: Literal["", "+"] | bool | None = None) -> None: ...

def unbind(self, sequence: str, funcid: str | None = None) -> None: ...

def unbind_all(self, sequence: str) -> None: ...

def unbind_class(self, className: str, sequence: str) -> None: ...

def mainloop(self, n: int = 0) -> None: ...

def quit(self) -> None: ...

@property

def _windowingsystem(self) -> Literal["win32", "aqua", "x11"]: ...

def nametowidget(self, name: str | Misc | _tkinter.Tcl_Obj) -> Any: ...

def register(

self, func: Callable[..., object], subst: Callable[..., Sequence[Any]] | None = None, needcleanup: int = 1

) -> str: ...

def keys(self) -> list[str]: ...

@overload

def pack_propagate(self, flag: bool) -> bool | None: ...

@overload

def pack_propagate(self) -> None: ...

propagate = pack_propagate

def grid_anchor(self, anchor: Literal["nw", "n", "ne", "w", "center", "e", "sw", "s", "se"] | None = None) -> None: ...

anchor = grid_anchor

@overload

def grid_bbox(

self, column: None = None, row: None = None, col2: None = None, row2: None = None

) -> tuple[int, int, int, int] | None: ...

@overload

def grid_bbox(self, column: int, row: int, col2: None = None, row2: None = None) -> tuple[int, int, int, int] | None: ...

@overload

def grid_bbox(self, column: int, row: int, col2: int, row2: int) -> tuple[int, int, int, int] | None: ...

bbox = grid_bbox

def grid_columnconfigure(

self,

index: int | str | list[int] | tuple[int, ...],

cnf: _GridIndexInfo = {},

*,

minsize: float | str = ...,

pad: float | str = ...,

uniform: str = ...,

weight: int = ...,

) -> _GridIndexInfo | MaybeNone: ... # can be None but annoying to check

def grid_rowconfigure(

self,

index: int | str | list[int] | tuple[int, ...],

cnf: _GridIndexInfo = {},

*,

minsize: float | str = ...,

pad: float | str = ...,

uniform: str = ...,

weight: int = ...,

) -> _GridIndexInfo | MaybeNone: ... # can be None but annoying to check

columnconfigure = grid_columnconfigure

rowconfigure = grid_rowconfigure

def grid_location(self, x: float | str, y: float | str) -> tuple[int, int]: ...

@overload

def grid_propagate(self, flag: bool) -> None: ...

@overload

def grid_propagate(self) -> bool: ...

def grid_size(self) -> tuple[int, int]: ...

size = grid_size

# Widget because Toplevel or Tk is never a slave

def pack_slaves(self) -> list[Widget]: ...

def grid_slaves(self, row: int | None = None, column: int | None = None) -> list[Widget]: ...

def place_slaves(self) -> list[Widget]: ...

slaves = pack_slaves

def event_add(self, virtual: str, *sequences: str) -> None: ...

def event_delete(self, virtual: str, *sequences: str) -> None: ...

def event_generate(

self,

sequence: str,

*,

above: Misc | int = ...,

borderwidth: float | str = ...,

button: int = ...,

count: int = ...,

data: Any = ..., # anything with usable str() value

delta: int = ...,

detail: str = ...,

focus: bool = ...,

height: float | str = ...,

keycode: int = ...,

keysym: str = ...,

mode: str = ...,

override: bool = ...,

place: Literal["PlaceOnTop", "PlaceOnBottom"] = ...,

root: Misc | int = ...,

rootx: float | str = ...,

rooty: float | str = ...,

sendevent: bool = ...,

serial: int = ...,

state: int | str = ...,

subwindow: Misc | int = ...,

time: int = ...,

warp: bool = ...,

width: float | str = ...,

when: Literal["now", "tail", "head", "mark"] = ...,

x: float | str = ...,

y: float | str = ...,

) -> None: ...

def event_info(self, virtual: str | None = None) -> tuple[str, ...]: ...

def image_names(self) -> tuple[str, ...]: ...

def image_types(self) -> tuple[str, ...]: ...

# See #4363 and #4891

def __setitem__(self, key: str, value: Any) -> None: ...

def __getitem__(self, key: str) -> Any: ...

def cget(self, key: str) -> Any: ...

def configure(self, cnf: Any = None) -> Any: ...

# TODO: config is an alias of configure, but adding that here creates

# conflict with the type of config in the subclasses. See #13149

class CallWrapper:

func: Incomplete

subst: Incomplete

widget: Incomplete

def __init__(self, func, subst, widget) -> None: ...

def __call__(self, *args): ...

class XView:

@overload

def xview(self) -> tuple[float, float]: ...

@overload

def xview(self, *args) -> None: ...

def xview_moveto(self, fraction: float) -> None: ...

@overload

def xview_scroll(self, number: int, what: Literal["units", "pages"]) -> None: ...

@overload

def xview_scroll(self, number: float | str, what: Literal["pixels"]) -> None: ...

class YView:

@overload

def yview(self) -> tuple[float, float]: ...

@overload

def yview(self, *args) -> None: ...

def yview_moveto(self, fraction: float) -> None: ...

@overload

def yview_scroll(self, number: int, what: Literal["units", "pages"]) -> None: ...

@overload

def yview_scroll(self, number: float | str, what: Literal["pixels"]) -> None: ...

if sys.platform == "darwin":

@type_check_only

class _WmAttributes(TypedDict):

alpha: float

fullscreen: bool

modified: bool

notify: bool

titlepath: str

topmost: bool

transparent: bool

type: str # Present, but not actually used on darwin

elif sys.platform == "win32":

@type_check_only

class _WmAttributes(TypedDict):

alpha: float

transparentcolor: str

disabled: bool

fullscreen: bool

toolwindow: bool

topmost: bool

else:

# X11

@type_check_only

class _WmAttributes(TypedDict):

alpha: float

topmost: bool

zoomed: bool

fullscreen: bool

type: str

class Wm:

@overload

def wm_aspect(self, minNumer: int, minDenom: int, maxNumer: int, maxDenom: int) -> None: ...

@overload

def wm_aspect(

self, minNumer: None = None, minDenom: None = None, maxNumer: None = None, maxDenom: None = None

) -> tuple[int, int, int, int] | None: ...

aspect = wm_aspect

if sys.version_info >= (3, 13):

@overload

def wm_attributes(self, *, return_python_dict: Literal[False] = False) -> tuple[Any, ...]: ...

@overload

def wm_attributes(self, *, return_python_dict: Literal[True]) -> _WmAttributes: ...

else:

@overload

def wm_attributes(self) -> tuple[Any, ...]: ...

@overload

def wm_attributes(self, option: Literal["-alpha"], /) -> float: ...

@overload

def wm_attributes(self, option: Literal["-fullscreen"], /) -> bool: ...

@overload

def wm_attributes(self, option: Literal["-topmost"], /) -> bool: ...

if sys.platform == "darwin":

@overload

def wm_attributes(self, option: Literal["-modified"], /) -> bool: ...

@overload

def wm_attributes(self, option: Literal["-notify"], /) -> bool: ...

@overload

def wm_attributes(self, option: Literal["-titlepath"], /) -> str: ...

@overload

def wm_attributes(self, option: Literal["-transparent"], /) -> bool: ...

@overload

def wm_attributes(self, option: Literal["-type"], /) -> str: ...

elif sys.platform == "win32":

@overload

def wm_attributes(self, option: Literal["-transparentcolor"], /) -> str: ...

@overload

def wm_attributes(self, option: Literal["-disabled"], /) -> bool: ...

@overload

def wm_attributes(self, option: Literal["-toolwindow"], /) -> bool: ...

else:

# X11

@overload

def wm_attributes(self, option: Literal["-zoomed"], /) -> bool: ...

@overload

def wm_attributes(self, option: Literal["-type"], /) -> str: ...

if sys.version_info >= (3, 13):

@overload

def wm_attributes(self, option: Literal["alpha"], /) -> float: ...

@overload

def wm_attributes(self, option: Literal["fullscreen"], /) -> bool: ...

@overload

def wm_attributes(self, option: Literal["topmost"], /) -> bool: ...

if sys.platform == "darwin":

@overload

def wm_attributes(self, option: Literal["modified"], /) -> bool: ...

@overload

def wm_attributes(self, option: Literal["notify"], /) -> bool: ...

@overload

def wm_attributes(self, option: Literal["titlepath"], /) -> str: ...

@overload

def wm_attributes(self, option: Literal["transparent"], /) -> bool: ...

@overload

def wm_attributes(self, option: Literal["type"], /) -> str: ...

elif sys.platform == "win32":

@overload

def wm_attributes(self, option: Literal["transparentcolor"], /) -> str: ...

@overload

def wm_attributes(self, option: Literal["disabled"], /) -> bool: ...

@overload

def wm_attributes(self, option: Literal["toolwindow"], /) -> bool: ...

else:

# X11

@overload

def wm_attributes(self, option: Literal["zoomed"], /) -> bool: ...

@overload

def wm_attributes(self, option: Literal["type"], /) -> str: ...

@overload

def wm_attributes(self, option: str, /): ...

@overload

def wm_attributes(self, option: Literal["-alpha"], value: float, /) -> Literal[""]: ...

@overload

def wm_attributes(self, option: Literal["-fullscreen"], value: bool, /) -> Literal[""]: ...

@overload

def wm_attributes(self, option: Literal["-topmost"], value: bool, /) -> Literal[""]: ...

if sys.platform == "darwin":

@overload

def wm_attributes(self, option: Literal["-modified"], value: bool, /) -> Literal[""]: ...

@overload

def wm_attributes(self, option: Literal["-notify"], value: bool, /) -> Literal[""]: ...

@overload

def wm_attributes(self, option: Literal["-titlepath"], value: str, /) -> Literal[""]: ...

@overload

def wm_attributes(self, option: Literal["-transparent"], value: bool, /) -> Literal[""]: ...

elif sys.platform == "win32":

@overload

def wm_attributes(self, option: Literal["-transparentcolor"], value: str, /) -> Literal[""]: ...

@overload

def wm_attributes(self, option: Literal["-disabled"], value: bool, /) -> Literal[""]: ...

@overload

def wm_attributes(self, option: Literal["-toolwindow"], value: bool, /) -> Literal[""]: ...

else:

# X11

@overload

def wm_attributes(self, option: Literal["-zoomed"], value: bool, /) -> Literal[""]: ...

@overload

def wm_attributes(self, option: Literal["-type"], value: str, /) -> Literal[""]: ...

@overload

def wm_attributes(self, option: str, value, /, *__other_option_value_pairs: Any) -> Literal[""]: ...

if sys.version_info >= (3, 13):

if sys.platform == "darwin":

@overload

def wm_attributes(

self,

*,

alpha: float = ...,

fullscreen: bool = ...,

modified: bool = ...,

notify: bool = ...,

titlepath: str = ...,

topmost: bool = ...,

transparent: bool = ...,

) -> None: ...

elif sys.platform == "win32":

@overload

def wm_attributes(

self,

*,

alpha: float = ...,

transparentcolor: str = ...,

disabled: bool = ...,

fullscreen: bool = ...,

toolwindow: bool = ...,

topmost: bool = ...,

) -> None: ...

else:

# X11

@overload

def wm_attributes(

self, *, alpha: float = ..., topmost: bool = ..., zoomed: bool = ..., fullscreen: bool = ..., type: str = ...

) -> None: ...

attributes = wm_attributes

def wm_client(self, name: str | None = None) -> str: ...

client = wm_client

@overload

def wm_colormapwindows(self) -> list[Misc]: ...

@overload

def wm_colormapwindows(self, wlist: list[Misc] | tuple[Misc, ...], /) -> None: ...

@overload

def wm_colormapwindows(self, first_wlist_item: Misc, /, *other_wlist_items: Misc) -> None: ...

colormapwindows = wm_colormapwindows

def wm_command(self, value: str | None = None) -> str: ...

command = wm_command

# Some of these always return empty string, but return type is set to None to prevent accidentally using it

def wm_deiconify(self) -> None: ...

deiconify = wm_deiconify

def wm_focusmodel(self, model: Literal["active", "passive"] | None = None) -> Literal["active", "passive", ""]: ...

focusmodel = wm_focusmodel

def wm_forget(self, window: Wm) -> None: ...

forget = wm_forget

def wm_frame(self) -> str: ...

frame = wm_frame

@overload

def wm_geometry(self, newGeometry: None = None) -> str: ...

@overload

def wm_geometry(self, newGeometry: str) -> None: ...

geometry = wm_geometry

def wm_grid(self, baseWidth=None, baseHeight=None, widthInc=None, heightInc=None): ...

grid = wm_grid

def wm_group(self, pathName=None): ...

group = wm_group

def wm_iconbitmap(self, bitmap=None, default=None): ...

iconbitmap = wm_iconbitmap

def wm_iconify(self) -> None: ...

iconify = wm_iconify

def wm_iconmask(self, bitmap=None): ...

iconmask = wm_iconmask

def wm_iconname(self, newName=None) -> str: ...

iconname = wm_iconname

def wm_iconphoto(self, default: bool, image1: _PhotoImageLike | str, /, *args: _PhotoImageLike | str) -> None: ...

iconphoto = wm_iconphoto

def wm_iconposition(self, x: int | None = None, y: int | None = None) -> tuple[int, int] | None: ...

iconposition = wm_iconposition

def wm_iconwindow(self, pathName=None): ...

iconwindow = wm_iconwindow

def wm_manage(self, widget) -> None: ...

manage = wm_manage

@overload

def wm_maxsize(self, width: None = None, height: None = None) -> tuple[int, int]: ...

@overload

def wm_maxsize(self, width: int, height: int) -> None: ...

maxsize = wm_maxsize

@overload

def wm_minsize(self, width: None = None, height: None = None) -> tuple[int, int]: ...

@overload

def wm_minsize(self, width: int, height: int) -> None: ...

minsize = wm_minsize

@overload

def wm_overrideredirect(self, boolean: None = None) -> bool | None: ... # returns True or None

@overload

def wm_overrideredirect(self, boolean: bool) -> None: ...

overrideredirect = wm_overrideredirect

def wm_positionfrom(self, who: Literal["program", "user"] | None = None) -> Literal["", "program", "user"]: ...

positionfrom = wm_positionfrom

@overload

def wm_protocol(self, name: str, func: Callable[[], object] | str) -> None: ...

@overload

def wm_protocol(self, name: str, func: None = None) -> str: ...

@overload

def wm_protocol(self, name: None = None, func: None = None) -> tuple[str, ...]: ...

protocol = wm_protocol

@overload

def wm_resizable(self, width: None = None, height: None = None) -> tuple[bool, bool]: ...

@overload

def wm_resizable(self, width: bool, height: bool) -> None: ...

resizable = wm_resizable

def wm_sizefrom(self, who: Literal["program", "user"] | None = None) -> Literal["", "program", "user"]: ...

sizefrom = wm_sizefrom

@overload

def wm_state(self, newstate: None = None) -> str: ...

@overload

def wm_state(self, newstate: str) -> None: ...

state = wm_state

@overload

def wm_title(self, string: None = None) -> str: ...

@overload

def wm_title(self, string: str) -> None: ...

title = wm_title

@overload

def wm_transient(self, master: None = None) -> _tkinter.Tcl_Obj: ...

@overload

def wm_transient(self, master: Wm | _tkinter.Tcl_Obj) -> None: ...

transient = wm_transient

def wm_withdraw(self) -> None: ...

withdraw = wm_withdraw

class Tk(Misc, Wm):

master: None

def __init__(

# Make sure to keep in sync with other functions that use the same

# args.

# use `git grep screenName` to find them

self,

screenName: str | None = None,

baseName: str | None = None,

className: str = "Tk",

useTk: bool = True,

sync: bool = False,

use: str | None = None,

) -> None: ...

# Keep this in sync with ttktheme.ThemedTk. See issue #13858

@overload

def configure(

self,

cnf: dict[str, Any] | None = None,

*,

background: str = ...,

bd: float | str = ...,

bg: str = ...,

border: float | str = ...,

borderwidth: float | str = ...,

cursor: _Cursor = ...,

height: float | str = ...,

highlightbackground: str = ...,

highlightcolor: str = ...,

highlightthickness: float | str = ...,

menu: Menu = ...,

padx: float | str = ...,

pady: float | str = ...,

relief: Literal["raised", "sunken", "flat", "ridge", "solid", "groove"] = ...,

takefocus: bool | Literal[0, 1, ""] | Callable[[str], bool | None] = ...,

width: float | str = ...,

) -> dict[str, tuple[str, str, str, Any, Any]] | None: ...

@overload

def configure(self, cnf: str) -> tuple[str, str, str, Any, Any]: ...