S60_Platform_Avkon_UI_Resources_Grids_v1_1_en

S60Platform:AvkonUIResources—GridsS60platformVersion1.1November2,2005S60Platform:AvkonUIResources—Grids|2LegalNoticeCopyright©2005NokiaCorporation.Allrightsreserved.NokiaandNokiaConnectingPeopleareregisteredtrademarksofNokiaCorporation.JavaandallJava-basedmarksaretrademarksorregisteredtrademarksofSunMicrosystems,Inc.Otherproductandcompanynamesmentionedhereinmaybetrademarksortradenamesoftheirrespectiveowners.DisclaimerTheinformationinthisdocumentisprovided“asis,”withnowarrantieswhatsoever,includinganywarrantyofmerchantability,fitnessforanyparticularpurpose,oranywarrantyotherwisearisingoutofanyproposal,specification,orsample.Furthermore,informationprovidedinthisdocumentispreliminary,andmaybechangedsubstantiallypriortofinalrelease.Thisdocumentisprovidedforinformationalpurposesonly.NokiaCorporationdisclaimsallliability,includingliabilityforinfringementofanyproprietaryrights,relatingtoimplementationofinformationpresentedinthisdocument.NokiaCorporationdoesnotwarrantorrepresentthatsuchusewillnotinfringesuchrights.NokiaCorporationretainstherighttomakechangestothisspecificationatanytime,withoutnotice.LicenseAlicenseisherebygrantedtodownloadandprintacopyofthisspecificationforpersonaluseonly.Nootherlicensetoanyotherintellectualpropertyrightsisgrantedherein.Version1.1|November2,2005S60Platform:AvkonUIResources—Grids|3Contents1.Introduction.........................................................................................................52.GridArchitecture.................................................................................................63.GridTypes............................................................................................................73.1MenuGrid........................................................................................................................73.2SelectionGrid..................................................................................................................73.3MarkableGrid..................................................................................................................84.GridFormatandLayout......................................................................................94.1CellStructure..................................................................................................................94.2GridLayout......................................................................................................................95.CreatingGridControls......................................................................................115.1GridResourceStructures..............................................................................................115.2CreatingGridControlfromaResourceFile..................................................................135.3CreatingGridControlWithoutaResourceFile.............................................................135.4CreatingtheMenuGrid.................................................................................................145.5CreatingaMarkableGrid..............................................................................................146.ManagingGridLayoutandContents..............................................................166.1SettingUptheCellStructure.........................................................................................166.2AccessingSelectedItems.............................................................................................176.3AddingItemstotheGrid...............................................................................................186.4RemovingItemsfromtheGrid......................................................................................186.5LoadingGraphics..........................................................................................................197.TermsandAbbreviations.................................................................................208.EvaluateThisResource....................................................................................21Version1.1|November2,2005S60Platform:AvkonUIResources—Grids|4ChangeHistoryNovember9,2004Version1.0InitialdocumentreleaseNovember2,2005Version1.1UpdatedtocoverS603rdEdition.Minorterminologyupdate.Version1.1|November2,2005S60Platform:AvkonUIResources—Grids|51.IntroductionGridsareusedextensivelyontheS60platformtorepresentacompactviewofthedatastructureusinggraphicsand/ortext.ThisdocumentintroducesreaderstogriduseontheS60platform.Itemsfromthedatastructurearerepresentedbycellsinthegridview.Acellcanbefurtherdividedintosub-cells,whichcontaingraphicsortext.Dependingonthescreensize,cellsize,andnumberofitemsinthedatastructure,allorsomeofthecellsarevisibleconcurrently.Gridcontrolsprovideuserswithamechanismtonavigatebetweenthecells.Gridsarealsoscrollable,thusenablingaccesstoallitemsinthedatastructure.LikeotheruserinterfacecomponentsontheS60platform,gridsfollowtheModel-View-Controller(MVC)designpattern.Usinglistboxesisanothercommonwaytorepresentasetofi