OSA 5. Professional Edition -version työkalut ja tekniikat

OSA 5 Professional Edition -version työkalut ja tekniikat

HARJOITUS 405 15 Tekstinkäsittely Rich Textbox -kontrollin avulla Opit tässä harjoituksessa kuinka: ARVIOITU AIKA 40 min. ActiveX-kontrollit asennetaan ja niitä käytetään Visual Basic Professional Edition -versiossa. tekstinkäsittelyn toiminnallisuus integroidaan Rich Textbox - kontrollin avulla. Windowsin leikepöytää käytetään leikkaa-ja-liitä -toiminnoissa. RTF-tiedostoja avataan, tallennetaan ja tulostetaan valikkokomentojen avulla. tallentamattomat muutokset havaitaan Change-tapahtuman avulla. Rich Textbox -kontrolli Olet oppinut osissa yhdestä neljään ne ohjelmoinnin perustaidot, jotka pätevät Visual Basic 6:n tuoteperheen jokaiseen tuotteeseen (Visual Basic 6 Learning Edition, Visual Basic 6 Professional Edition ja Visual Basic 6 Enterprise Edition). Osissa 5, 6 ja 7 tulet tutustumaan Visual Basic 6 Enterprise Edition -version mukana seuraaviin laajem-piin ominaisuuksiin. Olen jakanut nämä käytännölliset "ammattilaisten" ohjelmistojen sovellustyökalut kolmeen perusluokkaan: ammattimaiset ActiveX-kontrollit, Internet ja dynaamiset HTML -ohjelmat sekä laajemmat tietokantojen hallintaan liittyvät piirteet. Tulet oppimaan kuinka luot tehokkaita Visual Basic -ohjelmia, jotka kaikki hyödyntävät näitä viitaaleja teknologoita. Opit harjoituksessa 15, kuinka asennat ja käytät sitä huomattavaa kokoelmaa ActiveXkontrolleja, jotka tulevat Visual Basic 6 Professional Editionin mukana. Nämä kontrollit sisältyvät myös Visual Basic 6 Enterprise Editioniin, joten jos päätät päivittää korkeamman tason tuotteeseen jonain päivänä, olet jo turvallisella pohjalla. Esittelynä

406 Visual Basic 6 Trainer tähän tehokkaaseen ActiveX-kontrollien perheeseen käyt tosi toimeen Rich Textbox -kontrollin avulla - tehokas työkalu, jonka avulla voit lisätä tekstinkäsittelytuen ohjelmaasi. Rich Textbox, joka on kehittyneempi versio Visual Basicin työkaluruudun vakio Textbox-kontrollista, mahdollistaa laajemman muotoiluun liittyvän tiedon lisäämisen teksteihin, suoraviivaistaa tiedostojen hallintaan liittyviä toimintoja ja hakuja, ja tallentaa tietonsa hienostuneeseen tiedostomuotoon nimeltä RTF (Rich Text Format). Kuten tulet huomaamaan tekemästäni RTFEdit-työkalusta, voit nopeasti luoda Rich Textboxin avulla ohjelman, joka näyttää samalta ja toimii samoin kuin WordPad, RTFpohjainen tekstieditori, joka on Windowsin mukana. Professional Edition -kontrollien asentaminen Kun asensit Visual Basicin Professional Edition -ohjelmiston, osa asennusprosessia oli laajan kokoelman.ocx-tiedostoja, joita kutsutaan myös ActiveX-kontrolleiksi, kopiointi \Windows\System-kansioon tai System32-kansioon. Asennusprosessiin sisältyi myös näiden kontrollien rekisteröinti järjestelmän rekisteriin. Rekisteröinnin avulla Visual Basic ja muut ohjelmat tietävät, kuinka nämä kontrollit ladataan, kun ne tarvitsevat niitä. Useimmat asennetut.ocx-tiedostot edustavat yksilöllisiä ActiveX-kontrolleja, joita voidaan lisätä Visual Basicin työkaluruutuun. Osa.ocx-tiedostoista edustaa kuitenkin kokoelmaa niitä kontrolleja, jotka on organisoitu määrätyn teeman alle. Esimerkiksi Windows Common Control (mscomctl.ocx) sisältää yhdekän työkalukontrollia, joiden avulla ohjelmiin voidaan lisätä ammattimaiselta näyttäviä käyttöliittymän osia, kuten työkalurivit, tilapalkit ja tilaikkunat. Seuraavassa taulukossa luetellaan kaikki ActiveX-kontrollit, jotka sisältyvät Visual Basic 6:n Professional Edition -versioon. Kaikki kontrollit on täysin dokumentoitu Visual Basicin ajonaikaisessa opastuksessa. Tulen käyttämään seuraavissa harjoituksissa useita kontrolleja luoden kiinnostavia ja käytännöllisiä apuohjelmia. ActiveX-kontrolli Tiedostonimi Kuvaus ADO data msadodc.ocx Mahdollistaa pääsyn tietokantojen tietoon ActiveX Data Object (ADO) -muodon avulla Animation mscomct2.ocx Luo animaatioefektejä toistamalla.avitiedostoja (ääntä ei tueta). (Windows Common Control-2.) Chart mschart.ocx Kontrollin avulla voidaan laatia tilastoja tiedosta, joka on talletettu taulukkolaskennan tauluihin ja tietokantoihin. Communications mscomm32.ocx Mahdollistaa tietoliikenneyhteydet sarjaportin avulla.

