Viestidiakoni
MessageDialog
on modaalidiakoni, joka on suunniteltu näyttämään viesti käyttäjälle, ja siinä on OK
-painike, jolla dialogi voidaan sulkea. Se estää sovelluksen suorituksen, kunnes käyttäjä vuorovaikuttaa sen kanssa tai se sulkeutuu ajan loputtua.
OptionDialog.showMessageDialog("Hello World!");
Käyttö
Viestidiakoni tarjoaa tavan näyttää informatiivisia hälytyksiä, kuten ilmoituksia, päivityksiä tai yksinkertaisia viestejä, jotka vaativat vain käyttäjän tunnustavan ne ilman, että syöttöä tarvitaan.
MessageDialog dialog = new MessageDialog(
"Hello World", "Hello World", MessageDialog.MessageType.INFO);
dialog.setBlurred(true);
dialog.setAlignment(MessageDialog.Alignment.TOP);
dialog.show();
Viestityyppi
MessageDialog
tukee seuraavia viestityyppejä. Kun määrität tyypin, dialogi näyttää ikonin viestin vieressä, ja dialogin teema päivitetään webforJ-suunnittelujärjestelmän sääntöjen mukaisesti.
PLAIN
: Näyttää viestin ilman ikonia käyttäen oletusteemaa.ERROR
: Näyttää virheikoni viestin vieressä soveltaen virheteemaa.QUESTION
: Näyttää kysymysmerkin ikonin viestin vieressä käyttäen ensisijaista teemaa.WARNING
: Näyttää varoitusikonin viestin vieressä soveltaen varoitusteemaa.INFO
: Näyttää infoikoni viestin vieressä käyttäen info-teemaa.
Seuraavassa esimerkissä koodi määrittää varoitustyypin WARNING
viestidiakoniin mukautetulla otsikolla ja viestillä.
Näytä Koodi
- Java
Oletuksena dialogin teema määräytyy viestityypin mukaan. Voit mukauttaa dialogin teemaa käyttämällä setTheme(Theme theme)
metodia ja säätää paineteeman erikseen setButtonTheme(ButtonTheme theme)
metodilla luodaksesi erilaisia versioita.
Paineteksti
Voit määrittää dialogin painikkeen tekstin käyttämällä setButtonText(String text)
.
OptionDialog.showMessageDialog("Hello World!", "Otsikko", "Ymmärrän");
HTML-käsittely
Oletuksena viestidiakoni käsittelee ja renderoi HTML-sisältöä. Voit poistaa tämän ominaisuuden käytöstä määrittämällä sen näyttämään raakatekstiä sen sijaan.
MessageDialog dialog = new MessageDialog(
"<b>Hello World</b>", "Hello World", MessageDialog.MessageType.INFO);
dialog.setRawText(true);
dialog.show();
Aikakatkaisu
MessageDialog
sallii sinun asettaa aikakatkaisun keston, jonka jälkeen dialogi sulkeutuu automaattisesti. Tämä ominaisuus on hyödyllinen ei-kriittisille ilmoituksille tai tiedoille, jotka eivät vaadi käyttäjän välitöntä vuorovaikutusta.
Voit määrittää dialogin aikakatkaisun käyttämällä setTimeout(int timeout)
metodia. Aikakatkaisun kesto on sekunneissa. Jos määritetty aika kuluu ilman mitään käyttäjän vuorovaikutusta, dialogi sulkeutuu automaattisesti.
MessageDialog dialog = new MessageDialog("Tämä dialogi sulkeutuu pian", "Aikakatkaisu");
dialog.setTimeout(2);
dialog.show();
Parhaat käytännöt
- Selkeät ja ytimekkäät viestit: Pidä viestit lyhyinä ja ytimekkäinä, ja vältä teknistä jargonia; käytä käyttäjäystävällistä kieltä.
- Sopivat viestityypit:
- Käytä
ERROR
kriittisille ongelmille. - Käytä
WARNING
varoitusilmoituksille. - Käytä
INFO
yleiselle tiedolle.
- Käytä
- Johdonmukainen teema: Yhdistele dialogin ja painikkeiden teemat sovelluksesi suunnittelun mukaisiksi.
- Aikakatkaisun harkittu käyttö: Aseta aikakatkaisuja ei-kriittisille ilmoituksille ja varmista, että käyttäjillä on riittävästi aikaa lukea viesti.
- Vältä liiallista käyttöä: Käytä dialogeja säästeliäästi estämiseksi käyttäjän turhautumista ja säästä niitä tärkeille viesteille, jotka vaativat käyttäjän toimintaa tai tunnustusta.