WINNEW([otsikko],[x],[y],[leveys],[korkeus],[tyyli])

Selitys

WINNEW() funktiolla luodaan ikkunoita ja ikkunoiden objekteja.

Parametrit

[otsikko] ikkunan otsikko. Otsikon voi jättää pois.
[x] ikkunan oikea reuna pikseleissä kuvaruuden reunasta katsoen. Jos jätetään pois ohjelma käyttää nollaa.
[y] ikkunan yläreuna pikseleissä kuvaruuden yläreunasta katsoen. Jos jätetään pois ohjelma käyttää nollaa.
[leveys] ja [korkeus] ikkunan ulkomitat tai [korkeus] pikseleissä. Jos [leveys] ja [korkeus] ovat negatiiviset ohjelma luo ikkunan siten, että sen sisäala on -korkeus ja -leveys. Jos jätetään pois ohjelma käyttää tyylistä riippuvaa arvoa.
[tyyli] on ikkunan tyyli. Kt. MicroSoftin ns. Window Styles opasteista. Tähän annetaan numero, joka on summa WS_BORDER, WS_CAPTION, jne. numeroista
Jos tämän parametrin jättää pois ohjelma käyttää WS_CAPTION + WS_THICKFRAME + WS_SYSMENU + WS_MAXIMIZEBOX + WS_MINIMIZEBOX eli 12582912 + 262144 + 524288 + 65536 + 131072 = 13565952. Kt. tyylit

Palautusarvo

Funktio palauttaa ikkunapidikkeen tai nollan jos funktio epäonnistuu.

Esimerkki

Kun ikkuna luodaan se kannattaa tehdä seuraavasti (kt. esimerkki Kaksi yksinkertaista ikkunaa):

• Ensin talleta muistiin vanha aktiivinen ikkuna setwindow() -funktiolla
• Sitten luo uusi ikkuna winnew() -funktiolla
• Aseta uusi ikkuna aktiiviseksi setwindow() -funktiolla
• Odota napin painallusta esim. inkey() -funktiolla tai muuten jää odottamaan kunnes uusi ikkuna on tarkoitus sulkeutua.
• Aseta vanha ikkuna takaisin aktiiviseksi setwindow() -funktiolla
• Tuhoa uusi ikkuna destroywin() -funktiolla vasta kun vanha ikkuna on aktiivinen, jottei tule tilannetta, jossa aktiivinen ikkuna on tuhottu.

Kaksi yksinkertaista ikkuna

vanha=setwindow() /* muuttujaan vanha tallentuu edellisen aktiivisen ikkunan pidike. Esim. kuvassa alla oleva ikkuna. */
test1=winnew("Ikkuna 1",50,10,200,100) /* kuvaruutuun tulee uusi ikkuna, jonka vasen ylänurkka on koodinaateissa (x=50,y=10) ja jonka leveys on 200 pikseliä ja korkeus 100. Ikkunan yläpalkissa on teksti Ikkuna. Muuttujan test saa ikkunapidikkeen. */
test2=winnew("Ikkuna 2",300,10,-200,-100) /* kuvaruutuun tulee uusi ikkuna, jonka vasen ylänurkka on koodinaateissa (x=300,y=10) ja jonka sisäleveys on 200 pikseliä ja sisäkorkeus 100. Ikkunan yläpalkissa on teksti Ikkuna. Muuttujan test saa ikkunapidikkeen. */
setwindow(test1) /* muuttujan test1 ikkunapidike asetetaan aktiiviseksi */
? test1 /* ikkunaan tulee muuttujaan test sisältämä numero */
inkey(0) /* ohjelma jää odottamaan kunnes jotain nappia tai hiirtä painetaan */
setwindow(vanha) /* muuttujan vanha ikkunapidike asetetaan aktiiviseksi */
destroywin(test1) /* ikkuna, jonka pidike on test1 tuhotaan */
destroywin(test2)

Ikkuna, jossa on käytetty tyyliä

vanha=setwindow()
test1=winnew("Ikkuna 1",50,10,200,100,12582912+262144) /* Tyyli on WS_CAPTION + WS_THICKFRAME */
setwindow(test1)
inkey(0)
setwindow(vanha)
destroywin(test1)

Katso myös DESTROYWIN(), SETWINDOW(), CREATEBUTTON()