Siirry pääsisältöön

Selection

Avaa ChatGPT:ssä

Table-komponentti tarjoaa erilaisia valintamahdollisuuksia. On olemassa metodeja yksittäisten kohteiden, useiden kohteiden tai ohjelmallisten valintojen hallintaan.

Tietojen hallinta ja kysely

Tietoa siitä, miten käyttää Repository-mallia kokoelmien hallintaan ja kyselyyn, katso Repository-artikkelit.

Valintatila​

Taulukon valintatila määrittää, miten käyttäjät voivat valita kohteita. Se tarjoaa vaihtoehtoja kohteiden valintakäyttäytymisen määrittämiseksi. Table-luokka tarjoaa menetelmän valintatilan asettamiseksi:

setSelectionMode(SelectionMode selectionMode)

Saatavilla olevat SelectionMode-vaihtoehdot ovat:

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

Valintatapahtuma​

Table-komponenttipaketti lähettää useita tapahtumia, jotka liittyvät rivivalintoihin. Nämä tapahtumat tallentavat muutokset Table-rivien valintatilassa. Alla ovat keskeiset valintatapahtumat ja niiden kuvaukset:

  • TableItemSelectEvent - Lähetetään, kun taulukon kohde valitaan.
  • TableItemDeselectEvent - Lähetetään, kun taulukon kohde poistetaan valinnasta.
  • TableItemSelectionChange - Lähetetään, kun koko taulukkovalinta muuttuu tai kun valitaan lisävalinta.
tiedot

TableItemSelectEvent ja TableItemDeselectEvent eivät laukaise, kun usean valinnan tila on aktiivinen ja valinta tehdään otsikkoruutu-checkboxin kautta. Tässä tapauksessa tulee käyttää TableItemSelectionChange -tapahtumaa sen sijaan.

Esimerkissä alla TableItemSelectEvent-tapahtuma laukaistaan aina, kun käyttäjä valitsee rivin. Tapahtuman voi käsitellä lisäämällä kuuntelijan taulukolle onItemSelect()-menetelmän avulla.

Näytä koodi

Checkbox-valinta​

Checkbox-valinta on käytössä, kun valintatila on MULTI, ja se mahdollistaa käyttäjien valita kätevästi yhden tai useamman kohteen jokaisen rivin yhteydessä olevien valintaruutujen avulla. Tämä ominaisuus on erityisen hyödyllinen tilanteissa, joissa käyttäjät tarvitsevat ryhmätoimintoja valituille kohteille. Table-luokka tarjoaa menetelmiä checkbox-valinnan mahdollistamiseksi ja mukauttamiseksi.

Käyttämällä setCheckboxSelection(boolean checkboxSelection) -menetelmää, voidaan määrittää, että valintaruudut näytetään jokaisen rivin vieressä, jolloin käyttäjät voivat valita kohteita. Alla oleva ohjelma näyttää usean valinnan ja checkbox-valinnan olevan käytössä:

Näytä koodi

Ohjelmallinen valinta​

Table-komponentti tarjoaa ohjelmallisia valintamenetelmiä, jotka mahdollistavat valittujen kohteiden käsittelyn joko avainargumenttien tai kokonaiskohteiden perusteella.

Valitse avaimen mukaan​

selectKey(Object... keys) -menetelmä mahdollistaa kohteiden ohjelmallisen valitsemisen niiden avaimien avulla. Tälle metodille voidaan antaa yksi tai useampi avain, ja se päivittää valinnan vastaavasti.

Valitse kohteet​

Lopuksi, select(T... items) -menetelmä mahdollistaa kohteiden ohjelmallisen valitsemisen antamalla yksittäisiä kohteita tälle metodille, jotta valinta voidaan päivittää vastaavasti.