Urutan Terminal Virtual Konsol

Urutan terminal virtual adalah urutan karakter kontrol yang dapat mengontrol gerakan kursor, warna konsol, dan operasi lainnya saat ditulis ke aliran output. Urutan juga dapat diterima pada aliran input sebagai respons terhadap urutan informasi kueri aliran output atau sebagai pengodean input pengguna saat mode yang sesuai diatur.

Anda dapat menggunakan fungsi GetConsoleMode dan SetConsoleMode untuk mengonfigurasi perilaku ini. Sampel cara yang disarankan untuk mengaktifkan perilaku terminal virtual disertakan di akhir dokumen ini.

Perilaku urutan berikut didasarkan pada teknologi emulator terminal VT100 dan turunan, paling khusus emulator terminal xterm. Informasi selengkapnya tentang urutan terminal dapat ditemukan di http://vt100.net dan di http://invisible-island.net/xterm/ctlseqs/ctlseqs.html.

Urutan Output

Urutan terminal berikut dicegat oleh host konsol saat ditulis ke dalam aliran output, jika bendera ENABLE_VIRTUAL_TERMINAL_PROCESSING diatur pada handel buffer layar menggunakan fungsi SetConsoleMode. Perhatikan bahwa bendera DISABLE_NEWLINE_AUTO_RETURN mungkin juga berguna dalam menimulasi posisi kursor dan perilaku gulir emulator terminal lain sehubungan dengan karakter yang ditulis ke kolom akhir di baris mana pun.

Penempatan Kursor Sederhana

Dalam semua deskripsi berikut, ESC selalu merupakan nilai heksadesimal 0x1B. Tidak ada spasi yang akan disertakan dalam urutan terminal. Urutan terminal individual dapat dibagi, pada karakter atau posisi byte apa pun, di beberapa panggilan berurutan ke WriteFile atau WriteConsole tetapi praktik terbaik adalah menyertakan seluruh urutan dalam satu panggilan. Untuk contoh bagaimana urutan ini digunakan dalam praktiknya, silakan lihat contoh di akhir topik ini.

Tabel berikut ini menjelaskan urutan escape sederhana dengan satu perintah tindakan langsung setelah karakter ESC. Urutan ini tidak memiliki parameter dan segera berlaku.

Semua perintah dalam tabel ini umumnya setara dengan memanggil API konsol SetConsoleCursorPosition untuk menempatkan kursor.

Gerakan kursor akan dibatasi oleh viewport saat ini ke dalam buffer. Pengguliran (jika tersedia) tidak akan terjadi.

Penempatan Kursor

