/**
 * Tämä metodi palauttaa viestin kirjoituslomakkeen koodin.
 * @param string $ilmoitus Kommentti käyttäjälle.
 * @param int $teema_id antaa teeman/viestiluokan numeron
 * @param <type> $aihe
 * @param <type> $viesti
 * @param <type> $uusi
 * @param <type> $emoid Kun > -1, on kysymys sen viestin id:stä, johon tämä
 * vastaa/kommentoi. Jos arvo on -1, on kysymys keskustelun avausviestistä.
 * @param <type> $viesti_id tämän avulla välitetään tieto siitä, mitä
 * viestiä on muutettu.
 * @param int $taso viestin tasonro 1 = aloitusviesti, 2 = kommentti.
 * @return <type>
 * @param <type> $omaid
 * @param <type> $tietokantaolio
 * @param Teemat $teemat    Teemat-luokan olio
 * @return <type>
 */
function nayta_viestilomake($ilmoitus, $teema_id, &$aihe, &$viesti, $uusi, &$emoid, $viesti_id, $taso, $omaid, $tietokantaolio, $teemat)
{
    // TArkistetaan ensin, onko kyseessä aloitusviesti vai kommentti.
    $on_kommentti = false;
    if (isset($taso) && $taso > 1) {
        $on_kommentti = true;
    }
    $tallennusnappiteksti = "Tallenna viesti";
    // Tekstin muokkauspainikkeet:
    $muokattavan_elementin_id = "viestikentta";
    $alasvetovalikon_id = "erikoismerkit";
    $tekstityokaluolio = new Tekstityokalupalkki($muokattavan_elementin_id, $alasvetovalikon_id);
    $tekstimuokkauspainikkeet = $tekstityokaluolio->luo_painikkeet(Tekstityokalupalkki::$PERUSPAINIKKEET);
    // Kommenttia ei voi kommentoida eikä teemaa valita:
    if ($on_kommentti) {
        $tallennusnappiteksti = "Tallenna viesti";
        //Muutos -> index.php!
        $teemahtml = "";
    }
    // Ilmoitus otetaan mukaan, jos ei tyhjä:
    if ($ilmoitus != "") {
        $ilmoitus = "<b style='color:red'>" . $ilmoitus . "</b><br />";
    }
    if ($uusi) {
        $submitnappi = "<td colspan='2' align='center'><input type='submit'\n        name='toiminta'" . "value='" . $tallennusnappiteksti . "'/>";
        // Aktiivisuuslaji:
        $aktiivisuuslaji = Aktiivisuus::$VIESTIN_KIRJOITUSTILA;
    } else {
        $submitnappi = "<td colspan='2' align='center'><input type='submit'\n        name='toiminta'" . "value='Tallenna muutokset'/>";
        // Aktiivisuuslaji:
        $aktiivisuuslaji = Aktiivisuus::$VIESTIN_MUOKKAUSTILA;
    }
    if ($uusi && !$on_kommentti) {
        $perunappi = "<input type='submit'\n        name='toiminta'" . "value='Poistu tallentamatta'/>";
    } else {
        $perunappi = "<input type='button' name='toiminta'" . "onClick = 'viestin_peruutus()' value = 'Poistu tallentamatta'/>";
    }
    /* Aina piste rivin loppuun, ettei tule tyhjiä merkkejä! */
    $mj = "<div id='viestilaatikko'>" . "<form align='center' method='post'" . "action='index.php?emoviestin_id=" . $emoid . "&teema_id=" . $teema_id . "&vika_viesti_id=" . $emoid . "&viesti_id=" . $viesti_id . "&taso=" . $taso . "'>" . $ilmoitus . "<b>Kirjoita tiedot ja paina Tallenna-nappia!" . " (Joko otsikko tai viesti t&auml;ytyy olla.)</b><br/>" . "<table id='viestilomake' summary='uudet_tiedot'>" . "<tr>" . "<td>Otsikko: </td><td><input id='aihe' type='text' " . "name='aihe' value='{$aihe}' /></td>" . "<td>Viestiluokka: <i>" . $teemat->hae_teema($teema_id) . "</i></td></tr>" . "<tr><td></td><td colspan='3'>{$tekstimuokkauspainikkeet}</td></tr>" . "<tr><td>Viesti:</td>" . "<td colspan='2'><textarea id='viestikentta' cols='70' rows='9'\n        name='viesti'>{$viesti}" . "</textarea></td></tr>" . "<tr><td></td>" . $submitnappi . $perunappi . "</td><td></td></tr>" . "</table>" . "</form>" . "</div>";
    // Aktiivisuusmerkintä:
    $viimeksi_aktiivi = time();
    paivita_aktiivisuus($omaid, $tietokantaolio, $viimeksi_aktiivi, $aktiivisuuslaji);
    return $mj;
}