A RichTextBox SelectionChanged eseménye akkor fut le, amikor a kijelölés vagy a kurzor helye megváltozik: kattintáskor, a nyílbillentyűk használatakor, szöveg kijelölésekor és gépeléskor is (hiszen a kurzor ilyenkor továbblép). Ugyanúgy hozható létre, mint a többi esemény: Properties ablak, villám ikon (Events), dupla kattintás a SelectionChanged sorra.

Jósolj!

Egy szóra duplán kattintasz (kijelöli), majd megnyomod a jobbra nyilat. Hányszor fut le a SelectionChanged és a TextChanged?

Tegyél a MiniWord ablakának aljára egy lblAllapot feliratot, és írd meg a SelectionChanged eseménykezelőt:

private void rtbDokumentum_SelectionChanged(object sender, EventArgs e)
{
    int kurzor = rtbDokumentum.SelectionStart;
    int sor = rtbDokumentum.GetLineFromCharIndex(kurzor);
    int oszlop = kurzor - rtbDokumentum.GetFirstCharIndexFromLine(sor);

    lblAllapot.Text = $"Sor: {sor + 1}, Oszlop: {oszlop + 1}, Kijelölve: {rtbDokumentum.SelectionLength} karakter";
}

A sor a képernyőn látható sor

A GetLineFromCharIndex a sorokat úgy számolja, ahogy a szövegdobozban megjelennek. Ha egy hosszú bekezdés az ablak szélén több sorba tör, a törés után új sornak számít. Ez a Wordhöz hasonló viselkedés, és a sorszám az ablak átméretezésekor megváltozhat.

Jósolj!

A szöveg: Alma Enter körte. A kurzor a „körte” szó „r” betűje előtt áll. Mit ír ki a felirat sorra és oszlopra?

A SelectionFont tulajdonságból kiolvashatjuk, hogy a kijelölt szöveg félkövér, dőlt vagy aláhúzott-e (2.4 lecke). A Font objektumnak vannak olvasható tulajdonságai: Bold, Italic, Underline, amelyek igaz/hamis értéket adnak. A gomb hátterét ennek megfelelően színezzük:

private void GombokFrissitese()
{
    Font f = rtbDokumentum.SelectionFont;

    if (f == null)
    {
        return;
    }

    btnFelkover.BackColor = f.Bold ? Color.LightSkyBlue : SystemColors.Control;
    btnDolt.BackColor = f.Italic ? Color.LightSkyBlue : SystemColors.Control;
    btnAlahuzott.BackColor = f.Underline ? Color.LightSkyBlue : SystemColors.Control;
}

A SelectionChanged eseménykezelőben hívd meg a GombokFrissitese() metódust. A betűtípus- és méretlistákat is érdemes frissíteni, ehhez azonban vigyázni kell, ahogy a következő szakasz mutatja.

Jósolj!

Félkövér szóra kattintasz. Milyen színű lesz a félkövér (F) gomb? És a dőlt (D) gomb, ha a szó nem dőlt?

Szeretnénk, hogy a betűtípus- és méretlista is mutassa a kijelölés értékét. A kézenfekvő megoldás: a SelectionChanged eseményben beállítjuk a listák szövegét. De itt egy veszélyes hurok lappang:

A lista átállítása kiváltja a SelectedIndexChanged eseményt (2.5 lecke), amely a kijelölt szövegre alkalmazza a listában látható betűtípust. Ha a kijelölés vegyes formázású vagy a lista értéke nem pontosan egyezik, a program véletlenül átformázhatja a szöveget, amelyre csak rákattintottál.

A megoldás egy jelzőváltozó (angolul flag): egy bool típusú mező, amely megmondja, hogy éppen a program frissíti-e a listát, és nem a felhasználó választ belőle.

private bool frissites = false;

private void rtbDokumentum_SelectionChanged(object sender, EventArgs e)
{
    Font f = rtbDokumentum.SelectionFont;

    if (f != null)
    {
        frissites = true;

        cmbBetutipus.Text = f.FontFamily.Name;
        cmbMeret.Text = f.Size.ToString();

        frissites = false;
    }

    GombokFrissitese();
}

private void cmbBetutipus_SelectedIndexChanged(object sender, EventArgs e)
{
    if (frissites)
    {
        return;
    }

    // ... a 2.5 leckében megírt kód ...
}

private void cmbMeret_SelectedIndexChanged(object sender, EventArgs e)
{
    if (frissites)
    {
        return;
    }

    // ... a 2.5 leckében megírt kód ...
}