Tabel berikut mencakup urutan jenis Control Sequence Introducer (CSI). Semua urutan CSI dimulai dengan ESC (0x1B) diikuti oleh [ (kurung kiri, 0x5B) dan mungkin berisi parameter panjang variabel untuk menentukan lebih banyak informasi untuk setiap operasi. Ini akan diwakili oleh shorthand <n>. Setiap tabel di bawah ini dikelompokkan menurut fungsionalitas dengan catatan di bawah setiap tabel yang menjelaskan cara kerja grup.

Untuk semua parameter, aturan berikut berlaku kecuali dinyatakan lain:

• <n> mewakili jarak untuk dipindahkan dan merupakan parameter opsional
• Jika <n> dihilangkan atau sama dengan 0, n akan diperlakukan sebagai 1
• <n> tidak boleh lebih besar dari 32.767 (nilai pendek maksimum)
• <n> tidak boleh negatif

Semua perintah di bagian ini umumnya setara dengan memanggil API konsol SetConsoleCursorPosition.

Gerakan kursor akan dibatasi oleh viewport saat ini ke dalam buffer. Pengguliran (jika tersedia) tidak akan terjadi.

Visibilitas Kursor

Perintah berikut mengontrol visibilitas kursor dan status berkedipnya. Urutan DECTCEM umumnya setara dengan memanggil API konsol SetConsoleCursorInfo untuk mengalihkan visibilitas kursor.

Bentuk Kursor

Perintah berikut mengontrol dan memungkinkan penyesuaian bentuk kursor.

Viewport Positioning

Semua perintah di bagian ini umumnya setara dengan memanggil API konsol ScrollConsoleScreenBuffer untuk memindahkan konten buffer konsol.

Perhatian Nama perintah menyesatkan. Gulir merujuk ke arah mana teks bergerak selama operasi, bukan ke arah mana viewport akan terlihat bergerak.

Teks dipindahkan dimulai dengan garis tempat kursor aktif. Jika kursor berada di baris tengah viewport, maka gulir ke atas akan memindahkan bagian bawah viewport, dan menyisipkan baris kosong di bagian bawah. Gulir ke bawah akan memindahkan bagian atas baris viewport, dan menyisipkan baris baru di bagian atas.

Penting juga untuk dicatat adalah menggulir ke atas dan ke bawah juga dipengaruhi oleh margin gulir. Gulir ke atas dan ke bawah tidak akan memengaruhi garis apa pun di luar margin gulir.

Nilai default untuk <n> adalah 1, dan nilainya dapat dihilangkan secara opsional.

Modifikasi Teks

Semua perintah di bagian ini umumnya setara dengan memanggil API konsol FillConsoleOutputCharacter, FillConsoleOutputAttribute, dan ScrollConsoleScreenBuffer untuk memodifikasi konten buffer teks.

Untuk setiap urutan, nilai default untuk <n> jika dihilangkan adalah 0.

Untuk perintah berikut, parameter <n> memiliki 3 nilai yang valid:

• 0 menghapus dari posisi kursor saat ini (inklusif) ke akhir baris/tampilan
• 1 menghapus dari awal garis/tampilan hingga dan menyertakan posisi kursor saat ini
• 2 menghapus seluruh baris/tampilan

Pemformatan Teks

Semua perintah di bagian ini umumnya setara dengan memanggil API konsol SetConsoleTextAttribute untuk menyesuaikan pemformatan semua penulisan di masa mendatang ke buffer teks output konsol.

Perintah ini khusus karena posisi n> di bawah ini dapat menerima antara 0 dan 16 parameter yang <dipisahkan oleh titik koma.

Ketika tidak ada parameter yang ditentukan, parameter diperlakukan sama dengan parameter 0 tunggal.

Tabel nilai berikut dapat digunakan dalam <n> untuk mewakili mode pemformatan yang berbeda.

Mode pemformatan diterapkan dari kiri ke kanan. Menerapkan opsi pemformatan yang bersaing akan menghasilkan opsi paling tepat yang diutamakan.

Untuk opsi yang menentukan warna, warna akan digunakan seperti yang didefinisikan dalam tabel warna konsol yang dapat dimodifikasi menggunakan API SetConsoleScreenBufferInfoEx. Jika tabel dimodifikasi untuk membuat posisi "biru" dalam tabel menampilkan bayangan RGB merah, maka semua panggilan ke Foreground Blue akan menampilkan warna merah itu sampai diubah sebaliknya.

Warna yang Diperluas

Beberapa emulator terminal virtual mendukung palet warna yang lebih besar dari 16 warna yang disediakan oleh Konsol Windows. Untuk warna yang diperluas ini, Konsol Windows akan memilih warna terdekat yang sesuai dari tabel warna 16 yang ada untuk ditampilkan. Tidak seperti nilai SGR biasa di atas, nilai yang diperluas akan menggunakan parameter tambahan setelah indikator awal sesuai dengan tabel di bawah ini.

*Palet warna 88 dan 256 dipertahankan secara internal untuk perbandingan didasarkan dari emulator terminal xterm. Tabel perbandingan/pembulatan tidak dapat diubah saat ini.

Warna Layar

Perintah berikut memungkinkan aplikasi untuk mengatur nilai palet warna layar ke nilai RGB apa pun.

Nilai RGB harus berupa nilai heksadesimal antara 0 dan ff, dan dipisahkan oleh karakter garis miring (misalnya rgb:1/24/86).

Perhatikan bahwa urutan ini adalah urutan "Perintah sistem operasi" OSC, dan bukan CSI seperti banyak urutan lain yang tercantum, dan karenanya dimulai dengan "\x1b]", bukan "\x1b[". Sebagai urutan OSC, mereka diakhir dengan Terminator String yang direpresentasikan sebagai <ST> dan ditransmisikan dengan ESC \ (0x1B 0x5C). BEL (0x7) dapat digunakan sebagai terminator, tetapi bentuk yang lebih panjang lebih disukai.

Perubahan Mode

Ini adalah urutan yang mengontrol mode input. Ada dua set mode input yang berbeda, Mode Kunci Kursor dan Mode Kunci Keypad. Mode Tombol Kursor mengontrol urutan yang dipancarkan oleh tombol panah serta Beranda dan Akhir, sementara Mode Tombol Keypad mengontrol urutan yang dipancarkan oleh tombol pada numpad terutama, serta tombol fungsi.

Masing-masing mode ini adalah pengaturan boolean sederhana – Mode Kunci Kursor adalah Normal (default) atau Aplikasi, dan Mode Kunci Keypad adalah Numerik (default) atau Aplikasi.

Lihat bagian Kunci Kursor dan Kunci Numpad & Fungsi untuk urutan yang dipancarkan dalam mode ini.

Status Kueri

Semua perintah di bagian ini umumnya setara dengan memanggil API konsol Get* untuk mengambil informasi status tentang status buffer konsol saat ini.

Tab

Meskipun konsol windows secara tradisional mengharapkan tab memiliki lebar delapan karakter secara eksklusif, *aplikasi nix yang menggunakan urutan tertentu dapat memanipulasi tempat perhentian tab berada di dalam jendela konsol untuk mengoptimalkan gerakan kursor oleh aplikasi.

Urutan berikut memungkinkan aplikasi untuk mengatur lokasi perhentian tab di dalam jendela konsol, menghapusnya, dan menavigasi di antaranya.

• Untuk CHT dan CBT, <n> adalah parameter opsional yang (default=1) menunjukkan berapa kali untuk memajukan kursor ke arah yang ditentukan.
• Jika tidak ada perhentian tab yang diatur melalui HTS, CHT dan CBT akan memperlakukan kolom pertama dan terakhir jendela sebagai satu-satunya dua perhentian tab.
• Menggunakan HTS untuk mengatur perhentian tab juga akan menyebabkan konsol menavigasi ke perhentian tab berikutnya pada output karakter TAB (0x09, '\t'), dengan cara yang sama seperti CHT.

Menunjuk Set Karakter

Urutan berikut memungkinkan program untuk mengubah pemetaan set karakter aktif. Ini memungkinkan program untuk memancarkan karakter ASCII 7-bit, tetapi menampilkannya sebagai glyph lain pada layar terminal itu sendiri. Saat ini, satu-satunya dua set karakter yang didukung adalah ASCII (default) dan DEC Special Graphics Character Set. Lihat http://vt100.net/docs/vt220-rm/table2-4.html untuk daftar semua karakter yang diwakili oleh SET Karakter Grafis Khusus DEC.

Terutama, mode DEC Line Drawing digunakan untuk menggambar batas dalam aplikasi konsol. Tabel berikut ini memperlihatkan apa yang dipetakan karakter ASCII ke karakter gambar garis mana.

Menggulir Margin

Urutan berikut memungkinkan program untuk mengonfigurasi "wilayah gulir" layar yang terpengaruh oleh operasi pengguliran. Ini adalah subset baris yang disesuaikan ketika layar akan menggulir, misalnya, pada '\n' atau RI. Margin ini juga memengaruhi baris yang dimodifikasi oleh Sisipkan Garis (IL) dan Hapus Baris (DL), Gulir Ke Atas (SU) dan Gulir Ke Bawah (SD).

Margin gulir dapat sangat berguna untuk memiliki sebagian layar yang tidak menggulir saat layar lainnya diisi, seperti memiliki bilah judul di bagian atas atau bilah status di bagian bawah aplikasi Anda.

Untuk DECSTBM, ada dua parameter opsional, <t> dan <b>, yang digunakan untuk menentukan baris yang mewakili garis atas dan bawah wilayah gulir, inklusif. Jika parameter dihilangkan, <t> default ke 1 dan <b> default ke tinggi viewport saat ini.

Margin gulir adalah per buffer, jadi yang penting, Buffer Alternatif dan Buffer Utama mempertahankan pengaturan margin gulir terpisah (sehingga aplikasi layar penuh di buffer alternatif tidak akan meracuni margin buffer utama).

Judul Jendela

Perintah berikut memungkinkan aplikasi untuk mengatur judul jendela konsol ke parameter string> yang diberikan<. String harus kurang dari 255 karakter yang akan diterima. Ini setara dengan memanggil SetConsoleTitle dengan string yang diberikan.

Perhatikan bahwa urutan ini adalah urutan OSC "Perintah sistem operasi", dan bukan CSI seperti banyak urutan lain yang tercantum, dan karenanya dimulai dengan "\x1b]", bukan "\x1b[". Sebagai urutan OSC, mereka diakhir dengan Terminator String yang direpresentasikan sebagai <ST> dan ditransmisikan dengan ESC \ (0x1B 0x5C). BEL (0x7) dapat digunakan sebagai terminator, tetapi bentuk yang lebih panjang lebih disukai.

Karakter yang mengakhiri di sini adalah karakter "Bell", '\x07'

Buffer Layar Alternatif

*Aplikasi gaya Nix sering menggunakan buffer layar alternatif, sehingga mereka dapat memodifikasi seluruh konten buffer, tanpa memengaruhi aplikasi yang memulainya. Buffer alternatif adalah dimensi jendela, tanpa wilayah gulir balik apa pun.

Untuk contoh perilaku ini, pertimbangkan kapan vim diluncurkan dari bash. Vim menggunakan keseluruhan layar untuk mengedit file, lalu kembali ke bash membuat buffer asli tidak berubah.

Lebar Jendela

Urutan berikut dapat digunakan untuk mengontrol lebar jendela konsol. Mereka kira-kira setara dengan panggilan API konsol SetConsoleScreenBufferInfoEx untuk mengatur lebar jendela.

Reset Lunak

Urutan berikut dapat digunakan untuk mereset properti tertentu ke nilai defaultnya. Properti berikut diatur ulang ke nilai default berikut (juga tercantum adalah urutan yang mengontrol properti tersebut):

• Visibilitas kursor: terlihat (DECTEM)
• Keypad Numerik: Mode Numerik (DECNKM)
• Mode Kunci Kursor: Mode Normal (DECCKM)
• Margin Atas dan Bawah: Atas=1, Bawah=Tinggi Konsol (DECSTBM)
• Set Karakter: US ASCII
• Rendisi Grafis: Default/Nonaktif (SGR)
• Simpan status kursor: Posisi beranda (0,0) (DECSC)

Urutan Input

Urutan terminal berikut dipancarkan oleh host konsol pada aliran input jika bendera ENABLE_VIRTUAL_TERMINAL_INPUT diatur pada handel buffer input menggunakan bendera SetConsoleMode.

Ada dua mode internal yang mengontrol urutan mana yang dipancarkan untuk kunci input yang diberikan, Mode Kunci Kursor dan Mode Kunci Keypad. Ini dijelaskan di bagian Perubahan Mode.

Kunci Kursor

Selain itu, jika Ctrl ditekan dengan salah satu tombol ini, urutan berikut dipancarkan sebagai gantinya, terlepas dari Mode Tombol Kursor:

Numpad & Kunci Fungsi

Pengubah

Alt diperlakukan dengan awalan urutan dengan escape: ESC <c> di mana <c> adalah karakter yang diteruskan oleh sistem operasi. Alt+Ctrl ditangani dengan cara yang sama kecuali bahwa sistem operasi akan telah memindahkan <kunci c> ke karakter kontrol yang sesuai yang akan disampaikan ke aplikasi.

Ctrl umumnya diteruskan persis seperti yang diterima dari sistem. Ini biasanya satu karakter yang digeser ke bawah ke ruang cadangan karakter kontrol (0x0-0x1f). Misalnya, Ctrl+@ (0x40) menjadi NUL (0x00), Ctrl+[ (0x5b) menjadi ESC (0x1b), dll. Beberapa kombinasi tombol Ctrl diperlakukan khusus sesuai dengan tabel berikut:

Sampel

Contoh urutan terminal SGR

Kode berikut menyediakan beberapa contoh pemformatan teks.

#include <stdio.h>
#include <wchar.h>
#include <windows.h>

int main()
{
    // Set output mode to handle virtual terminal sequences
    HANDLE hOut = GetStdHandle(STD_OUTPUT_HANDLE);
    if (hOut == INVALID_HANDLE_VALUE)
    {
        return GetLastError();
    }

    DWORD dwMode = 0;
    if (!GetConsoleMode(hOut, &dwMode))
    {
        return GetLastError();
    }

    dwMode |= ENABLE_VIRTUAL_TERMINAL_PROCESSING;
    if (!SetConsoleMode(hOut, dwMode))
    {
        return GetLastError();
    }

    // Try some Set Graphics Rendition (SGR) terminal escape sequences
    wprintf(L"\x1b[31mThis text has a red foreground using SGR.31.\r\n");
    wprintf(L"\x1b[1mThis text has a bright (bold) red foreground using SGR.1 to affect the previous color setting.\r\n");
    wprintf(L"\x1b[mThis text has returned to default colors using SGR.0 implicitly.\r\n");
    wprintf(L"\x1b[34;46mThis text shows the foreground and background change at the same time.\r\n");
    wprintf(L"\x1b[0mThis text has returned to default colors using SGR.0 explicitly.\r\n");
    wprintf(L"\x1b[31;32;33;34;35;36;101;102;103;104;105;106;107mThis text attempts to apply many colors in the same command. Note the colors are applied from left to right so only the right-most option of foreground cyan (SGR.36) and background bright white (SGR.107) is effective.\r\n");
    wprintf(L"\x1b[39mThis text has restored the foreground color only.\r\n");
    wprintf(L"\x1b[49mThis text has restored the background color only.\r\n");

    return 0;
}

Grafik berikut menunjukkan output dari contoh kode sebelumnya.

Contoh Mengaktifkan Pemrosesan Terminal Virtual

Kode berikut memberikan contoh cara yang disarankan untuk mengaktifkan pemrosesan terminal virtual untuk aplikasi. Niat sampel adalah untuk menunjukkan:

1. Mode yang ada harus selalu diambil melalui GetConsoleMode dan dianalisis sebelum diatur dengan SetConsoleMode.

2. Memeriksa apakah SetConsoleMode kembali 0 dan GetLastError mengembalikan ERROR_INVALID_PARAMETER adalah mekanisme saat ini untuk menentukan kapan berjalan pada sistem tingkat bawah. Aplikasi yang menerima ERROR_INVALID_PARAMETER dengan salah satu bendera mode konsol yang lebih baru di bidang bit harus menurunkan perilaku dengan baik dan mencoba lagi.

#include <stdio.h>
#include <wchar.h>
#include <windows.h>

int main()
{
    // Set output mode to handle virtual terminal sequences
    HANDLE hOut = GetStdHandle(STD_OUTPUT_HANDLE);
    if (hOut == INVALID_HANDLE_VALUE)
    {
        return false;
    }
    HANDLE hIn = GetStdHandle(STD_INPUT_HANDLE);
    if (hIn == INVALID_HANDLE_VALUE)
    {
        return false;
    }

    DWORD dwOriginalOutMode = 0;
    DWORD dwOriginalInMode = 0;
    if (!GetConsoleMode(hOut, &dwOriginalOutMode))
    {
        return false;
    }
    if (!GetConsoleMode(hIn, &dwOriginalInMode))
    {
        return false;
    }

    DWORD dwRequestedOutModes = ENABLE_VIRTUAL_TERMINAL_PROCESSING | DISABLE_NEWLINE_AUTO_RETURN;
    DWORD dwRequestedInModes = ENABLE_VIRTUAL_TERMINAL_INPUT;

    DWORD dwOutMode = dwOriginalOutMode | dwRequestedOutModes;
    if (!SetConsoleMode(hOut, dwOutMode))
    {
        // we failed to set both modes, try to step down mode gracefully.
        dwRequestedOutModes = ENABLE_VIRTUAL_TERMINAL_PROCESSING;
        dwOutMode = dwOriginalOutMode | dwRequestedOutModes;
        if (!SetConsoleMode(hOut, dwOutMode))
        {
            // Failed to set any VT mode, can't do anything here.
            return -1;
        }
    }

    DWORD dwInMode = dwOriginalInMode | dwRequestedInModes;
    if (!SetConsoleMode(hIn, dwInMode))
    {
        // Failed to set VT input mode, can't do anything here.
        return -1;
    }

    return 0;
}

Contoh Pilih Fitur Pembaruan Hari Jadi

Contoh berikut dimaksudkan untuk menjadi contoh kode yang lebih kuat menggunakan berbagai urutan escape untuk memanipulasi buffer, dengan penekanan pada fitur yang ditambahkan dalam Anniversary Update untuk Windows 10.

Contoh ini menggunakan buffer layar alternatif, memanipulasi perhentian tab, mengatur margin gulir, dan mengubah kumpulan karakter.

// System headers
#include <windows.h>

// Standard library C-style
#include <wchar.h>
#include <stdlib.h>
#include <stdio.h>

#define ESC "\x1b"
#define CSI "\x1b["

bool EnableVTMode()
{
    // Set output mode to handle virtual terminal sequences
    HANDLE hOut = GetStdHandle(STD_OUTPUT_HANDLE);
    if (hOut == INVALID_HANDLE_VALUE)
    {
        return false;
    }

    DWORD dwMode = 0;
    if (!GetConsoleMode(hOut, &dwMode))
    {
        return false;
    }

    dwMode |= ENABLE_VIRTUAL_TERMINAL_PROCESSING;
    if (!SetConsoleMode(hOut, dwMode))
    {
        return false;
    }
    return true;
}

void PrintVerticalBorder()
{
    printf(ESC "(0"); // Enter Line drawing mode
    printf(CSI "104;93m"); // bright yellow on bright blue
    printf("x"); // in line drawing mode, \x78 -> \u2502 "Vertical Bar"
    printf(CSI "0m"); // restore color
    printf(ESC "(B"); // exit line drawing mode
}

void PrintHorizontalBorder(COORD const Size, bool fIsTop)
{
    printf(ESC "(0"); // Enter Line drawing mode
    printf(CSI "104;93m"); // Make the border bright yellow on bright blue
    printf(fIsTop ? "l" : "m"); // print left corner 

    for (int i = 1; i < Size.X - 1; i++)
        printf("q"); // in line drawing mode, \x71 -> \u2500 "HORIZONTAL SCAN LINE-5"

    printf(fIsTop ? "k" : "j"); // print right corner
    printf(CSI "0m");
    printf(ESC "(B"); // exit line drawing mode
}

void PrintStatusLine(const char* const pszMessage, COORD const Size)
{
    printf(CSI "%d;1H", Size.Y);
    printf(CSI "K"); // clear the line
    printf(pszMessage);
}

int __cdecl wmain(int argc, WCHAR* argv[])
{
    argc; // unused
    argv; // unused
    //First, enable VT mode
    bool fSuccess = EnableVTMode();
    if (!fSuccess)
    {
        printf("Unable to enter VT processing mode. Quitting.\n");
        return -1;
    }
    HANDLE hOut = GetStdHandle(STD_OUTPUT_HANDLE);
    if (hOut == INVALID_HANDLE_VALUE)
    {
        printf("Couldn't get the console handle. Quitting.\n");
        return -1;
    }

    CONSOLE_SCREEN_BUFFER_INFO ScreenBufferInfo;
    GetConsoleScreenBufferInfo(hOut, &ScreenBufferInfo);
    COORD Size;
    Size.X = ScreenBufferInfo.srWindow.Right - ScreenBufferInfo.srWindow.Left + 1;
    Size.Y = ScreenBufferInfo.srWindow.Bottom - ScreenBufferInfo.srWindow.Top + 1;

    // Enter the alternate buffer
    printf(CSI "?1049h");

    // Clear screen, tab stops, set, stop at columns 16, 32
    printf(CSI "1;1H");
    printf(CSI "2J"); // Clear screen

    int iNumTabStops = 4; // (0, 20, 40, width)
    printf(CSI "3g"); // clear all tab stops
    printf(CSI "1;20H"); // Move to column 20
    printf(ESC "H"); // set a tab stop

    printf(CSI "1;40H"); // Move to column 40
    printf(ESC "H"); // set a tab stop

    // Set scrolling margins to 3, h-2
    printf(CSI "3;%dr", Size.Y - 2);
    int iNumLines = Size.Y - 4;

    printf(CSI "1;1H");
    printf(CSI "102;30m");
    printf("Windows 10 Anniversary Update - VT Example");
    printf(CSI "0m");

    // Print a top border - Yellow
    printf(CSI "2;1H");
    PrintHorizontalBorder(Size, true);

    // // Print a bottom border
    printf(CSI "%d;1H", Size.Y - 1);
    PrintHorizontalBorder(Size, false);

    wchar_t wch;

    // draw columns
    printf(CSI "3;1H");
    int line = 0;
    for (line = 0; line < iNumLines * iNumTabStops; line++)
    {
        PrintVerticalBorder();
        if (line + 1 != iNumLines * iNumTabStops) // don't advance to next line if this is the last line
            printf("\t"); // advance to next tab stop

    }

    PrintStatusLine("Press any key to see text printed between tab stops.", Size);
    wch = _getwch();

    // Fill columns with output
    printf(CSI "3;1H");
    for (line = 0; line < iNumLines; line++)
    {
        int tab = 0;
        for (tab = 0; tab < iNumTabStops - 1; tab++)
        {
            PrintVerticalBorder();
            printf("line=%d", line);
            printf("\t"); // advance to next tab stop
        }
        PrintVerticalBorder();// print border at right side
        if (line + 1 != iNumLines)
            printf("\t"); // advance to next tab stop, (on the next line)
    }

    PrintStatusLine("Press any key to demonstrate scroll margins", Size);
    wch = _getwch();

    printf(CSI "3;1H");
    for (line = 0; line < iNumLines * 2; line++)
    {
        printf(CSI "K"); // clear the line
        int tab = 0;
        for (tab = 0; tab < iNumTabStops - 1; tab++)
        {
            PrintVerticalBorder();
            printf("line=%d", line);
            printf("\t"); // advance to next tab stop
        }
        PrintVerticalBorder(); // print border at right side
        if (line + 1 != iNumLines * 2)
        {
            printf("\n"); //Advance to next line. If we're at the bottom of the margins, the text will scroll.
            printf("\r"); //return to first col in buffer
        }
    }

    PrintStatusLine("Press any key to exit", Size);
    wch = _getwch();

    // Exit the alternate buffer
    printf(CSI "?1049l");

}