Harjoitus 15 Tekstinkäsittely Rich Textbox -kontrollin avulla 407 ActiveX-kontrolli Tiedostonimi Kuvaus Cool bar comct332.ocx Säilökontrolli, jota voidaan käyttää luotaessa käyttäjän muokattavissa olevia työkalurivejä, jotka ovat samanlaisia kuin Microsoft Internet Explorerissa. (Win dows Common Control-3.) Data repeater msdatrep.ocx Näyttää käytännöllisesti rivissä useita esiintymiä ActiveX-kontrollista (käytännöllinen varsinkin silloin, kun tietokannasta näytetään useita esiintymiä). DTPicker mscomct2.ocx Sisältää alasputoavan kalenterin, jolla voidaan nopeasti valita päivämääriä ja aikoja. (Windows Common Control-2.) Flat scrollbar mscomct2.ocx Vierityspalkin perustoiminnallisuus sisältäen siistin litteän ulkonäön. (Win dows Common Control-2.) Flex grid msflxgrd.ocx Lisää ohjelmaan taulukkolaskentaohjelman toiminnallisuuden. Kontrolli on käytännöllinen varsinkin silloin, kun näytetään tietokannan tietoja. Hierarchical mshflxgd.ocx Laajennettu versio Flex-taulukkokontrollista, joka pystyy näyttämään hierarkkisia tietuejoukkoja (tietuejoukkoja, jotka on luotu useista eri tauluista). Image combo mscomctl.ocx Samanlainen kuin perus valintaruutukontrolli, paitsi että sisältää tuen kuville. (Windows Common Control.) Image list mscomctl.ocx Säilyttää kokoelman kuvia, joita muut kontrollit voivat käyttää. (Windows Common Control.) Internet transfer msinet.ocx Kontrollin avulla voidaan ottaa yhteys Internetiin ja imuroida HTTP- ja FTP -protokollien avulla. List view mscomctl.ocx Näyttää tietoa "Windows Explorer" -muodossa käyttäen ikoneita, pieniä kuvakkeita, listoja tai raporttinäkymiä. (Windows Common Control.) MAPI msmapi32.ocx Mahdollistaa pääsyn MAPI-viesteihin ja MAPI-istunnon kontrolleihin, jotka alustavat ja suorittavat postinlähetykseen liittyviä tehtäviä Messaging Application Program Interface (MAPI) -rajapinnan avulla. Masked edit msmask32.ocx Tekstiruutu, joka sijoittaa maskin käyttäjän syöttämään tietoon. 15 Rich Textbox -kontrolli

408 Visual Basic 6 Trainer ActiveX-kontrolli Tiedostonimi Kuvaus MonthView mscomct2.ocx Loppukäyttäjä voi kontrollin avulla valita päivämääriä ja jatkuvia päivämääräsarjoja kalenterin graafisesta ulkomuodosta. (Windows Common Control-2.) Multimedia mci32.ocx Hoitaa MCI -multimedialaitteiston MCI äänittämisen ja toistamisen. Picture clip picclp32.ocx Näyttää osan bittikartasta. Progress bar mscomctl.ocx Käyttää lohkoja näytettäessä toiminnon edistymistä graafisesti (Windows Common Control.) Rich textbox richtx32.ocx Kontrollin avulla käyttäjä voi kirjoittaa, muokata ja muotoilla tekstiä Rich Text Format (RTF) -muodossa. Slider mscomctl.ocx Sisältää sekä syöttölaitteen, joka sisältää "pistekohdat" sekä metodin, jolla näytetään toiminnon edistymistä. (Windows Common Control.) Status bar mscomctl.ocx Näyttää tilarivi-ikkunan, joka voi sisältää jopa 16 paneelia tiedon näyttämistä varten. (Windows Common Control.) Sys info sysinfo.ocx Antaa tietoa Windows-käyttöjärjestelmän eri parametreistä. Tab strip mscomctl.ocx Vastaava kuin Tabbed-syöttöikkuna - kontrolli. (Windows Common Control.) Tabbed dialog tabctl32.ocx Esittää syöttöikkunan tiedon joukolla "välilehti" ikkunoita. Toolbar mscomctl.ocx Luo työkalurivin, joka sisältää yksittäisiä painikkeita. (Windows Common Control.) Tree view mscomctl.ocx Näyttää hierarkkista tietoa sisennetyissä "puissa". (Windows Common Control.) UpDown mscomct2.ocx Näyttää nuoliparin, jonka avulla käyttäjä voi vierittää listan läpi tai asettaa arvon siihen liittyvään "kontrollipariin". (Win dows Common Control-2.) Windowless mswless.ocx Sisältää erikoisversioita, jotka säästävät muistia, yhdeksästä työkaluruudun peruskontrollista. Käytä näitä ikkunattomia kontrolleja silloin, kun sinun ei tarvitse käyttää "kahva"-nimisiä muistiosoitteita ohjelman lauseissasi - nämä säästävät järjestelmän resursseja.

