ScrollConsoleScreenBuffer

[funkcja] Przesuwa blok danych w buforze ekranu.

Składnia

#include <windows.h>
BOOL WINAPI ScrollConsoleScreenBuffer(
HANDLE hConsoleOutput,
const SMALL_RECT * lpScrollRectangle,
const SMALL_RECT * lpClipRectangle,
COORD dwDestinationOrigin,
const CHAR_INFO * lpFill );

Argumenty

Argument	Opis
hConsoleOutput	Uchwyt do bufora ekranu konsoli. Uchwyt musi mieć dostęp `GENERIC_READ`.
lpScrollRectangle	Wskaźnik do struktury `SMALL_RECT` prostokąta do przesunięcia.
lpClipRectangle	Wskaźnik do struktury `SMALL_RECT` prostokąta bufora ekranu, który ma wpływ na przewijanie. Wartość tego argumentu może wynosić `NULL`.
dwDestinationOrigin	Struktura _{» WinAPI ♦}COORD określająca lewy górny róg nowej lokalizacji zawartości `lpScrollRectangle` (w znakach).
lpFill	Wskaźnik do struktury `CHAR_INFO` określającej znak i kolor atrybutów używanych w wypełnianiu komórek pomiędzy `lpScrollRectangle` i `lpClipRectangle`, które były puste w wyniku przesunięcia.

Zwracana wartość

Jeśli nie wystąpią błędy, zwracana wartość jest niezerowa, inaczej 0. Aby uzyskać szczegółowe informacje o błędzie, wywołaj funkcję _{» WinAPI ♦}GetLastError.

Dodatkowe informacje

Efekt przesunięcia może być ograniczony przez określony prostokąt, więc zawartość bufora ekranu konsoli na zewnątrz prostokąta pozostanie niezmieniona. Funkcja kopiuje zawartość prostokątnego obszaru bufora ekranu określonego przez argument lpScrollRectangle do innego obszaru bufora ekranu konsoli. Po wywołaniu funkcji wymiary określonego prostokąta są zawarte w argumencie lpScrollRectangle. Części prostokąta wskazywanego przez argument lpScrollRectangle, które nie zachodzą na określony prostokąt są wypełniane znakami i atrybutami kolorów określonymi przez argument lpFill. Ograniczający prostokąt pozwala na zmianę prostokąta lpScrollRectangle oraz zaznaczonego prostokąta. Jeśli ograniczający prostokąt nie zawiera obszaru, który będzie wypełniony na podstawie wartości argumentu lpFill, oryginalne rozmiary tego obszaru nie zostaną zmienione. Jeśli przesuwane lub zaznaczone obszary przekraczają wymiary bufora ekranu konsoli, to zostaną obcięte.

Funkcja używa znaków zapisanych w formacie Unicode lub 8-bitowych znaków z bieżącej strony kodowej konsoli. Domyślna strona kodowa konsoli jest inicjalizowana na stronę kodową systemu OEM. Do zmiany strony kodowej konsoli służą funkcje _{» WinAPI ♦}SetConsoleCP oraz _{» WinAPI ♦}SetConsoleOutputCP. Można również użyć polecenia

chcp

lub

mode con cp select=id_strony_kodowej

w wierszu polecenia.

Przykład

#include <windows.h>

int main()
{
//prostokąt do przesunięcia
SMALL_RECT lpScrollRectangle;
lpScrollRectangle.Left = 0;
lpScrollRectangle.Top = 0;
lpScrollRectangle.Right = 19;
lpScrollRectangle.Bottom = 19;
//lewy górny róg nowego prostokąta
COORD dwDestinationOrigin;
dwDestinationOrigin.X = 10;
dwDestinationOrigin.Y = 15;
//atrybuty znaków
CHAR_INFO lpFill;
lpFill.Attributes = BACKGROUND_INTENSITY;
lpFill.Char.AsciiChar = ' ';
ScrollConsoleScreenBuffer( GetStdHandle( STD_OUTPUT_HANDLE ), & lpScrollRectangle, NULL, dwDestinationOrigin, & lpFill );
//zmiana rozmiaru bufora ekranu konsoli
COORD screenBufferSize;
screenBufferSize.X = 50;
screenBufferSize.X = 30;
SetConsoleScreenBufferSize( GetStdHandle( STD_OUTPUT_HANDLE ), screenBufferSize );
//wykonanie tych samych działań przy nowych rozmiarach bufora
ScrollConsoleScreenBuffer( GetStdHandle( STD_OUTPUT_HANDLE ), & lpScrollRectangle, NULL, dwDestinationOrigin, & lpFill );
return 0;
}

Wymagania

Minimalny system klienta	Windows 2000 Professional (tylko aplikacje biurowe).
Minimalny system serwera	Windows 2000 Server (tylko aplikacje biurowe).
Nagłówek	Wincon.h (dołącza Windows.h)
Biblioteka	Kernel32.lib
DLL	Kernel32.dll
UNICODE	ScrollConsoleScreenBufferW
ANSI	ScrollConsoleScreenBufferA

Linki zewnętrzne

http://msdn.microsoft.com/en-us/library/windows/desktop/ms685107(v=vs.85).aspx

Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem jest zabronione.

Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.