sync SVN r18041

This commit is contained in:
2026-08-23 11:08:56 +03:00
parent 79b08470be
commit 0027a28961
19 changed files with 369 additions and 592 deletions

View File

@@ -1,53 +1,36 @@
# Convenție UX pentru formulare VFP (preferința lui Marius, valabilă pe toate proiectele ROA*)
# Conventie UX pentru formulare VFP
Partajat între proiectele ROA* — `COMUN\` e clonat/sincronizat în fiecare aplicație ROA, e locul
corect pentru o convenție de design care nu ține de un singur proiect.
Comun tuturor proiectelor ROA*.
## Ce înseamnă in practică, pe proprietăți VFP
## Layout
- **Fiecare grup funcțional pe rândul lui**, nu înghesuit pe același `Top` cu altul fără
legătură (ex: perioadă / statistici / configurare, pe rânduri separate).
- **Spațiere vizibilă între grupuri, strânsă în interiorul unui grup** — butoane din aceeași
acțiune la 6-10px unele de altele; gap de 20-30px față de următorul grup funcțional.
- **Butoanele secundare/de configurare aliniate la marginea din dreapta a containerului**, nu
lipite imediat după textbox-ul pe care îl controlează — altfel nu se disting ca acțiune
separată de câmpul de input.
- **Acțiunea principală + oprirea ei alăturate** (ex. Transmite + Renunță), nu împrăștiate în
altă parte a rândului.
- **Un singur rând de acțiuni cât se poate** — un rând orizontal in loc de rânduri noi
dedesubt; formele rămân compacte pe verticală.
- **Caption-uri scurte, sentence case, nu ALL CAPS** — ex. "Transmite" nu "TRANSMITE". ALL
CAPS/text lung pe un buton citește ca zgomot, nu ca ierarhie.
- **Culoare = semnal, nu decor** — doar pentru acțiuni cu semnificație clară (verde =
pozitiv/transmite, roșu = oprire/pericol, albastru = navigare/link extern); restul butoanelor
rămân stilul implicit din `_baza.vcx`.
- Fiecare grup functional pe randul lui, nu inghesuit pe acelasi Top cu altul fara legatura
(ex: perioada / statistici / configurare, pe randuri separate).
- Spatiere vizibila intre grupuri, stransa in interiorul unui grup: butoane din aceeasi actiune
la 6-10px unele de altele; gap de 20-30px fata de urmatorul grup functional.
- Butoanele secundare/de configurare aliniate la marginea din dreapta a containerului, nu
lipite imediat dupa textbox-ul pe care il controleaza - altfel nu se disting ca actiune
separata de campul de input.
- Actiunea principala + oprirea ei alaturate (ex. Transmite + Renunta), nu imprastiate in alta
parte a randului.
- Un singur rand de actiuni cat se poate - un rand orizontal in loc de randuri noi dedesubt;
formele raman compacte pe verticala.
- Caption-uri scurte, sentence case, nu ALL CAPS - ex. "Transmite" nu "TRANSMITE".
- Culoare = semnal, nu decor - doar pentru actiuni cu semnificatie clara (verde =
pozitiv/transmite, rosu = oprire/pericol, albastru = navigare/link extern); restul
butoanelor raman stilul implicit din `_baza.vcx`.
## Clase de controale (confirmat de Marius, 24.07.2026, pe frm_verif_partener_anaf ROACONT)
- **Intotdeauna controale din `_baza.vcx`, nu controale native VFP** — orice grid, label,
- Intotdeauna controale din `_baza.vcx`, nu controale native VFP - orice grid, label,
textbox, checkbox etc. dintr-un formular nou se bazeaza pe clasa corespunzatoare din
`COMUN\clase\_baza.vcx`, nu pe clasa nativa Visual FoxPro. Clasele din `_baza.vcx` au
fontul default **Arial 10** — nu se suprascrie FontName pe controale (explicit: fara
Arial Narrow).
- **Butoanele de inchidere/confirmare stau in bara de titlu**, din `cmd_butoane.vcx` —
modelul Renunt/Termin (clasa de forma `frm_termin_renunt` din `_frm_child.vcx` le aduce
deja). Nu se dubleaza aceste actiuni cu butoane in corpul formei.
- **Actiunile care au corespondent `but_*` in `cmd_butoane.vcx`** (Nou/Adauga, Modifica,
Salveaza, Sterge, Verifica etc.) folosesc CU PREDILECTIE clasa dedicata `but_*`
respectiva — nu se improvizeaza un buton generic pentru o actiune care are deja clasa ei.
- **Doar actiunile FARA corespondent `but_*`** primesc butoane pe clasele `cmd_*` din
`cmd_butoane.vcx` (ex. `cmd_executa`) — nu clase improvizate si nu CommandButton nativ.
## Vocabular
Funcțional, compact, aerisit, minimalist, grupat, ușor de înțeles de utilizatori, modern —
asta e reperul calitativ pentru orice formular nou sau refacere de layout, pe orice
aplicație ROA*.
## Vezi și
- `PROMPT_cautare_vfp.md` din acest folder — cum se caută/editează cod în binarele VFP text-cache
(relevant când aplici aceste reguli prin fluxul `.sc2`/`.vc2` + write-back).
- `conventie_encoding_cp1252.md` din acest folder — capcana de corupere a diacriticelor la
editarea `.sc2`/`.vc2`; relevantă ori de câte ori editezi text-cache-ul unui formular/librărie
pentru a aplica aceste reguli de UX.
`COMUN\clase\_baza.vcx`. Fontul default e Arial 10 - nu se suprascrie FontName pe controale
(explicit: fara Arial Narrow).
- Butoanele de inchidere/confirmare stau in bara de titlu, din `cmd_butoane.vcx` - modelul
Renunt/Termin (clasa `frm_termin_renunt` din `_frm_child.vcx` le aduce deja). Nu se
dubleaza aceste actiuni cu butoane in corpul formei.
- Actiunile care au corespondent `but_*` in `cmd_butoane.vcx` (Nou/Adauga, Modifica,
Salveaza, Sterge, Verifica etc.) folosesc CU PREDILECTIE clasa dedicata `but_*` respectiva -
nu se improvizeaza un buton generic pentru o actiune care are deja clasa ei.
- Doar actiunile FARA corespondent `but_*` primesc butoane pe clasele `cmd_*` din
`cmd_butoane.vcx` (ex. `cmd_executa`) - nu clase improvizate si nu CommandButton nativ.