Harjoitus 15 Tekstinkäsittely Rich Textbox -kontrollin avulla 409 ActiveX-kontrolli Tiedostonimi Kuvaus Winsock mswinsck.ocx Mahdollistaa pääsyn TCP (transfer control protocol) ja UDP (user datagram protocol) -verkkopalveluihin. Professional Edition -version ActiveX-kontrollien lisääminen työkaluruutuun Jos haluat lisätä Professional Edition -version ActiveX-kontrollit työkaluruutuusi, noudata seuraavia kolmea vaihetta sisältäviä ohjeita. 1 Valitse Project-valikosta Components-komento ja napsauta sitten Controlsvälilehteä. Silloin kun toteutat Components-komennon, Visual Basic tarkastaa järjestelmän rekisterin ja näyttää kaikki ActiveX-kontrollit, jotka ovat saatavilla järjestelmässäsi (eli ei pelkästään ne, jotka Visual Basic asensi). 2 Valitse sen kontrollin, jonka haluat lisätä työkaluruutuun, nimen vasemmalla puolella oleva valintaruutu. 3 Napsauta OK sulkien Components-syöttöikkunan ja lisää ActiveX-kontrolli. Visual Basic näyttää määrittelemäsi kontrollin työkaluruudussa. 15 Rich Textbox -kontrolli Esittelyssä Rich Textbox -kontrolli Yksi Visual Basic Professional Edition -version käytännöllisimmistä ActiveXkontrolleista Rich Textbox -kontrolli, jonka avulla voit lisätä kehittyneet tekstinkäsittelyohjelman ominaisuudet ohjelmaasi. Yksinkertaisesta perustyökaluruutuun sisältyvästä Textbox-kontrollista poiketen Rich Textbox -kontrollin avulla voidaan muotoilla tekstiä käyttäen suosittua koodistandardia, jota kutsutaan nimellä RTF. HTML-kielestä (Hypertext Markup Language) poiketen RTF lisää muotoilun erikoiskoodeja tekstiisi, ja koodien avulla voidaan määrittää fonttitieto, pisteen koko, kirjoitustyyli, kappaleen tyyli, keskitys ja muita suosittuja muotoiluasetuksia. Lisää Rich Textbox -kontrolli työkaluruutuusi Ennen kuin voi käyttää Rich Textbox -kontrollia, sinun täytyy lisätä se työkaluruutuusi. 1 Valitse Project-valikosta Components-komento ja napsauta Controls-välilehteä. Visual Basic näyttää järjestelmääsi asennetut ActiveX-kontrollit. 2 Vieritä kontrollilistaa alaspäin niin kauan, että näet nimen Microsoft Rich Textbox Control 6.0.

410 Visual Basic 6 Trainer 3 Napsauta kontrollin nimen vieressä olevaa valintaruutua ja napsauta OK. Visual Basic lisää Rich Textbox -kontrollin työkaluruutuun. Työkaluruutusi näyttää nyt seuraavalta: [G15x01.bmp] Rich Textbox -kontrolli Tekstiruudun luominen Rich Textbox -kontrollilla on samanlaista kuin tekstiruudun luominen perinteisellä Textbox-kontrollilla. Yksinkertaisesti napsautat työkaluruudun Rich Textbox -kontrollia ja vedät sen sitten lomakkeelle luoden tekstiruudun, joka on sopivan kokoinen ohjelmaasi. Kontrollien väliset erot tulevat selkeäsi esiin, kun aloitat Rich Textbox -kontrollin ominaisuuksien ja metodien käsittelemisen. Seuraava esimerkkiohjelma korostaa tärkeimmät erot. RTFEdit-ohjelman suorittaminen Jos haluat tutkia Rich Textbox -kontrollin tehokkaita taitoja, yritä ajaa RTFEditohjelma, eli apuohjelma, jonka loin Visual Basicissä. Apuohjelma matkii monia samoja toimintoja kuin Windowsin WordPad-ohjelma. Start-painike 1 Avaa RTFEdit.vbp-projekti, joka sijaitsee kansiossa C:\Vb6Sbs\Less15. Jos sinua pyydetään tallentaa muutokset tyhjässä projektissa (joka sisältää viittauksen Rich Textbox -kontrolliin), napsauta No. 2 Napsauta työkalurivin Start-painiketta käynnistäen ohjelman. RTFEdit-ohjelma ilmestyy ruudulle, kuten nähdään seuraavalla sivulla olevassa kuvassa.

Harjoitus 15 Tekstinkäsittely Rich Textbox -kontrollin avulla 411 15 [G15x02.bmp] Rich Textbox -kontrolli Käytä Format-valikon komentoja Kokeile ensin ohjelman tekstin muotoiluun tarkoitettuja toimintoja. 1 Valitse ensimmäinen lause, joka näkyy tekstiruudussa. (This is an RTF editor.) ja napsauta sitten Format-valikkoa. RTF-editorin muotoilukomennot näkyvät valikossa: [G15x03.bmp] Loin jokaisen valikkokomennon Menu Editorissa, ja kirjoitin tapahtumaaliohjelman jokaiselle komennolle Code-ikkunassa. 2 Valitse Format-valikon komento All Caps. RTF-editor muuttaa valitun tekstin isoiksi kirjaimiksi. 3 Valitse ensimmäinen lause uudelleen ja valitse Format-valikon komento Font. Font-syöttöikkuna avautuu, kuten nähdään seuraavalla sivulla olevassa kuvassa.

