Mriežky a vedľajšie mriežky v modelom riadených aplikáciách (odkaz na klientske rozhranie API)

Mriežky a vedľajšie mriežky prezentujú údaje v tabuľkovom formáte v modelom riadených aplikáciách. Udalosti a objekty rozhrania API klienta uvedené v tomto článku použite na prácu s mriežkami určenými iba na čítanie a upraviteľnými mriežkami. Mriežky môžu zahŕňať celý formulár, alebo môžu byť jednou z položiek vo formulári; tie sa nazývajú vedľajšie mriežky.

Typy mriežok

V modelom riadených aplikáciách existujú dva typy mriežok:

  • Mriežky iba na čítanie: Zobrazujú údaje v tabuľkovom formáte. Ak chcete upraviť údaje zobrazené v mriežke iba na čítanie, musíte vybrať záznam v mriežke a otvoriť formulár, upraviť údaje a potom ich uložiť.
  • Upraviteľné mriežky: Okrem zobrazenia údajov v tabuľkovom formáte poskytuje bohaté možnosti vnorených úprav na webových a mobilných klientoch vrátane možnosti zoskupovať, zoraďovať a filtrovať údaje v tej istej mriežke, aby ste nemuseli prepínať záznamy alebo zobrazenia. Upraviteľná mriežka je vlastný ovládací prvok a je podporovaná v hlavnej mriežke a vedľajšej mriežke vo formulári vo webovom klientovi a v tabuliach a v mriežkach formulára na mobilných klientoch. Hoci upraviteľný ovládací prvok mriežky poskytuje možnosť úprav, rešpektuje metaúdaje mriežky iba na čítanie a nastavenia zabezpečenia na úrovni poľa.

Získanie kontextu mriežky

Kontext mriežky je mriežka alebo vedľajšia inštancia vo formulári, pre ktorú chcete spustiť kód. Ďalšie informácie o spustení kódu JavaScriptu v kontexte mriežky nájdete v téme Kontext mriežky rozhrania Client API.

Udalosti mriežky

Meno Popis Platí pre
Udalosť OnLoad pre vedľajšie mriežky Vyskytuje sa pri každom obnovení vedľajšej mriežky. Táto udalosť zahrnuje, keď používatelia zoraďujú hodnoty v vedľajšej mriežke kliknutím na hlavičky stĺpcov. Mriežka iba na čítanie
OnChange pre mriežky Vyskytne sa, keď sa hodnota v bunke v upraviteľnej mriežke zmení a bunka stratí zameranie Editovateľná mriežka
OnRecordSelect pre mriežky Vyskytne sa, keď je v upraviteľnej mriežke vybratý jeden riadok (záznam) Editovateľná mriežka
OnSave pre mriežky Vyskytne sa pred odoslaním aktualizovaných informácií na server a keď nastane niektorá z nasledujúcich možností: dôjde k zmene vo výbere záznamu, používateľ explicitne spustí operáciu uloženia pomocou tlačidla na uloženie pre upraviteľnú mriežku alebo používateľ použije zoradenie, filter, skupinu, stránkovanie alebo navigačnú operáciu z upraviteľnej mriežky, kým v nej nie sú čakajúce zmeny. Editovateľná mriežka

Poznámka

Môžete sa zaregistrovať na udalosti OnChange, OnRecordSelect a OnSave pomocou karty Udalosti na stránke modelom riadených aplikácií, ktorú používate na povolenie upraviteľných mriežok pre tabuľku alebo mriežku iba na čítanie.

Objekty mriežky

Na interakciu s mriežkami použite nasledujúce objekty. Tieto objekty tvoria hierarchiu, ako je to znázornené na nasledujúcom diagrame:

Snímka obrazovky hierarchie objektov rozhrania API klienta, ktoré sú k dispozícii v mriežkach a podmriežkach.

Meno Popis K dispozícii pre
GridControl Poskytuje metódy na prácu s ovládacím prvkom mriežky alebo vedľajšej mriežky. Mriežky iba na čítanie a upraviteľné
Mriežka Poskytuje metódy na prístup k informáciám o údajoch v mriežke. Mriežky iba na čítanie a upraviteľné
Mriežka Poskytuje metódy na prácu s riadkami alebo vybratými riadkami v mriežke. Mriežky iba na čítanie a upraviteľné
GridRowData Poskytuje metódy na prácu s riadkami alebo vybratými riadkami v mriežke. Mriežky iba na čítanie a upraviteľné
GridEntity Poskytuje metódy na prístup k údajom o konkrétnych záznamoch v riadkoch. Mriežky iba na čítanie a upraviteľné
GridAttribute Poskytuje metódy na prístup k údajom v bunke upraviteľnej mriežky. Editovateľná mriežka
GridCell Poskytuje metódy na prístup k údajom súvisiacim s ovládacími prvkami vo formulári, ktorý je viazaný na stĺpec v upraviteľnej mriežke. Editovateľná mriežka
ViewSelector Poskytuje metódy na získanie alebo nastavenie informácií o selektore zobrazenia ovládacieho prvku vedľajšej mriežky. Mriežka iba na čítanie

Kontext mriežky rozhrania Client API
Používanie upraviteľných mriežok
Referenčné informácie o rozhraní API klienta pre modelom riadené aplikácie
Príručka pre vývojárov aplikácií riadených modelom