Yksinkertaisen ohjelman koodaaminen Cocoalla

Tässä olisi nyt sitten ohjeet siitä miten Applen Cocoalla voi koodata yksinkertaisen autolaskurin. Ohjelma ei juuri muuta osaa kuin kasvattaa tekstikentän lukemaa yhdellä nappia painettaessa.

Ohje olettaa, että käytössä on XCoden versio 3.*

Luodaan uusi Cocoa projekti

Avaa XCode
Valitse File -> New Project
Luo uusi Cocoa Application

Luodaan graafinen ulkoasu

Avaa nib/xib -tiedosto Resources-kansiosta, jolloin Interface Builder -ohjelma käynnistyy
Avaa Library- ja Inspector-ikkunat mikäli ne eivät ole valmiina auki (Tools-valikosta löytyy)
Vedä ikkunaan haluamasi näköinen nappi (* Button / NSButton) ja tekstikenttä (Label / NSTextField)
Muuta napin tekstiksi "Henkilöautoja" tupla-klikkaamalla nappia tai Inspector-ikkunan Attributes-välilehdeltä Title-valinnasta
Muokkaa tekstikenttää
1. Valitse tekstikenttä
2. Valitse Font-valikosta Show Font (Omppu+F) ja muuta fontti sopivaksi
3. Siirry Inspector-ikkunan Attributes-välilehdelle
4. Valitse Alignmentiksi keskitetty
5. Pistä rasti Draws Background kenttään ja valitse jokin mukava taustaväri
Asemoi komponentit ja pienennnä ikkunaa sopivasti
Tallenna muutokset

Luodaan AppControl Controlli luokka

Luodaan seuraavaksi ohjelman "aivot" eli control-luokka, johon ohjelman kaikki koodi kirjotetaan.

Klikkaa Classes-kansiota oikealla napilla, valitse Add -> New File...
Valitse Objective-C class
Anna luokalle nimeksi AppControl.m

Luodaan AppControlliin yksi Outlet ja yksi Action. Muokkaa AppControl.h -tiedostoa:

#import <Cocoa/Cocoa.h>

// Luodaan uusi AppControl niminen luokka, joka peritään NSObject-luokasta /
@interface AppControl : NSObject {
    // Outlet, jonka avulla AppControll tuntee nib-tiedoston tekstikentän
    IBOutlet NSTextField* tekstikentta;
 }

// Action-metodi, jota nappi kutsuu painettaessa.
-(IBAction)kasvata:(id)sender;

@end

Luodaan tämän jälkeen AppControl-luokan totautus AppControl.m -tiedostoon:

#import "AppControl.h"

@implementation AppControl

-(IBAction)kasvata:(id)sender
{
    // Kasvatetaan tekstikentän arvoa yhdellä
    [tekstikentta setIntValue:[tekstikentta intValue]+1];
}

@end

Luodaan yhteydet nib-tiedostossa

Jotta AppControl voisi toimia yhteistyössä nib-tiedoston komponenttien kanssa, on niiden ensin tunnettava toisensa. Tämä saadaan aikaan luomalla nib-tiedostoon uusi AppControllin ilmentymä. Tämän jälkeen AppControllin ilmentymälle kerrotaan tekstikentta-outletin avulla missä haluttu tekstikenttä on. Napille kerrotaan, että sen tulee lähettää AppControllille kasvata:-viesti kun käyttäjä klikkaa sitä.

Siirry takaisin Interface Builder -ohjelmaan
Etsi Librarystä Object (NSObject) komponentti ja vedä se Dock-ikkunaan (Mainmenu.nib).
Valitse juuri luotu Object-komponentti ja siirry Inspector-ikkunan Identity-välilehdelle
Muuta Object AppControl-olioksi kirjoittamalla Class-kentään AppControl. Huomaa, että komponentin nimeksi Dock-ikkunassa tuli nyt App Control
Klikkaa Dock-ikkunassa olevaa App Controll -komponettia oikealla napilla (tai vasemmalla ctrl-pohjas)
Tartu tekstikentta-outeltin oikealla puolella olevaan pallukaan ja vedä siitä viiva ikkunassa olevan tekstikentän päälle. Vapauta hiiren nappi.
Paina hiiren oikea nappi pohjaan ikkunassa olevan napin päällä (tai vasemmalla ctrl-pohjas) ja vedä viiva Dock ikkunassa olevan App Control -komponentin päälle. VApauta hiiri. Valitse kasvata:.
Tallenna muutokset