412 Visual Basic 6 Trainer 4 Määritä uusi fontti, ylikirjoitustyyli, suurempi pistekoko ja uusi väri, ja napsauta sitten OK. RTF-editori muotoilee tekstin pyydetyllä tavalla. 5 Harjoittele seuraavaksi Format-valikon komentoja Bold, Italic ja Underline. Nämä komennot ovat tilanappuloita - voit toistaa niiden valinnan muuttaen valitun tekstin muotoilun. Kuten WordPad, RTF-editori antaa sinulle täydet RTFmuokkausmahdollisuudet. Käytä Edit-valikon komentoja Kokeile seuraavaksi Edit-valikon neljää komentoa. 1 Valitse tekstiruudun viimeinen lause (It has scroll bars!). 2 Valitse Edit-valikosta Cut-komento. Teksti kopioidaan Windowsin leikepöydälle ja poistetaan tekstiruudusta. 3 Siirrä kohdistin kappaleen loppuun, paina Enter ja valitse sitten Edit-valikon Paste-komento. Teksti liitetään leikepöydältä tekstiruutuun. 4 Valitse ensimmäinen lause uudelleen (This is an RTF editor.) ja valitse sitten Editvalikon Copy-komento. RTF-editori kopioi tekstin kaikkine muotoiluineen leikepöydälle. 5 Paina Home-näppäintä ja valitse sitten Edit-valikon Paste-komento liittäen tekstin tekstiruutuun. Yritä seuraavaksi etsiä tekstiä.

Harjoitus 15 Tekstinkäsittely Rich Textbox -kontrollin avulla 413 6 Valitse Edit-valikon Find-komento. 7 Kirjoita lyhenne RTF syöttöikkunaan ja napsauta OK. RTF-editori korostaa ensimmäisen lyhenteen esiintymästä, jonka se löytää. vihje Jos valitset tekstin ennen kuin valitset Find-komennon, RTF-editori etsii valitun sanan ensimmäistä esiintymää. Käytä File-valikon komentoja Kokeile seuraavaksi RTF-editorin tiedostonkäsittelyyn liittyviä komentoja. 15 Rich Textbox -kontrolli 1 Valitse File-valikon Save As -komento. RTF-editori näyttää Save As -syöttöikkunan, joka tiedustelee sinulta tiedoston nimeä. 2 Kirjoita sample.rtf ja napsauta Save. (Voit myös haluttaessa määrittää toisen kansion.) Ohjelma tallentaa tiedoston RTF-muodossa määrittelemääsi paikkaan. tärkeää Varmista, että kirjoitat.rtf-tarkentimen tai valitset Rich Text Format -tyypin Save As Type -listan luettelosta rekisteröiden tiedoston RTF-tiedostoksi Windows Explorerissa. Jos et tee näin, tiedosto ei tule näkymään RTF-tiedostona Open-valintaikkunassa. 3 Valitse File-valikon Close-komento. RTF-editori tyhjentää tekstiruudun. Jos et ole tallentanut muutoksia, sinua pyydetään tallentamaan ne. 4 Valitse File-valikon Open-komento. RTF-editori näyttää Open-valintaikkunan ja luettelee sen hetkisessä kansiossa olevat RTF-tiedostot. 5 Kaksoisnapsauta sample.rtf-tiedostoa, niin näet sen uudelleen. 6 Jos sinulla on tulostin kytkettynä järjestelmääsi, laita se päälle ja valitse sitten File-valikon Print-komento. RTF-editori lähettää kopion asiakirjasta kirjoittimelle.

414 Visual Basic 6 Trainer 7 Valitse File-valikosta Exit-komento. Ohjelma sulkeutuu. Jos et ole tallentanut kaikkia muutoksia, RTF-editori pyytää sinua tallentamaan ne. Tapahtumankäsittelijät, jotka huolehtivat RTFmuotoilusta RTFEdit on monessa eri mielessä täysin toimiva tekstinkäsittelyohjelma. Jos tarvitset tämän kaltaista toiminnallisuutta Visual Basic -ohjelmassasi, voit lisätä sen nopeasti Rich Textbox ja Common Dialog -kontrollien avulla. Tarkastelkaamme jokaista Codeikkunan takana olevaa tapahtuma-aliohjelmaa, alkaen Format-valikossa olevilla valikkokomennoilla. Avaa jokainen tapahtumankäsittelijä Code-ikkunaan samalla hetkellä kun käsittelen niitä tekstissä. All Caps -komento Rich Textbox -kontrollin SelText-ominaisuus edustaa sillä hetkellä tekstiruudussa valittua tekstiä. Eräs yksinkertaisimmista muotoilutoiminnoista on yksi Visual Basicin sisäänrakennetuista funktioista, joka muokkaa tekstiä. UCase muuttaa pienet kirjaimet isoiksi. Jos teksti on jo isoilla kirjaimilla, funktiolla ei ole vaikutusta. Kun käyttäjä valitsee Format-valikon All Caps -komennon, Visual Basic suorittaa seuraavan tapahtuma-aliohjelma muuttaen tekstin: Private Sub mnuallcapsitem_click() RichTextBox1.SelText = UCase(RichTextBox1.SelText) Jos haluat muuttaa tekstin pieniksi kirjaimiksi, sinun tarvitsee yksinkertaisesti korvata UCase-komento LCase-komennolla. Font-komento Font-komento käyttää Common Dialog -kontrollin ShowFont-metodia, jolla avataan Font-valintaikkuna ja palautetaan valittu tieto RTFEdit-ohjelmaan. Näit aikaisemmin tässä kirjassa, kuinka Common Dialog -kontrollin Open, Save As ja Color -perusvalintaikkunoita käytettiin. Font-valintaikkunan avaaminen on vastaavanlainen toiminto. Huomaa, kuinka lähdekoodissa CommonDialog1-objektin palauttamat ominaisuudet on välittömästi liitetty RichTextBox1-objektin (ohjelmasi tekstiruutu) vastaaviin ominaisuuksiin. Rich Textbox -kontrolli voi tuottaa minkä tahansa Fontvalintaikkunan tarjoaman muotoilutyylin. Lähdekoodi on nähtävissä seuraavalla sivulla.

