Window Properties

Window / Dialog Properties

Edit the active form's settings — geometry, behaviour, builder grid, accent — without leaving the canvas.

Open

Right-click the empty canvas → Window/Dialog Properties (last entry, label flips between Window and Dialog depending on the form). The Properties panel switches to the document.

Properties

Group	Properties
Geometry	width, height
Behaviour	resizable_x, resizable_y, frameless
Builder Grid	grid_style (none / dots / lines), grid_color, grid_spacing
Snap & Alignment	alignment_lines_enabled, snap_enabled
Main Colors	fg_color
Marker	accent_color

Description, Local Variables and Object References surface as their own groups (see below) — they're not part of the property schema.

Behaviour

Toggle	Effect
resizable_x	Allow the user to resize the window horizontally
resizable_y	Allow the user to resize the window vertically
frameless	Hide native window chrome — overrideredirect(True) on export

Builder Grid

A design-time helper that draws an alignment grid behind the canvas. Builder-only — never makes it into the exported .py. Each form carries its own style, colour and spacing.

Style	Effect
none	No grid
dots	Dot grid (default)
lines	Solid grid lines

Snap & Alignment

Both toggles are per-document — each form keeps its own preference.

Toggle	What it controls
snap_enabled	Magnetic stop when a widget edge nears another widget / margin during drag
alignment_lines_enabled	Blue guide lines drawn while dragging to show shared edges

Disable either one if you need to place a widget at an exact pixel that the snap would round away from.

Marker (accent color)

Each form gets an accent colour used in the Forms tab strip and Object Tree. None falls back to a palette-cycled colour.

Description

A free-form note about the form. The exporter writes it as a comment above the generated class X(ctk.CTk): block — useful when feeding the exported file to an AI assistant that needs to know what the screen is for.

Local Variables group

A read-only group surfaces every Variables declared on the form. Right-click → Open Variables window… jumps to the right tab and selects the entry.

Object References group

A read-only group surfaces every Object References local ref declared on the form (per-widget refs). The Window/Dialog itself can also register as a project-wide global ref via the Window-Global Reference toggle. See the dedicated page for the full picture.

---

See also — Forms and Documents · Variables · Object References · Canvas Workspace