Gyakori minta

Ha egy vezérlő értékét a program állítja be, és a vezérlő eseménye ettől lefut, a jelzőváltozós védelem általános megoldás. Később más programoknál is találkozol vele.

Jósolj!

A frissites jelző nélkül egy Arial és egy Verdana szóból álló szövegben az Arial szóra kattintasz. Mi történhet a kijelölt szóval?

Mi a baj, és hogyan javítod?

Gondold végig az okot, és csak utána nyisd le a megoldást.

1. Átformázódik a szöveg

Egy szóra kattintasz, és a szöveg formázása váratlanul megváltozik.

2. NullReferenceException

cmbBetutipus.Text = rtbDokumentum.SelectionFont.FontFamily.Name;

3. Az oszlop eggyel kevesebb

A szöveg elején álló kurzornál a felirat „Oszlop: 0” értéket mutat.

4. A felirat csak kattintásra frissül

A nyílbillentyűvel mozgatod a kurzort, de a sor és az oszlop nem változik.

5. A gombok színe nem változik vissza

if (f.Bold)
{
    btnFelkover.BackColor = Color.LightSkyBlue;
}

Három önálló gyakorlófeladat

Egyszerre csak egyet csinálj: tervezd meg, írd meg, futtasd, ellenőrizd, és csak utána nyisd ki a megoldást.

lblAllapot.Text = lblAllapot.Text + $", Igazítás: {rtbDokumentum.SelectionAlignment}";

pnlSzin.BackColor = rtbDokumentum.SelectionColor;

string kijelolt = rtbDokumentum.SelectedText;

if (kijelolt.Length > 20)
{
    kijelolt = kijelolt.Substring(0, 20) + "...";
}

if (kijelolt.Length > 0)
{
    lblAllapot.Text = lblAllapot.Text + $" | Kijelölt: {kijelolt}";
}

Három szinten gyakorolhatsz: alap, közepes és kihívás. A feladatokhoz a MiniWord rtbDokumentum RichTextBoxa és egy lblAllapot felirat kell. A SelectionChanged eseménykezelőbe kerül minden kód. Csak a próbálkozás után nyisd le a megoldást.

Alap szint

private void rtbDokumentum_SelectionChanged(object sender, EventArgs e)
{
    int sor = rtbDokumentum.GetLineFromCharIndex(rtbDokumentum.SelectionStart) + 1;
    int osszes = rtbDokumentum.GetLineFromCharIndex(rtbDokumentum.TextLength) + 1;

    lblAllapot.Text = $"Sor: {sor} / {osszes}";
}

private void rtbDokumentum_SelectionChanged(object sender, EventArgs e)
{
    if (rtbDokumentum.SelectionLength > 0)
    {
        lblAllapot.Text = $"{rtbDokumentum.SelectionLength} karakter kijelölve";
    }
    else
    {
        lblAllapot.Text = "";
    }
}

Közepes szint

private void rtbDokumentum_SelectionChanged(object sender, EventArgs e)
{
    Font f = rtbDokumentum.SelectionFont;

    if (f == null)
    {
        return;
    }

    btnFelkover.BackColor = f.Bold ? Color.LightSkyBlue : SystemColors.Control;
}

private bool frissites = false;

private void rtbDokumentum_SelectionChanged(object sender, EventArgs e)
{
    Font f = rtbDokumentum.SelectionFont;

    if (f != null)
    {
        frissites = true;
        cmbMeret.Text = f.Size.ToString();
        frissites = false;
    }
}

private void cmbMeret_SelectedIndexChanged(object sender, EventArgs e)
{
    if (frissites)
    {
        return;
    }

    // a méretváltoztatás kódja
}

Kihívás szint

private void rtbDokumentum_SelectionChanged(object sender, EventArgs e)
{
    Font f = rtbDokumentum.SelectionFont;

    if (f == null)
    {
        lblAllapot.Text = "Vegyes formázás";
    }
    else
    {
        lblAllapot.Text = $"{f.FontFamily.Name}, {f.Size} pt";
    }
}

private void rtbDokumentum_SelectionChanged(object sender, EventArgs e)
{
    int hossz = Math.Max(1, rtbDokumentum.TextLength);
    int szazalek = 100 * rtbDokumentum.SelectionStart / hossz;

    lblAllapot.Text = szazalek + " %";
}

Gyors önellenőrzés

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