Harjoitus 15 Tekstinkäsittely Rich Textbox -kontrollin avulla 415 Private Sub mnufontitem_click() Force an error if the user clicks Cancel CommonDialog1.CancelError = True On Error GoTo Errhandler: Set flags for special effects and all available fonts CommonDialog1.Flags = cdlcfeffects Or cdlcfboth Display font dialog box CommonDialog1.ShowFont Set formatting properties with user selections: RichTextBox1.SelFontName = CommonDialog1.FontName RichTextBox1.SelFontSize = CommonDialog1.FontSize RichTextBox1.SelColor = CommonDialog1.Color RichTextBox1.SelBold = CommonDialog1.FontBold RichTextBox1.SelItalic = CommonDialog1.FontItalic RichTextBox1.SelUnderline = CommonDialog1.FontUnderline RichTextBox1.SelStrikeThru = CommonDialog1.FontStrikethru Errhandler: exit procedure if the user clicks Cancel 15 Rich Textbox -kontrolli Bold, Italic ja Underline -komennot Format-valikon Bold, Italic ja Underline -komennot ovat helposti hallittavissa Rich Textbox -kontrollissa. Ainoa vaikeus on varmistaa se, että jokainen komento toimii nappulana, eli komentona, joka muuttaa aktiivisen muotoilutilan vastakkaiseen tilaan. Esimerkiksi, Bold-komennon pitäisi muuttaa lihavoitu teksti tavalliseksi tekstiksi ja tavallisen tekstin lihavoiduksi. Tämä toiminto saadaan helposti aikaan käyttämällä loogista Not-operaattoria ohjelman lauseissa. Operaattori kääntää SelBold, SelItalic ja SelUnderline -ominaisuuksissa käytetyn Boolean-arvon. Käytä seuraavia ohjelmalauseita: Private Sub mnubolditem_click() RichTextBox1.SelBold = Not RichTextBox1.SelBold Private Sub mnuitalicitem_click() RichTextBox1.SelItalic = Not RichTextBox1.SelItalic Private Sub mnuunderlineitem_click() RichTextBox1.SelUnderline = Not RichTextBox1.SelUnderline

416 Visual Basic 6 Trainer Tekstin muokkaaminen Windowsin leikepöydällä Kun teet täysin ominaisuuksin varustetun tekstinkäsittelyohjelman, käyttäjillä pitää olla pääsy tekstinmuokkauksen peruskomentoihin, kuten Edit-valikon Cut (Leikkaa), Copy (Kopioi) ja Paste (Liitä). Kätevin tapa mahdollistaa tämä on käyttää Clipboard-objektin, joka yhdistää ohjelmasi leikepöydän tietoon, SetText ja GetText -metodeja. Tutkit tässä luvussa ohjelmalauseita, joita käytin tekstin leikkaamiseen, kopioimiseen ja liittämiseen leikepöytäobjektin kanssa. Tutkit myös kuinka tekstiä haetaan Find-metodin avulla. Suosittelen, että tutkit jokaista tapahtuma-aliohjelmaa Code-ikkunassa sillä aikaa, kun luet tätä tekstiä. Cut, Copy ja Paste -komennot RTFEdit-ohjelman Edit-valikko sisältää neljä komentoa: Cut, Copy, Paste ja Find. Kolme ensimmäistä toimintoa onnistuu helposti Clipboard-objektien SetText ja GetText -metodien ja Rich Textbox -objektin SelRTF-ominaisuuden avulla. Rich Textbox - objektin SelRTF-ominaisuus sisältää suorituksen aikana koko tekstin ja tekstiruutuun talletetun muotoilutiedon. Kun työskennellään Windowsin leikepöydän kanssa, tämä on ominaisuus, joka varastoi tiedon leikkaus, kopiointi ja liittämistoimintojen aikana. Sen lisäksi Clipboard-objektien SetText ja GetText -metodeja käytetään tekstin kopioimiseen sinne ja sieltä. Copy ja Cut -komentojen ainoa ero on siinä, että Cutkomento leikkaa valitun tekstin tekstiruudusta kopiointitoiminnon jälkeen ja Copykomento ei leikkaa tekstiä pois. Tässä on tarvittava ohjelmakoodi: Private Sub mnucopyitem_click() Clipboard.SetText RichTextBox1.SelRTF Private Sub mnucutitem_click() Clipboard.SetText RichTextBox1.SelRTF RichTextBox1.SelRTF = Private Sub mnupasteitem_click() RichTextBox1.SelRTF = Clipboard.GetText Find-komento Useimmat tekstinkäsittelyohjelmat sisältävät toiminnon, jonka avulla tekstiin voidaan suorittaa hakuja ja RTFEdit ei ole poikkeus. Find-komento onnistuu helposti Rich Textbox -objektin Find-metodin avulla. Metodi etsii määritettyä merkkijonoa

