Siirry pääsisältöön

Selection

Avaa ChatGPT:ssä

Table-komponentti tarjoaa erilaisia valintamahdollisuuksia. On olemassa menetelmiä yksittäisten kohteiden valitsemiseen, useiden kohteiden valitsemiseen tai valintojen hallitsemiseen ohjelmallisesti.

Datan hallinta ja kysely

Tietoa Repository-mallin käytöstä kokoelmien hallitsemiseksi ja kyselyjen tekemiseksi löytyy Repository-artikkeleista.

Valintatila​

Taulukon valintatila määrittää, kuinka käyttäjä voi valita kohteita. Se tarjoaa vaihtoehtoja kohteiden valinnan käyttäytymisen määrittämiseksi. Table-luokka tarjoaa menetelmän valintatilan asettamiseen:

setSelectionMode(SelectionMode selectionMode)

Saatavilla olevat SelectionMode-vaihtoehdot ovat:

  • SINGLE - (yksittäisvalinta)
  • MULTI - (monivalinta)
  • NONE - (ei valintaa).

Valintatapahtuma​

Table-komponenttipaketti emittoi useita tapahtumia, jotka liittyvät rivivalintaan. Nämä tapahtumat tallentavat muutoksia Table-rivien valintatilassa. Alla ovat keskeiset valintatapahtumat kuvauksineen:

  • TableItemSelectEvent - Emittoituu, kun taulukon kohde valitaan.
  • TableItemDeselectEvent - Emittoituu, kun taulukon kohde poistetaan valinnasta.
  • TableItemSelectionChange - Emittoituu, kun taulukon yleinen valinta muuttuu tai kun valitaan lisävalinta.
tiedot

TableItemSelectEvent ja TableItemDeselectEvent eivät laukaisemmat, kun monivalintatila on aktiivinen ja valinta tehdään yläpalkin valintaruutua käyttämällä. Tässä tapauksessa on käytettävä TableItemSelectionChange-tapahtumaa.

Alla olevassa esimerkissä TableItemSelectEvent-tapahtuma laukaistaan aina, kun käyttäjä valitsee rivin. Tapahtuma voidaan käsitellä lisäämällä kuuntelija taulukkoon käyttämällä onItemSelect()-menetelmää.

Näytä koodi

Valintaruutuvalinta​

Valintaruutuvalinta on käytössä, kun valintatila on MULTI, ja se mahdollistaa käyttäjien valita kätevästi yksi tai useampi kohde jokaisen rivin vieressä olevien valintaruutujen avulla. Tämä ominaisuus on erityisen hyödyllinen tilanteissa, joissa käyttäjien on suoritettava massatoimia valituilla kohteilla. Table-luokka tarjoaa menetelmiä valintaruudun valinnan aktivoimiseen ja mukauttamiseen.

Käyttämällä setCheckboxSelection(boolean checkboxSelection)-menetelmää valintaruudut voidaan määrittää näytettäväksi jokaisen rivin viereen, jolloin käyttäjät voivat valita kohteita. Alla oleva ohjelma näyttää, kuinka monivalinta ja valintaruutuvalinta on käytössä:

Näytä koodi

Ohjelmallinen valinta​

Table-komponentti tarjoaa ohjelmallisia valintamenetelmiä, joiden avulla voit manipuloida valittuja kohteita joko niiden avaimilla tai kokonaisilla kohteilla.

Valitse avaimen mukaan​

selectKey(Object... keys)-menetelmä mahdollistaa kohteiden ohjelmallisen valitsemisen käyttäen niiden avaimia. Voit välittää tälle menetelmälle yhden tai useamman avaimen, ja se päivityttää valinnan vastaavasti.

Valintakohteiden valinta​

Lopuksi select(T... items)-menetelmä mahdollistaa kohteiden ohjelmallisen valitsemisen välittämällä tälle menetelmälle yksi tai useampi itse kohteista päivityksen tekemiseksi valintaan.