Rutnät och underrutnät i modelldrivna appar (klient-API-referens)

Rutnät visar data i tabellformat i modelldrivna appar. Rutnät kan sträcka sig över hela formuläret eller vara ett av objekten i ett formulär. de senare kallas underrutnät.

Typer av rutnät

Det finns två typer av rutnät i modelldrivna appar:

  • Skrivskyddade rutnät: Visa data i tabellformat. Om du vill redigera data som visas i ett skrivskyddat rutnät måste du välja posten i rutnätet för att öppna formuläret, redigera data och sedan spara.
  • Redigerbara rutnät: Förutom att visa data i tabellformat ger det omfattande funktioner för infogad redigering på webbklienter och mobila klienter, inklusive möjligheten att gruppera, sortera och filtrera data i samma rutnät så att du inte behöver växla poster eller vyer. Det redigerbara rutnätet är en anpassad kontroll och stöds i huvudrutnätet och underrutnät i ett formulär i webbklienten och i instrumentpaneler och i formulärrutnät på mobila klienter. Även om den redigerbara rutnätskontrollen ger redigeringsfunktioner, respekterar den skrivskyddade rutnätsmetadata och säkerhetsinställningar på fältnivå.

Hämta rutnätskontexten

Rutnätskontext är rutnäts- eller underruteinstansen i ett formulär som du vill köra koden mot. Mer information om hur du hämtar rutnätskontexten för att köra JavaScript-koden finns i Rutnätskontext för klient-API

Evenemang

Namn Description Gäller för
Underordnad OnLoad-händelse Inträffar varje gång underrutnätet uppdateras. Detta inkluderar när användare sorterar värden i underrutnät genom att klicka på kolumnrubrikerna. Skrivskyddat rutnät
Grid OnChange Inträffar när ett värde ändras i en cell i det redigerbara rutnätet och cellen förlorar fokus Redigerbart rutnät
Grid OnRecordSelect Inträffar när en enskild rad (post) har valts i det redigerbara rutnätet Redigerbart rutnät
Rutnät påspara Inträffar innan den uppdaterade informationen skickas till servern, och när något av följande inträffar: det sker en ändring i postvalet utlöser användaren uttryckligen en spara-åtgärd med hjälp av det redigerbara rutnätets spara-knapp, eller användaren tillämpar en sorterings-, filter-, grupp-, sidnumrerings- eller navigeringsåtgärd från det redigerbara rutnätet medan det finns väntande ändringar. Redigerbart rutnät

Anmärkning

Du kan registrera dig för händelserna OnChange, OnRecordSelect och OnSave med hjälp av fliken Händelser på sidan modelldrivna appar som används för att aktivera redigerbara rutnät för en tabell eller ett skrivskyddat rutnät.

Objects

Använd följande objekt för att interagera med rutnät. Dessa objekt bildar en hierarki enligt följande diagram:

Hierarkin för objekt som är tillgängliga i rutnät

Namn Description Tillgänglig för
GridControl Tillhandahåller metoder för att arbeta med rutnäts- eller underrutekontrollen. Skrivskyddade och redigerbara rutnät
Gitter Tillhandahåller metoder för att komma åt information om data i rutnätet. Skrivskyddade och redigerbara rutnät
GridRow Tillhandahåller metoder för att arbeta med rader eller valda rader i rutnätet. Skrivskyddade och redigerbara rutnät
GridRowData Tillhandahåller metoder för att arbeta med rader eller valda rader i rutnätet. Skrivskyddade och redigerbara rutnät
GridEntity Tillhandahåller metoder för att komma åt data om de specifika posterna i raderna. Skrivskyddade och redigerbara rutnät
GridAttribute Tillhandahåller metoder för att komma åt data i cellen i ett redigerbart rutnät. Redigerbart rutnät
GridCell Innehåller metoder för att komma åt data som rör kontroll i ett formulär som är kopplat till en kolumn i ett redigerbart rutnät. Redigerbart rutnät
ViewSelector Tillhandahåller metoder för att hämta eller ange information om visningsväljaren för underrutekontrollen. Skrivskyddat rutnät

Klient-API-rutnätskontext
Använda redigerbara rutnät
Klient-API-referens för modelldrivna appar
Utvecklaröversikt över modelldrivna appar