Arbeta med Cells GridWeb
Tillgång till celler i arbetsbladet
Det här avsnittet diskuterar celler och tittar på GridWebs mest grundläggande funktion: tillgång till celler.
Varje arbetsblad innehåller ett GridCells-objekt, en samling GridCell-objekt. Ett GridCell-objekt representerar en cell i Aspose.Cells.GridWeb. Det är möjligt att komma åt vilken cell som helst med GridWeb. Det finns två föredragna metoder:
Nedan diskuteras varje tillvägagångssätt.
Användning av cellnamn
Alla celler har ett unikt namn. Till exempel A1, A2, B1, B2, etc. Aspose.Cells.GridWeb gör det möjligt för utvecklare att komma åt en önskad cell genom att använda cellnamnet. Skicka helt enkelt cellnamnet (som en index) till GridCells-samlingen i GridWorksheet.
Använda rad- och kolumnindex
En cell kan också känns igen genom dess plats i termer av rad- och kolumnindex. Skicka helt enkelt en cells rad- och kolumnindex till GridCells-samlingen i GridWorksheet. Detta tillvägagångssätt är snabbare än det föregående.
Komma åt och modifiera värdet av en cell
Tillgång till celler i arbetsbladet diskuterade åtkomst av celler. Detta ämne utökar den diskussionen för att visa hur man kommer åt och ändrar cellvärden med hjälp av GridWeb API.
Komma åt och ändra ett cells värde
Strängvärden
Innan du kommer åt och modifierar värdet av en cell måste du veta hur man kommer åt celler. För detaljer om de olika tillvägagångssätten för att komma åt celler, se Tillgång till celler i arbetsbladet.
Varje cell har en egenskap som heter getStringValue(). När en cell har kommit åt kan utvecklare komma åt getStringValue()-metoden för att komma åt cellers strängvärde.
Alla typer av värden
Aspose.Cells.GridWeb tillhandahåller också en speciell metod, putValue, för varje cell. Med denna metod är det möjligt att infoga eller ändra vilken typ av värde som helst (Boolean, int, double, DateTime och sträng) i en cell.
Det finns också en överbelastad version av putValue-metoden som kan ta vilken typ av värde som helst i strängformat och konvertera det till en lämplig datatyp automatiskt. För att göra det, skicka det Booleska värdet true till en annan parameter i putValue-metoden enligt exemplet nedan.
Lägga till formler i cellerna
Den mest värdefulla funktionen som erbjuds av Aspose.Cells.GridWeb är stöd för formler eller funktioner. Aspose.Cells.GridWeb har sin egen Formula Engine som beräknar formlerna i arbetsblad. Aspose.Cells.GridWeb stöder både inbyggda och användardefinierade funktioner eller formler. Detta ämne diskuterar lägg till formler i celler med hjälp av Aspose.Cells.GridWeb API i detalj.
Hur man lägger till och beräknar en formel?
Det är möjligt att lägga till, komma åt och modifiera formler i celler genom att använda cellens Formula-egenskap. Aspose.Cells.GridWeb stöder användardefinierade formler som sträcker sig från enkla till komplexa. Dock medföljer även ett stort antal inbyggda funktioner eller formler (liknande Microsoft Excel) med Aspose.Cells.GridWeb. För att se den fullständiga listan över inbyggda funktioner, vänligen hänvisa till denna lista över stödda funktioner.
Formelsyntaxen ska vara kompatibel med Microsoft Excel syntax. Till exempel måste alla formler börja med ett lika med-tecken (=).
För att lägga till en formel programmatiskt kommer Aspose.Cells.GridWeb att känna igen den som en formel även om du inte använder ett =-tecken, men om slutanvändare som arbetar i GUI måste använda det.
Formel tillagd till cell B3 men inte beräknad av GridWeb
På skärmbilden ovan kan du se att en formel har lagts till B3 men har ännu inte beräknats. För att beräkna alla formler, anropa GridWeb kontrollens GridWorksheetCollections calculateFormula-metod efter att ha lagt till formler i arbetsbladen enligt nedan.
Användare kan också beräkna formler genom att klicka på Skicka.
Klicka på Submit-knappen i GridWeb
VIKTIGT: Om en användare klickar på Spara eller Ångra-knapparna, eller arbetsbladets flikar, beräknas alla formler automatiskt av GridWeb.
Formelresultat efter beräkning
Referera till celler från andra arbetsblad
Med Aspose.Cells.GridWeb är det möjligt att referera till värden som lagras i olika arbetsblad i deras formler och skapa komplexa formler.
Syntaxen för att referera till en cells värde från ett annat arbetsblad är ArkNamn!CellNamn.
Skapa datavalidering i en GridCell av GridWeb
Aspose.Cells.GridWeb gör det möjligt att lägga till Data Validering med hjälp av metoden GridWorksheet.getValidations().add(). Med denna metod måste du ange Cell Range. Men om du vill skapa en Data Validering i en enda GridCell kan du göra det direkt med metoden GridCell.createValidation(). På liknande sätt kan du ta bort Data Validering från en GridCell med hjälp av metoden GridCell.removeValidation().
Följande exempelkod skapar en Data Validering i en cell B3. Om du anger något värde som inte ligger mellan 20 och 40, kommer cellen B3 att visa en Valideringsfel i form av Rött XXXX som visas på skärmdumpen.
Skapande av Anpassade Kommandoknappar
Aspose.Cells.GridWeb innehåller specialknappar som Submit, Save och Undo. Alla dessa knappar utför specifika uppgifter för Aspose.Cells.GridWeb. Det är också möjligt att lägga till anpassade knappar som utför anpassade uppgifter. Detta ämne förklarar hur du använder den här funktionen.
Följande exempelkod förklarar hur man skapar en anpassad kommandoknapp och hur man hanterar dess klickevenemang. Du kan använda vilken ikon som helst för din anpassade kommandoknapp. Som illustrering använde vi den här bild-ikonen.
Som du kan se på följande skärmdump, när användaren klickar på den anpassade kommandoknappen, läggs en text till i cell A1 som säger “Min anpassade kommandoknapp har klickats”.
Hantering av Anpassad Kommandoknappshändelse
Följande exempelkod förklarar hur man utför händelshantering av anpassad kommandoknapp.
Formatering av celler för GridWeb
Möjliga användningsscenario
GridWeb stöder nu att användare anger celldata i procentformat som 3% och data i cellen formateras automatiskt som 3,00%. Du måste dock ställa in cellformatet. till procentformat vilket antingen är GridTableItemStyle.NumberType a 9 eller 10. Numret 9 kommer formatera 3% som 3% men numret 10 kommer formatera 3% som 3,00%.
Ange celldata i GridWeb-arbetsblad i procentformat
Följande exempelkod ställer in cell A1 GridTableItemStyle.NumberType som 10, därmed kommer inmatningsdata 3% automatiskt formateras som 3,00% som visas på skärmdumpen.
