A RichTextBox minden alapvető szerkesztő műveletet kínál metódusként. A billentyűkombinációk (Ctrl+Z, Ctrl+Y, Ctrl+X, Ctrl+C, Ctrl+V, Ctrl+A) mindenféle kód nélkül működnek benne:

Két tulajdonság is segít: a CanUndo és a CanRedo igaz/hamis értéke megmondja, van-e mit visszavonni, illetve újra végrehajtani.

Jósolj!

Frissen elindítottad a MiniWordöt, még semmit nem gépeltél. Mi a CanUndo értéke? Beírsz egy szót. Mi lesz az értéke? Visszavonod, mi lesz a CanRedo értéke?

A MiniWord menüsorába a File mellé építs egy Szerkesztés főmenüt, amelynek elemei:

Mindegyik menüpont eseménykezelője egyetlen sor:

private void miVisszavon_Click(object sender, EventArgs e)
{
    rtbDokumentum.Undo();
}

private void miUjra_Click(object sender, EventArgs e)
{
    rtbDokumentum.Redo();
}

private void miKivag_Click(object sender, EventArgs e)
{
    rtbDokumentum.Cut();
}

private void miMasol_Click(object sender, EventArgs e)
{
    rtbDokumentum.Copy();
}

private void miBeillesztes_Click(object sender, EventArgs e)
{
    rtbDokumentum.Paste();
}

private void miMindKijelol_Click(object sender, EventArgs e)
{
    rtbDokumentum.SelectAll();
}

A gyorsbillentyűt csak megjelenítsd!

A RichTextBox a Ctrl+C, Ctrl+V és a többi kombinációt már kezeli. Ha a menüpont ShortcutKeys tulajdonságát is beállítod, a billentyű kezelése két helyen is történik, és ez zavart okozhat. A biztonságos megoldás: a ShortcutKeyDisplayString tulajdonságba írd be szövegként a kombinációt (például Ctrl+C), így a menüben látszik a billentyű, de a műveletet továbbra is a szövegdoboz végzi.

Szürkén jelenik meg a Visszavonás, ha nincs mit visszavonni, és szürke a Kivágás és a Másolás, ha nincs kijelölt szöveg. Ezt a menüpontok Enabled tulajdonságával érheted el. De mikor állítsd be? A kényelmes pillanat az, amikor a felhasználó megnyitja a menüt. Erre való a főmenü DropDownOpening eseménye:

private void miSzerkesztes_DropDownOpening(object sender, EventArgs e)
{
    miVisszavon.Enabled = rtbDokumentum.CanUndo;
    miUjra.Enabled = rtbDokumentum.CanRedo;

    bool vanKijeloles = rtbDokumentum.SelectionLength > 0;
    miKivag.Enabled = vanKijeloles;
    miMasol.Enabled = vanKijeloles;
}

Jósolj!

Kijelölsz egy szót, megnyitod a Szerkesztés menüt: engedélyezett a Másolás? Utána a menü megnyitása nélkül nyomsz egy nyílbillentyűt (a kijelölés megszűnik). Mi a Másolás állapota a következő megnyitáskor?

Ha Wordből vagy weboldalról másolsz be szöveget, a Paste() a formázást (betűtípust, színeket) is beilleszti. Ha csak a sima szöveget szeretnéd, a Paste metódusnak megadhatod a formátumot:

private void miSimaBeillesztes_Click(object sender, EventArgs e)
{
    rtbDokumentum.Paste(DataFormats.GetFormat(DataFormats.Text));
}

Egy másik fontos részlet: a fájl megnyitása után a felhasználó a Visszavonás gombbal visszavonhatná a betöltést is, és üres dokumentumot kapna. Ezt megelőzheted, ha a betöltés után törlöd a visszavonási előzményeket:

rtbDokumentum.LoadFile(fajl, RichTextBoxStreamType.RichText);
rtbDokumentum.ClearUndo();

Ellenőrizd a saját gépeden

Nyiss meg egy fájlt, majd válaszd a Visszavonást. A viselkedés a betöltés módjától függhet, ezért érdemes a ClearUndo() hívást betenni: így a megnyitás után biztosan tiszta az előzmény.

Mi a baj, és hogyan javítod?

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

1. A menüpontok mindig engedélyezettek

A Visszavonás akkor is használható, ha nincs mit visszavonni.

2. Kétszer illeszti be a szöveget

A Ctrl+V megnyomására a szöveg kétszer jelenik meg.

3. A Redo szürke marad

Visszavonsz egy gépelést, de az Újra menüpont szürke.

4. Nem a kijelölt szöveget másolja

Clipboard.SetText(rtbDokumentum.Text);

5. A betöltött fájl visszavonható

Megnyitsz egy fájlt, majd a Visszavonás után üres lesz a dokumentum.

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.

private void miTorles_Click(object sender, EventArgs e)
{
    rtbDokumentum.SelectedText = "";
}

private void miDatum_Click(object sender, EventArgs e)
{
    rtbDokumentum.SelectedText = DateTime.Today.ToString("yyyy. MM. dd.");
}

// a DropDownOpening eseménykezelőben:
if (rtbDokumentum.CanUndo)
{
    miVisszavon.Text = "Visszavonás (" + rtbDokumentum.UndoActionName + ")";
}
else
{
    miVisszavon.Text = "Visszavonás";
}

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

Alap szint

private void miTorles_Click(object sender, EventArgs e)
{
    rtbDokumentum.SelectedText = "";
}

private void miSzerkesztes_DropDownOpening(object sender, EventArgs e)
{
    miVisszavon.Enabled = rtbDokumentum.CanUndo;
    miUjra.Enabled = rtbDokumentum.CanRedo;
}

Közepes szint

private void miSimaBeillesztes_Click(object sender, EventArgs e)
{
    rtbDokumentum.Paste(DataFormats.GetFormat(DataFormats.Text));
}

private void miDatum_Click(object sender, EventArgs e)
{
    rtbDokumentum.SelectedText = DateTime.Today.ToString("yyyy. MM. dd.");
}

Kihívás szint

private void miSzerkesztes_DropDownOpening(object sender, EventArgs e)
{
    miVisszavon.Enabled = rtbDokumentum.CanUndo;

    if (rtbDokumentum.CanUndo)
    {
        miVisszavon.Text = "Visszavonás (" + rtbDokumentum.UndoActionName + ")";
    }
    else
    {
        miVisszavon.Text = "Visszavonás";
    }
}

private void miDuplaz_Click(object sender, EventArgs e)
{
    if (rtbDokumentum.SelectionLength == 0)
    {
        MessageBox.Show("Előbb jelölj ki szöveget!");
        return;
    }

    string kijelolt = rtbDokumentum.SelectedText;
    rtbDokumentum.SelectedText = kijelolt + kijelolt;
}

Gyors önellenőrzés

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