Harjoitus 15 Tekstinkäsittely Rich Textbox -kontrollin avulla 417 tekstiruudusta. Haun tarkat määritykset ohjataan seuraavilla asetuksilla: 15 RichTextBox1.Find(string, start, end, options) string-argumentti määrittelee tekstin, jonka haluat löytää tekstiruudusta. startargumentti määrittelee haun aloituspisteen (kokonaisluku ykkösestä asiakirjan merkkien määrään). end-argumentti on haun lopetuspiste. options-argumentti on joku seuraavista vakioista: rtfwholeword (koko sanan haku), rtfmatchcase (merkkikohtainen haku), rtfnohighlight (korosta löydetty merkkijono asiakirjasta). Seuraava tapahtuma-aliohjelma esittelee tavan, jolla voit etsiä ensimmäistä vastaavaa sanaa tekstiruudusta kysymällä käyttäjältä InputBox-funktion avulla. Span-metodi valitsee löydetyn sanan. Rich Textbox -kontrolli Private Sub mnufinditem_click() Dim SearchStr As String text used for search Dim FoundPos As Integer location of found text SearchStr = InputBox( Enter search word, Find ) If SearchStr <> Then if search string not empty find the first occurrence of the whole word FoundPos = RichTextBox1.Find(SearchStr,,, _ rtfwholeword) if the word is found (if not -1) If FoundPos <> -1 Then use Span method to select word (forward direction) RichTextBox1.Span, True, True Else MsgBox Search string not found,, Find End If End If Tiedostotoimintojen hallinta Rich Textbox -kontrollin avulla Haluat varmasti lisätä tiedostohallinan perustoiminnot RTF-ohjelmaasi. Tein tämän mahdolliseksi lisäämällä File-valikkoon Open, Close, Save As, Print ja Exit -komennot. Tutki seuraavia ohjelman lauseita Code-ikkunassa, niin näet, kuinka tärkeimmät tiedostohallinnan tehtävät hoidetaan Rich Textbox -objektilla. Tulet huomaamaan, että toiminta poikkeaa hieman aliohjelmasta, jota suosittelin tekstitiedostojen hallintaan harjoituksessa 12.

418 Visual Basic 6 Trainer Open-komento Tekstitiedostojen avaaminen Rich Textbox -objektissa on helppoa LoadFile-metodin avulla, metodi avaa määritetyn tiedoston tekstiruudussa. Varmista, että asetat ScrollBars-ominaisuuden arvoon rtfvertical Properties-ikkunassa, jos haluat tutkia asiakirjoja, jotka ovat pitempiä kuin yksi sivu. Kun lataat tiedoston tekstiruutuun, sinun pitää määrittää se, onko tiedosto RTF- vai tekstimuodossa. Tämä ero hoidetaan LoadFile-metodin rtfrtf ja rtftext -asetuksilla. Silloin kun asiakirja on talletettu RTF-muodossa, se sisältää joukon muotoilukoodeja, jotka ohjaavat lataavaa ohjelmaa siinä, kuinka tiedoston muotoilutieto näytetään. Jos lataa RTF-tiedoston "tekstinä", tekstiruudussa näkyvät myös itse koodit. (Esimerkkinä voit tutkia Lisätietoja-kohdassa olevaa harjoitusta, joka on tämän harjoituksen lopussa.) RTFEdit-ohjelman Open-komento asentaa yleisen valintaikkunan CancelErrorominaisuudeksi arvon True. Jos käyttäjä napsauttaa Open-valintaikkunan Cancelpainiketta, tapahtuma-aliohjelma ohittaa lataustoiminnon. ShowOpen-metodi näyttää Open-valintaikkunan, jonka avulla käyttäjä voi valita, minkä tiedoston hän haluaa ladata. LoadFile-metodi avaa yleisen valintaikkunan palauttaman tiedoston. Määritin myös rtfrtf-argumentin niin, että Rich Textbox -objekti muuttaa RTF-koodit niin, että muotoilu nähdään oikein. Private Sub mnuopenitem_click() CommonDialog1.CancelError = True On Error GoTo Errhandler: CommonDialog1.Flags = cdlofnfilemustexist CommonDialog1.ShowOpen RichTextBox1.LoadFile CommonDialog1.FileName, rtfrtf Errhandler: if Cancel clicked, then exit procedure Close-komento File-valikon Close-komennon käyttötarkoitus on yksinkertaisesti sulkea avattu RTFtiedosto tyhjentämällä tekstiruudun sisältö Text-metodilla ja tyhjällä merkkijonoargumentilla (""). Päätin kuitenkin lisätä muutaman ohjelmalauseen, jolla hoidan tärkeän lopetusehdon: määrittelen sen avulla, onko asiakirjassa tallentamattomia muutoksia ja jos näin on, pyydän käyttäjää tallentamaan ne. Loin tätä toimintoa varten Declarations-osassa yleisen muuttujan nimeltä UnsavedChanges, joka on tyyppiä Boolean. Dim UnsavedChanges As Boolean

