Qt Splitter Resize

Syfte & användarintention: Det här verktyget löser problemet med att förutsäga och validera storlekar i en Qt-liknande splitter-layout med två paneler. Målgrupp är Qt-utvecklare, UI-ingenjörer och prototypmakare som behöver resonera kring panelförhållanden, minsta storlekar och responsivt beteende utan att implementera en fullständig UI. Vid utformning av resizerbara gränssnitt tillhandahåller användaren containerstorlek, orientering och begränsningar för att beräkna panelstorlekar.

Kärnlö logic & funktioner: Verktyget modellerar en tvåpanel-splitter. Obligatoriska funktioner: beräkning av vänster- och högerpanelstorlekar från containerstorleken, splittertjocklek, valfri initial uppdelning eller explicita storlekar och begränsning av resultaten till minimistorlekar. Valfria / avancerade funktioner: orientering (horisontell eller vertikal), drag-delta-simulering, automatisk anpassning till container, höger-till-vänster orientering och export av beräknade storlekar i kodsnuttar. Utdata: left_px, right_px, total_px, valid (boolean) och en rekommenderad layout-sammanfattning. Data uttrycks i px och överensstämmer med Qt-stilkonventioner.

Inmatningar & utdata: Inmatningar: container_size_px (tal), orientation ('horizontal'|'vertical'), splitter_thickness_px (tal), min_left_px (tal), min_right_px (tal), initial_split_ratio (0.0-1.0, optional), explicit_left_px (optional), explicit_right_px (optional). Utdata: left_px, right_px, total_px, valid (boolean), notes (text). Validering försäkrar att container_size_px är större än min_left_px + min_right_px + splitter_thickness och att resultaten begränsas till minimier.

Algoritmer & beräkningar: Om explicit_left_px eller explicit_right_px ges används de efter kontroll av minimikrav. Annars beräknas left = clamp(container_size_px * initial_split_ratio, min_left_px, container_size_px - min_right_px - splitter_thickness_px); right = container_size_px - splitter_thickness_px - left. Om orienteringen är vertikal tillämpas samma logik på höjden i stället för bredden. Säkerställ att left + right + splitter_thickness = container_size_px.

Felkällor & kantfall: Saknas indata eller icke-numeriska värden gör att status blir invalid. Om containern är för liten för att rymma minimikraven returneras valid=false med orsaken. Hantera icke-slutna värden och negativa tal robust. Externa data är inte tillämpligt.

Bransch/Region & lokalisering: Enheter i pixlar; följer Qt-widget-sizingssemantik och DPI-oberoende. Lokalisering begränsad till numeriska värden; inga valutaregler eller landsspecifika regler gäller.

Antaganden & undantag: Antagande om tvåpanel-splitter i Qt-liknande layout. Rendering, händelsehantering eller faktisk UI-uppdatering ingår inte. Stöd för fler än två paneler eller icke-linjär splitter-logik ingår inte.