A nyomtatás három komponensből áll, amelyeket a Toolbox Printing csoportjában találsz. Húzd mindhármat az ablakra (a komponenssávba kerülnek):

A fájl elejére add hozzá a using System.Drawing.Printing; sort, mert a nyomtatás típusai ebben a névtérben vannak.

A PrintDocument a nyomtatás megkezdése előtt a BeginPrint eseményt váltja ki, majd minden egyes lapra lefuttatja a PrintPage eseményt. A PrintPage eseménykezelőjében a lapra rajzolunk, ugyanúgy, mint a képernyőre. A PrintPageEventArgs e paraméter adja az eszközöket:

Egyetlen lapra kiírva a szöveget így néz ki a legegyszerűbb változat:

private void pdDokumentum_PrintPage(object sender, PrintPageEventArgs e)
{
    Font betu = new Font("Arial", 12);

    e.Graphics.DrawString(rtbDokumentum.Text, betu, Brushes.Black, e.MarginBounds);

    betu.Dispose();
    e.HasMorePages = false;
}

Jósolj!

A dokumentum három oldalnyi szöveget tartalmaz, de ez a kód egyetlen lapra rajzol, és a HasMorePages értéke hamis. Mi kerül a papírra?

Hosszabb szövegnél a programnak lapról lapra el kell döntenie, hány karakter fér egy lapra, azt kiírni, majd a maradékkal folytatni. Ehhez két mezőre van szükség: a nyomtatandó szövegre és arra, hogy hol tartunk benne (1.12 lecke: mező). A MeasureString metódus megmondja, hányadik karakterig fér a szöveg a területre:

private string nyomtatandoSzoveg = "";
private int pozicio = 0;

private void pdDokumentum_BeginPrint(object sender, PrintEventArgs e)
{
    nyomtatandoSzoveg = rtbDokumentum.Text;
    pozicio = 0;
}

private void pdDokumentum_PrintPage(object sender, PrintPageEventArgs e)
{
    Font betu = new Font("Arial", 12);

    string maradek = nyomtatandoSzoveg.Substring(pozicio);
    int karakterek;
    int sorok;

    e.Graphics.MeasureString(maradek, betu, e.MarginBounds.Size, StringFormat.GenericTypographic, out karakterek, out sorok);

    e.Graphics.DrawString(maradek.Substring(0, karakterek), betu, Brushes.Black, e.MarginBounds, StringFormat.GenericTypographic);

    pozicio = pozicio + karakterek;
    e.HasMorePages = pozicio < nyomtatandoSzoveg.Length;

    betu.Dispose();
}

Jósolj!

Egy lapra 1800 karakter fér, a szöveg 4000 karakter hosszú. Hányszor fut le a PrintPage? Mi a pozicio értéke az utolsó lap után?

Haladó téma: nem kell mindent megjegyezned

A MeasureString és a DrawString használata a grafikus programozás (9. fejezet) része. Itt elég megérteni a menetet: megmérjük, mi fér a lapra, kiírjuk, megjegyezzük, hol tartunk, és újabb lapot kérünk, amíg van szöveg.

Adj a File menühöz két új elemet: miNyomtatas (Nyomtatás…) és miElonezet (Nyomtatási kép). A kódjuk rövid, mert a munkát a komponensek végzik:

private void miNyomtatas_Click(object sender, EventArgs e)
{
    dlgNyomtatas.Document = pdDokumentum;

    if (dlgNyomtatas.ShowDialog() == DialogResult.OK)
    {
        try
        {
            pdDokumentum.Print();
        }
        catch (Exception ex)
        {
            MessageBox.Show("A nyomtatás nem sikerült: " + ex.Message);
        }
    }
}

private void miElonezet_Click(object sender, EventArgs e)
{
    ppdElonezet.Document = pdDokumentum;
    ppdElonezet.ShowDialog();
}

Teszteld papír nélkül!

A Windows 10 és 11 tartalmaz egy Microsoft Print to PDF nevű virtuális nyomtatót. A Nyomtatás ablakban válaszd ezt, és a program PDF fájlt készít a dokumentumból. Így nem kell papír és fizikai nyomtató a teszteléshez, és a lapok tördelése is ellenőrizhető.

A formázás nem jelenik meg a nyomtatáson