Harjoitus 15 Tekstinkäsittely Rich Textbox -kontrollin avulla 419 Muuttuja on Boolean-tyyppiä siksi, että haluan sen säilyttävän True tai False -arvon, joka heijastaa sen nykyistä muutosten tilaa asiakirjassa (talletettu tai tallentamaton). UnsavedChanges saa arvon True, jos asiakirjassa on tallentamattomia muutoksia ja False, jos ei ole. Ohjelma hoitaa tämän muokkaustilan käyttämällä kätevää Rich Textbox -tapahtumaa nimeltä Change. Aina kun teksti muuttuu tai tekstiruudun muotoilua on muutettu, Rich Textbox -objekti laukaisee Change-tapahtuman ja suorittaa RichTextBox1_Change -tapahtuma-aliohjelmassa sijaitsevat ohjelmalauseet. Kun käytän tässä aliohjelmassa lausetta, joka asettaa UnsavedChanges-muuttujan arvoksi True, pystyn tarkastamaan tallentamattomat muutokset - eli ongelman, jonka haluan ottaa kiinni - silloin kun käyttäjä valitsee Close ja Exit -komennon. (Pystyisin myös tarkastamaan tämän muuttujan tilan Form_Unload -aliohjelmassa niin, että käyttäjää estetään sulkemaan lomake ilman sisällön tallennusta.) RichTextBox1_Change -tapahtuma-aliohjelma on seuraavanlainen: 15 Rich Textbox -kontrolli Private Sub RichTextBox1_Change() Set public variable UnsavedChanges to True each time the text in the Rich textbox is modified. UnsavedChanges = True Tarkastan Close-valikon tapahtuma-aliohjelmassa UnsavedChange-muuttujan arvon. Jos se on True (jos on tallentamattomia muutoksia), pyydän sanomaruudun avulla käyttäjää tallentamaan nuo muutokset. Jos käyttäjä päättää tallentaa muutokset, valintaikkuna Save As tiedustelee tiedoston nimen. Tiedosto tallennetaan sitten SaveFile-metodilla: Private Sub mnucloseitem_click() Dim Prompt As String Dim Reply As Integer jump to error handler if the Cancel button is clicked CommonDialog1.CancelError = True On Error GoTo Errhandler: If UnsavedChanges = True Then Prompt = Would you like to save your changes? Reply = MsgBox(Prompt, vbyesno) If Reply = vbyes Then CommonDialog1.ShowSave RichTextBox1.SaveFile CommonDialog1.FileName, _ rtfrtf End If End If (jatkuu)

