Ruudukot ja aliruudukot mallipohjaisissa sovelluksissa (asiakas-ohjelmointirajapinnan viittaus)

Ruudukot ja aliruudukot esittävät tiedot taulukkomuodossa malliin perustuvissa sovelluksissa. Käytä tämän artikkelin Asiakasohjelman ohjelmointirajapintatapahtumia ja -objekteja vain luku - ja muokattavien ruudukoiden kanssa. Ruudukot voivat ulottua koko lomakkeeseen tai olla yksi lomakkeen kohteista. jälkimmäisiä kutsutaan aliruudukoiksi.

Ruudukoiden tyypit

Mallipohjaisissa sovelluksissa on kahdenlaisia ruudukoita:

  • Vain luku -ruudukot: Näytä tiedot taulukkomuodossa. Jos haluat muokata vain luku -ruudukossa näkyviä tietoja, sinun on valittava ruudukon tietue lomakkeen avaamiseksi, tietojen muokkaamiseksi ja tallentamiseksi.
  • Muokattavat ruudukot: Sen lisäksi, että tiedot näytetään taulukkomuodossa, ne sisältävät runsaasti sisäisiä muokkausominaisuuksia verkko- ja mobiiliohjelmissa, mukaan lukien mahdollisuuden ryhmitellä, lajitella ja suodattaa tietoja samassa ruudukossa, jotta sinun ei tarvitse vaihtaa tietueita tai näkymiä. Muokattava ruudukko on mukautettu ohjausobjekti. Sitä tuetaan verkkoasiakkaan lomakkeen pääruudukossa ja aliruudukoissa sekä mobiiliasiakkaiden koontinäytöissä ja lomakeruudukoissa. Muokattava ruudukon ohjausobjekti tarjoaa muokkausmahdollisuuden, mutta se kunnioittaa read-only ruudukon metatietoja ja kenttätason tietosuoja-asetuksia.

Hae ruudukon konteksti

Ruudukkokonteksti on ruudukko- tai aliruudukkoesiintymä lomakkeessa, jota vastaan haluat suorittaa koodisi. Lisätietoja siitä, miten saat ruudukkokontekstin JavaScript-koodin suorittamiseen, on kohdassa Asiakkaan ohjelmointirajapinnan ruudukkokonteksti.

Ruudukkotapahtumat

Nimi Kuvaus Käytettävissä
Aliruudukon OnLoad-tapahtuma Tapahtuu aina, kun aliruudukko päivittyy. Tämä tapahtuma sisältää tapahtuman, jossa käyttäjät lajittavat arvoja aliruudukossa napsauttamalla sarakeotsikoita. Vain luku -ruudukko
Ruudukon OnChange Toteutuu, kun arvoa muutetaan muokattavan ruudukon solussa ja solu menettää kohdistuksen Muokattava ruudukko
Ruudukon OnRecordSelect Toteutuu, kun muokattavassa ruudukossa valitaan yksi rivi (tietue). Muokattava ruudukko
Ruudukon Tallenna Tapahtuu ennen päivitettyjen tietojen lähettämistä palvelimeen ja kun jokin seuraavista tapahtuu: tietueen valintaan tehdään muutos, käyttäjä käynnistää suoraan tallennustoiminnon muokattavan ruudukon Tallennuspainikkeen avulla tai käyttäjä käyttää lajittelu-, suodatin-, ryhmä-, sivutus- tai siirtymistoimintoa muokattavasta ruudukosta, kun muutoksia odottaa. Muokattava ruudukko

Note

Voit rekisteröityä OnChange-, OnRecordSelect- ja OnSave-tapahtumiin käyttämällä Malliin perustuvien sovellusten sivun Tapahtumat-välilehteä. Niiden avulla voit ottaa muokattavat ruudukot käyttöön taulukolle tai vain luku -ruudukolle.

Ruudukko-objektit

Ruudukoiden kanssa vuorovaikuttamiseen seuraavien objektien avulla. Nämä objektit muodostavat hierarkian seuraavassa kaaviossa esitetyllä tavalla:

Näyttökuva asiakasohjelman ohjelmointirajapinnan objektien hierarkiasta, joka on käytettävissä ruudukoissa ja aliruudukoissa.

Nimi Kuvaus Käytettävissä kohteelle
GridControl Tarjoaa menetelmiä ruudukon tai aliruudukon ohjausobjektin kanssa työskentelyä varten. Vain luku -ruudukot ja muokattavat ruudukot
Ruudukko Tarjoaa menetelmiä ruudukon tietojen käyttämiseen. Vain luku -ruudukot ja muokattavat ruudukot
GridRow Tarjoaa menetelmiä ruudukon rivien tai valittujen rivien kanssa työskentelyä varten. Vain luku -ruudukot ja muokattavat ruudukot
GridRowData Tarjoaa menetelmiä ruudukon rivien tai valittujen rivien kanssa työskentelyä varten. Vain luku -ruudukot ja muokattavat ruudukot
Ruudukkoentiteetti Tarjoaa menetelmiä rivien tiettyjen tietueiden tietojen käyttämiseen. Vain luku -ruudukot ja muokattavat ruudukot
GridAttribute Tarjoaa menetelmiä käyttää muokattavan ruudukon solun tietoja. Muokattava ruudukko
GridCell Tarjoaa menetelmiä hallita tietoja lomakkeesta, joka on sidottu muokattavan ruudukon sarakkeeseen. Muokattava ruudukko
ViewSelector Tarjoaa menetelmiä, joilla voidaan hakea tai määrittää tietoja aliruudukko-ohjausobjektin näkymävalitstimesta. Vain luku -ruudukko

Asiakkaan ohjelmointirajapinnan ruudukon konteksti
Muokattavien ruudukoiden käyttäminen
Asiakkaan ohjelmointirajapinnan viite mallipohjaisille sovelluksille
Mallipohjaisten sovellusten kehittäjän opas