A fenti kód a dokumentum sima szövegét egyetlen betűtípussal (Arial, 12 pont) nyomtatja. A félkövér, dőlt, színes szövegek, az igazítás és a különböző betűméretek nem kerülnek a papírra. Ez a megoldás gyakorláshoz és jegyzetekhez jó.

A formázott szöveg nyomtatásához a Windows saját RichEdit komponensét kell megkérni arra, hogy a lapra rajzolja a szöveget (EM_FORMATRANGE üzenet), ugyanúgy, ahogy a 2.7 leckében a sorkizárt igazításhoz üzenetet küldtünk neki. Ez bonyolultabb, és külön segédosztályt igényel: a MiniWord alapfeladatához nem szükséges. Ha érdekel, a Microsoft dokumentációjában keresd a „RichTextBox printing EM_FORMATRANGE” kifejezést.

Jósolj!

A MiniWordben a címet középre igazítottad, nagy méretű, félkövér betűkkel. Hogyan jelenik meg a címsor az egyszerű nyomtatáson?

Mi a baj, és hogyan javítod?

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

1. Csak az első oldal nyomtat

A hosszú dokumentumból csak egyetlen lap készül.

2. Minden lapon ugyanaz a szöveg

private void pdDokumentum_PrintPage(object sender, PrintPageEventArgs e)
{
    int pozicio = 0;   // ...
}

3. Ismeretlen típus

// CS0246: The type or namespace name 'PrintPageEventArgs' could not be found

4. Második nyomtatásnál rossz szöveg

Másodszor nyomtatva a dokumentum egy része hiányzik.

5. Nem jelenik meg a félkövér

A nyomtatott lapon nincs félkövér szöveg.

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 int oldalSzam = 0;

// BeginPrint: oldalSzam = 0;

// PrintPage végén, az e.HasMorePages sor előtt:
oldalSzam = oldalSzam + 1;
Font kisBetu = new Font("Arial", 9);
e.Graphics.DrawString($"{oldalSzam}. oldal", kisBetu, Brushes.Gray, e.MarginBounds.Left, e.MarginBounds.Bottom + 10);
kisBetu.Dispose();

Font fejBetu = new Font("Arial", 9);
e.Graphics.DrawString(this.Text, fejBetu, Brushes.Gray, e.MarginBounds.Left, e.MarginBounds.Top - 25);
fejBetu.Dispose();

// a Form1_Load eseményben:
pdDokumentum.DefaultPageSettings.Margins = new Margins(79, 79, 79, 79);

Három szinten gyakorolhatsz: alap, közepes és kihívás. A feladatok a MiniWord nyomtatását gyakoroltatják (a pdDokumentum, dlgNyomtatas és ppdElonezet komponens a 2.15 lecke szerint). A fájl elejére tedd a using System.Drawing.Printing; sort. Csak a próbálkozás után nyisd le a megoldást.

Alap szint

private void btnElonezet_Click(object sender, EventArgs e)
{
    ppdElonezet.Document = pdDokumentum;
    ppdElonezet.ShowDialog();
}

Közepes szint

private void pdDokumentum_PrintPage(object sender, PrintPageEventArgs e)
{
    Font betu = rtbDokumentum.Font;   // nem mi hoztuk létre, nem szabad Dispose-olni

    string maradek = nyomtatandoSzoveg.Substring(pozicio);
    int karakterek;
    int sorok;

    e.Graphics.MeasureString(maradek, betu, e.MarginBounds.Size, StringFormat.GenericTypographic, out karakterek, out sorok);
    e.Graphics.DrawString(maradek.Substring(0, karakterek), betu, Brushes.Black, e.MarginBounds, StringFormat.GenericTypographic);

    pozicio = pozicio + karakterek;
    e.HasMorePages = pozicio < nyomtatandoSzoveg.Length;
}

private void miNyomtatas_Click(object sender, EventArgs e)
{
    if (rtbDokumentum.TextLength == 0)
    {
        MessageBox.Show("Nincs mit nyomtatni.");
        return;
    }

    dlgNyomtatas.Document = pdDokumentum;

    if (dlgNyomtatas.ShowDialog() == DialogResult.OK)
    {
        pdDokumentum.Print();
    }
}

Kihívás szint

private void miOldalbeallitas_Click(object sender, EventArgs e)
{
    psdOldal.Document = pdDokumentum;
    psdOldal.ShowDialog();
}

Gyors önellenőrzés

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