420 Visual Basic 6 Trainer jatkuu RichTextBox1.Text = clear text box UnsavedChanges = False Errhandler: Cancel button clicked. Exit Sub Save As -komento Kun haluat tallentaa RTF-tiedoston, joka on juuri ladattu Rich Textbox -objektiin, kutsut SaveFile-metodia tiedoston nimellä ja argumentilla rtfrtf. (Vaikka en tee niin tässä ohjelmassa, voisit tallentaa tiedoston myös pelkässä tekstimuodossa määrittelemällä argumentin rtftext. On tavallista, että haluat määrittää tallennetulle tiedostolle polkunimen käyttämällä yleisen valintaikkunan FileName-ominaisuutta. Annoin ohjelmassani mahdollisuuden peruuttaa tallennustoiminto napsauttamalla Save As -valintaikkunan Cancel-painiketta. Private Sub mnusaveasitem_click() CommonDialog1.CancelError = True On Error GoTo Errhandler: CommonDialog1.ShowSave save specified file in RTF format RichTextBox1.SaveFile CommonDialog1.FileName, rtfrtf UnsavedChanges = False Errhandler: Cancel button clicked Print-komento Tulostaminen on aika yksinkertaista Rich Textbox -objektissa. Käytät yksinkertaisesti SelPrint-metodia ja määrität sisäisen osoitteen tai laitekahvan kirjoittimelle, jota haluat käyttää. Tässä ohjelmassa tulostaminen on mahdollista käyttämällä Printer-objektia ja hdc-ominaisuutta, joka sisältää aktiivisen järjestelmäkirjoittimen kahvan: Private Sub mnuprintitem_click() Prints the current document using the device handle of the current printer RichTextBox1.SelPrint (Printer.hDC)

Harjoitus 15 Tekstinkäsittely Rich Textbox -kontrollin avulla 421 Exit-komento Exit-komennon päätarkoitus on sulkea ohjelma End-lauseen avulla. Samalla tavalla kuin edellä mainitussa Close-komennossa, olen lisännyt kuitenkin ohjelmalauseet, jotka tarkastavat ensin, onko asiakirjassa tallentamattomia muutoksia, ennen kuin sallin ohjelman sulkeutua ja hylätä käyttäjän tiedon pysyvästi. Testaan jälleen aktiivisen tallennustilan käyttämällä julkista muuttujaa UnsavedChanges, ja annan käyttäjälle mahdollisuuden tallentaa kaikki tallentamattomat muutokset. Huomaa, että samoin kuin Close-komento, Exit-komentokin määrittää UnsavedChanges-muuttujan arvoksi False ennen tiedoston tallentamista levylle. Private Sub mnuexititem_click () Dim Prompt As String Dim Reply As Integer CommonDialog1.CancelError = True On Error GoTo Errhandler: If UnsavedChanges = True Then Prompt = Would you like to save your changes? Reply = MsgBox(Prompt, vbyesno) If Reply = vbyes Then CommonDialog1.ShowSave RichTextBox1.SaveFile CommonDialog1.FileName, _ rtfrtf UnsavedChanges = False End If End If End after file has been saved, quit program Errhandler: Cancel button clicked (return to program) 15 Rich Textbox -kontrolli RTF-koodien näyttäminen asiakirjassa Kuten olet oppinut, Rich Textbox -kontrollin avulla voidaan asiakirjaan luoda kehittyneitä efektejä lisäämällä erikoiskoodeja tiedostoosi käyttämällä muotoilu-schemaa nimeltä RTF. Koska Rich Textbox -kontrolli pystyy näyttämään myös suoria tekstitiedostoja, voit tutkia asiakirjan muotoilukoodeja läheltä, jos haluat lisää tietoa RTF:stä. Jos haluat muuttaa RTFEdit-ohjelmaa niin, että se avaa tiedostot tekstitilassa ja näyttää RTF-muotoilun, käy läpi seuraavalla sivulla olevat vaiheet.

422 Visual Basic 6 Trainer Tutki RTF-koodia 1 Avaa Code-ikkuna ja valitse mnuopenitem -tapahtuma-aliohjelma Objectpudotusvalikosta. 2 Muuta ohjelman lause, joka lataa RTF-tiedoston tapahtuma-aliohjelmassa seuraavanlaiseksi: RichTextBox1.LoadFile CommonDialog1.FileName, rtftext Start-painike Huomaa, että lauseen viimeinen argumentti on muutettu arvosta rtfrtf arvoksi rtftext. 3 Napsauta työkalurivin Start-painiketta ja valitse sitten File-valikon Open-komento. 4 Avaa sample.rtf-tiedosto, jonka loit aikaisemmin tässä harjoituksessa. Jos haluat, voit avata jonkin muun RTF-tiedoston. Lomakkeesi tulee näyttämään seuraavanlaiselta: 5 Tutki muutama minuutti asiakirjan RTF-koodeja. Näet tietoa fontista, väristä, tekstin tyylistä, keskityksestä ja niin edelleen. Jossain keskellä näet myös tekstin. (Tämä selittää sen, miksi tekstinkäsittelytiedostot ovat niin isoja!) 6 Valitse Exit-komento File-valikosta sulkien ohjelman. Napsauta No, jos sinua pyydetään tallentamaan muutokset. 7 Muuta rtftext-argumentti takaisin arvoksi rtfrtf mnuopenitem_click -tapahtumaaliohjelmassa. Onnittelut! Olet valmis luomaan omia RTF-asiakirjoja ja (jos haluat) täysin ominaisuuksin varustetun tekstinkäsittelyohjelman.

Harjoitus 15 Tekstinkäsittely Rich Textbox -kontrollin avulla 423 Jos haluat jatkaa seuraavaan harjoitukseen 15 _ Pidä Visual Basic käynnissä ja siirry harjoitukseen 16. Jos haluat sulkea Visual Basicin nyt _ Valitse File-valikosta Exit. Jos näet Save As -valintaikkunan, valitse Yes. Tallenna kaikki RTF Editor -ohjelmaan tehdyt muutokset MyRTFEditor-tiedostoon. Harjoitus 15 Pikaopas Tehtävä Ohje Rich Textbox -kontrolli Asentaa Professional Edition ActiveX -kontrollit Muuttaa valittu teksti isoiksi kirjaimiksi Rich Textbox -objektissa Näyttää Fontvalintaikkuna Muuttaa valitun tekstin muotoilu lihavoiduksi Muuttaa valitun tekstin muotoilu kursiiviksi Muuttaa valitun tekstin muotoilu alleviivatuksi Kopioida valittu teksti Windowsin leikepöydälle Leikata valittu teksti Valitse Project-valikon Components-komento, napsauta Controls-välilehteä ja napsauta sitten sen ActiveX-kontrollin, jonka haluat asentaa, vieressä olevaa valintaruutua. Käytä UCase-funktiota. Esimerkki: RichTextBox1.SelText = _ Ucase(RichTextBox1.SelText) Käytä yleisen valintaikkunaobjektin ShowFont-metodia. Esimerkki: CommonDialog1.ShowFont Käytä SelBold-ominaisuutta. Esimerkki: RichTextBox1.SelBold = Not RichTextBox1.SelBold Käytä SelItalic-ominaisuutta. Esimerkki: RichTextBox1.SelItalic = _ Not RichTextBox1.SelItalic Käytä SelUnderline-ominaisuutta. Esimerkki: RichTextBox1.SelUnderline = _ Not RichTextBox1.SelUnderline Käytä Clipboard-objektia ja SetText-metodia. Esimerkki: Clipboard.SetText RichTextBox1.SelRTF Käytä Clipboard-objektia ja SetText-metodia ja tyhjennä sitten teksti. Esimerkki: Clipboard.SetText RichTextBox1.SelRTF RichTextBox1.SelRTF =

424 Visual Basic 6 Trainer Harjoitus 15 Pikaopas Tehtävä Liittää teksti lisäyskohtaan Löytää teksti Rich Textbox -objektista Ladata RTF-tiedosto Sulkea RTF-tiedosto Tallentaa RTFtiedosto Tulostaa RTFtiedosto Sulkea ohjelma Ohje Käytä Clipboard-objektia ja GetText-metodia. Esimerkki: RichTextBox1.SelRTF = Clipboard.GetText Käytä Find-metodia. Jos haluat esimerkiksi löytää sanan Monday ensimmäisen esiintymän tekstiruudussa: RichTextBox1.Find( Monday,,, rtfwholeword) Käytä LoadFile-metodia. Esimerkki: CommonDialog1.ShowOpen RichTextBox1.LoadFile CommonDialog1.FileName, _ rtfrtf Tyhjennä tekstiruudun sisältö Text-ominaisuudella. Esimerkki: RichTextBox1.Text = Käytä SaveFile-metodia. Esimerkki: CommonDialog1.ShowSave RichTextBox1.SaveFile CommonDialog1.FileName, _ rtfrtf Käytä SelPrint-metodia. Esimerkki: RichTextBox1.SelPrint (Printer.hDC) Käytä End-lausetta.