Partajați prin


Grile și subgrids în aplicațiile bazate pe modele (referințe API client)

Grile prezintă date într-un format tabelar în aplicațiile bazate pe modele. Grilele pot cuprinde întregul formular sau pot fi unul dintre elementele dintr-un formular; acestea din urmă se numesc subgrids.

Tipuri de grile

Există două tipuri de grile în aplicațiile bazate pe modele:

  • Grile doar în citire: Afișarea datelor într-un format tabelar. Pentru a edita datele afișate într-o grilă doar în citire, trebuie să selectați înregistrarea din grilă pentru a deschide formularul, să editați datele, apoi să salvați.
  • Grile editabile: Pe lângă afișarea datelor într-un format tabelar, oferă capacități îmbogățit de editare în linie pe web și clienți mobili, inclusiv capacitatea de a grupa, a sorta și a filtra datele din aceeași grilă, astfel încât să nu fie necesar să comutați între înregistrări sau vizualizări. Grila editabilă este un control particularizat și este acceptat în grila principală și subgrids într-un formular în clientul web și în tablouri de bord și în grile de formular de pe clienții mobili. Deși controlul grilei editabile oferă capacitate de editare, respectă metadatele grilei doar în citire și setările de securitate la nivel de câmp.

Obținerea contextului grilei

Contextul grilei este instanța grilei sau a subgridului dintr-un formular în care doriți să rulați codul. Pentru mai multe informații despre obținerea contextului de grilă pentru executarea codului JavaScript, consultați Contextul grilei API client

Evenimente

Nume Descriere Aplicabil pentru
Subgrid OnLoad Event Apare de fiecare dată când se reîmprospătează subgridul. Acest lucru include atunci când utilizatorii sortează valorile din subgrid, făcând clic pe titlurile de coloană. Grilă doar în citire
Grilă onChange Apare atunci când o valoare este modificată într-o celulă din grila editabilă, iar celula pierde focalizarea Grilă editabilă
Grilă LaÎnregSelect Apare atunci când este selectat un singur rând (înregistrare) în grila editabilă Grilă editabilă
Grilă OnSave Apare înainte de a trimite informațiile actualizate la server și atunci când are loc oricare dintre următoarele operațiuni: există o modificare a selecției de înregistrări, utilizatorul declanșează în mod explicit o operațiune de salvare utilizând butonul de salvare al grilei editabile sau utilizatorul aplică o operațiune de sortare, filtrare, grup, paginare sau navigare din grila editabilă în timp ce există modificări în așteptare. Grilă editabilă

Notă

Puteți să vă înregistrați pentru evenimentele OnChange, OnRecordSelect și OnSave utilizând fila Evenimente a paginii de aplicații bazate pe modele, care este utilizată pentru a activa grile editabile pentru un tabel sau o grilă doar în citire.

Obiecte

Utilizați următoarele obiecte pentru a interacționa cu grilele. Aceste obiecte formează o ierarhie așa cum se arată în diagrama următoare:

Ierarhia obiectelor disponibile în grile

Nume Descriere Disponibil pentru
GridControl Furnizează metode de lucru cu grila sau controlul de subgrid. Grile doar în citire și editabile
Grilă Furnizează metode de accesare a informațiilor despre datele din grilă. Grile doar în citire și editabile
Grilă Furnizează metode de lucru cu rânduri sau rânduri selectate în grilă. Grile doar în citire și editabile
GridRowData Furnizează metode de lucru cu rânduri sau rânduri selectate în grilă. Grile doar în citire și editabile
GrilăEntitate Furnizează metode de accesare a datelor despre înregistrările specifice din rânduri. Grile doar în citire și editabile
GridAttribute Furnizează metode de accesare a datelor din celula unei grile editabile. Grilă editabilă
GridCell Furnizează metode de a accesa datele legate de controlul dintr-un formular legat la o coloană dintr-o grilă editabilă. Grilă editabilă
ViewSelector Furnizează metode pentru a obține sau a seta informații despre selectorul de vizualizare al controlului de subgrid. Grilă doar în citire

Context grilă API client
Utilizarea grilelor editabile
Referință API client pentru aplicațiile bazate pe modele
Prezentare generală a aplicațiilor bazate pe modele