Ebben a fejezetben egyetlen programot építünk lépésről lépésre: egy Word-szerű szövegszerkesztőt. A következő leckék mindig ugyanezt a projektet bővítik, ezért érdemes külön, jól elnevezett projektet nyitni.

1. Visual Studio → Create a new project, és válaszd a Windows Forms App sablont. A .NET Framework és az újabb .NET változat is jó ehhez a leckéhez.
2. A projekt neve legyen MiniWord, majd kattints a Create gombra.
3. Kattints az üres ablakra, és a Properties ablakban írd át a Text tulajdonságot MiniWord-re. Ez lesz az ablak címsora.

Te jössz!

Hozd létre a projektet, írd át az ablak címét, majd futtasd az F5 billentyűvel. Egy üres, MiniWord feliratú ablaknak kell megjelennie. Zárd be, és térj vissza a Visual Studióba.

Húzz a Toolboxból (View → Toolbox) egy RichTextBox-ot az ablakra, és alá egy Label-t. A RichTextBox a Common Controls csoportban található; ha nem látod, használd a Toolbox keresőmezőjét.

Miért nem a már ismert TextBox kell? A TextBox az egész szöveget egyetlen formátumban jeleníti meg. A RichTextBox formázott szöveget is kezel: az egyik szó lehet félkövér, a másik dőlt, a harmadik nagyobb betűméretű. Ráadásul RTF fájlokat is meg tud nyitni és el tud menteni. A szövegszerkesztőnknek pontosan erre van szüksége.

Állítsd be a Properties ablakban a két vezérlő tulajdonságait:

Az Anchor azt adja meg, melyik ablakszélhez „kapcsolódjon” a vezérlő, amikor átméretezed az ablakot. A szövegdoboz így együtt nő az ablakkal, a számláló pedig az alsó sarokban marad. A részletekről a 6.2 leckében lesz szó.

Miért rtbDokumentum és lblKarakterszam?

A név elé rövid előtagot teszünk: rtb = RichTextBox, lbl = Label. Később több tucat vezérlő lesz az ablakon, és az előtagból azonnal látod, melyik milyen típusú. A (Name) és a Text két külön tulajdonság: az egyik a programozónak, a másik a felhasználónak szól. A leckék kódjai az itt megadott nevekkel működnek.

A konzolos programban a program döntötte el, mikor jön a felhasználó: a Console.ReadLine() megállt, és várt. Az ablakos program fordítva működik. Az ablak nyitva van, a felhasználó pedig bármikor bármit csinálhat: kattinthat, gépelhet, törölhet. Ezeket nevezzük eseményeknek.

Olyan ez, mint a csengő. Nem állsz folyamatosan az ajtónál, hanem akkor mész oda, amikor megszólal. Az eseménykezelő az a metódus, amely akkor fut le, amikor az esemény bekövetkezik. A metódus kódját mi írjuk meg.

A szövegdobozunk TextChanged eseménye minden alkalommal jelez, amikor a szöveg megváltozik. Így hozhatod létre az eseménykezelőt:

1. Jelöld ki a RichTextBoxot a Designerben.
2. A Properties ablakban kattints a villám ikonra (Events).
3. Keresd meg a TextChanged sort, és kattints duplán az üres mezőjére.

A Visual Studio elkészíti az üres eseménykezelőt, és megnyitja a Form1.cs fájlt:

private void rtbDokumentum_TextChanged(object sender, EventArgs e)
{
    // Ide írjuk a kódot. Ez fut le minden szövegváltozáskor.
}

Ne töröld kézzel az eseménykezelőt!

A Visual Studio a háttérben a Form1.Designer.cs fájlban összeköti az eseményt a metódussal. Ha csak a metódust törlöd, a program le sem fordul. Erről a hibavadászatnál lesz szó.

Most már csak azt kell megmondanunk, mi történjen szövegváltozáskor: számoljuk meg a karaktereket, és írjuk ki az eredményt a címkére.

private void rtbDokumentum_TextChanged(object sender, EventArgs e)
{
    lblKarakterszam.Text = $"Karakterek: {rtbDokumentum.Text.Length}";
}

Jósolj, mielőtt futtatod!

Beírod a Szia szót, majd két szóközt. Mit fog mutatni a számláló?

Működik!

Az eseménykezelő minden szövegváltozáskor lefut: gépeléskor, törléskor, beillesztéskor is. A számláló ezért mindig naprakész.

A RichTextBox kétféleképp adja vissza a tartalmát:

A formázási jelölések egy része így néz ki: {\rtf1\ansi ...}. Ezeket a Word is megérti, a felhasználónak viszont nem szabad látnia őket. Mentéskor az Rtf fog kelleni, a karakterszámláló viszont a Text-et használja.

Kísérlet

Írd át ideiglenesen a számláló sorát úgy, hogy rtbDokumentum.Rtf.Length szerepeljen a Text.Length helyén. Mit mutat üres dokumentumnál? 0-t?

Minden karakter számít: betű, szám, szóköz, írásjel és a sortörés is. Az Enter a RichTextBox.Text értékében egyetlen sortörés-karakter (\n). A sima TextBox ezzel szemben két karaktert használ (\r\n). Ez az egyik apró különbség a két vezérlő között.

Jósolj, aztán próbáld ki!

Beírod, hogy ab, megnyomod az Entert, majd beírod, hogy cd. Hány karaktert mutat a számláló?

Minden feladatnál először írd le a várható eredményt, és csak utána próbáld ki a programban.

1. Három betű és két szóköz

Beírod, hogy abc, majd két szóközt. Mit mutat a számláló?

2. Két sor

Beírod: Szia, Enter, Peti. Hány karaktert mutat?

3. Törlés gomb

Az ablakon van egy btnTorles gomb. Mit mutat a számláló, miután megnyomod?

private void btnTorles_Click(object sender, EventArgs e)
{
    rtbDokumentum.Clear();
}

Hibavadászat

Először jósold meg, hogy a hiba fordításkor, futás közben vagy a működésben jelentkezik. Csak utána nyisd le a megoldást.

1. Szám a szöveg helyén

lblKarakterszam.Text = rtbDokumentum.Text.Length;

2. Nem történik semmi

// A metódust kézzel gépelted be a Form1.cs-be
private void rtbDokumentum_TextChanged(object sender, EventArgs e)
{
    lblKarakterszam.Text = $"Karakterek: {rtbDokumentum.Text.Length}";
}

3. Ismeretlen név

lblKarakterszam.Text = $"Karakterek: {rtbDokumentum.Text.Length}";
// hibaüzenet: The name 'lblKarakterszam' does not exist in the current context

4. Törölt eseménykezelő

Kitörölted a rtbDokumentum_TextChanged metódust a Form1.cs fájlból, a program pedig nem fordul le.

// Form1.Designer.cs – hibaüzenet (CS1061):
// 'Form1' does not contain a definition for 'rtbDokumentum_TextChanged'

Önálló gyakorlófeladatok

Először készíts saját megoldást. A lenyitható rész csak ellenőrzéshez van.

private void btnTorles_Click(object sender, EventArgs e)
{
    rtbDokumentum.Clear();
}

private void rtbDokumentum_TextChanged(object sender, EventArgs e)
{
    lblKarakterszam.Text = $"Karakterek: {rtbDokumentum.Text.Length}";
    this.Text = $"MiniWord – {rtbDokumentum.Text.Length} karakter";
}

private void rtbDokumentum_TextChanged(object sender, EventArgs e)
{
    int darab = rtbDokumentum.Text.Length;
    lblKarakterszam.Text = $"Karakterek: {darab}";

    if (darab > 100)
    {
        lblKarakterszam.ForeColor = Color.Red;
    }
    else
    {
        lblKarakterszam.ForeColor = Color.Black;
    }
}

Három szinten gyakorolhatsz: alap, közepes és kihívás. A feladatokhoz egy rtbDokumentum RichTextBox és a leírt feliratok kellenek. Csak a próbálkozás után nyisd le a megoldást.

Alap szint

private void rtbDokumentum_TextChanged(object sender, EventArgs e)
{
    lblKarakterszam.Text = $"Karakterek: {rtbDokumentum.Text.Length}";
}

private void rtbDokumentum_TextChanged(object sender, EventArgs e)
{
    lblSorok.Text = $"Sorok: {rtbDokumentum.Lines.Length}";
}

Közepes szint

private void rtbDokumentum_TextChanged(object sender, EventArgs e)
{
    int szavak = 0;

    foreach (string sor in rtbDokumentum.Lines)
    {
        szavak = szavak + sor.Split(new char[] { ' ' }, StringSplitOptions.RemoveEmptyEntries).Length;
    }

    lblSzavak.Text = $"Szavak: {szavak}";
}

private void rtbDokumentum_TextChanged(object sender, EventArgs e)
{
    int hossz = rtbDokumentum.Text.Length;

    if (hossz <= 200)
    {
        lblKarakterszam.Text = $"Karakterek: {hossz}";
        lblKarakterszam.ForeColor = Color.SeaGreen;
    }
    else
    {
        lblKarakterszam.Text = $"Karakterek: {hossz} ({hossz - 200} felett)";
        lblKarakterszam.ForeColor = Color.Firebrick;
    }
}

Kihívás szint

private void rtbDokumentum_TextChanged(object sender, EventArgs e)
{
    int szokozNelkul = rtbDokumentum.Text.Replace(" ", "").Length;
    lblSzokozNelkul.Text = $"Szóköz nélkül: {szokozNelkul}";
}

private void Statisztika()
{
    int karakterek = rtbDokumentum.Text.Length;
    int sorok = rtbDokumentum.Lines.Length;
    int szavak = 0;

    foreach (string sor in rtbDokumentum.Lines)
    {
        szavak = szavak + sor.Split(new char[] { ' ' }, StringSplitOptions.RemoveEmptyEntries).Length;
    }

    lblStat.Text = $"Karakterek: {karakterek} | Szavak: {szavak} | Sorok: {sorok}";
}

private void rtbDokumentum_TextChanged(object sender, EventArgs e)
{
    Statisztika();
}

Gyors önellenőrzés

Válaszolj fejben, és csak utána nyisd le a választ.