SetConsoleWindowInfo

[funkcja] Ustawia rozmiar i pozycję okna bufora ekranu konsoli.

Składnia

#include <windows.h>

BOOL WINAPI SetConsoleWindowInfo( HANDLE hConsoleOutput, BOOL bAbsolute, const SMALL_RECT * lpConsoleWindow );

Argumenty

Argument	Opis
hConsoleOutput	Uchwyt do bufora wejściowego konsoli. Uchwyt musi mieć dostęp `GENERIC_READ`.
bAbsolute	Jeśli wartość tego argumentu wynosi `TRUE`, współrzędne określają lewy górny i prawy dolny róg okna, jeśli `FALSE`, to są określone względem obecnej pozycji rogu okna.
lpConsoleWindow	Wskaźnik do struktury `SMALL_RECT` zawierającej współrzędne okna.

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

Funkcja zakończy się niepowodzeniem, jeśli prostokąt określonego okna wykracza poza granice bufora ekranu konsoli. To oznacza, że składowe Top i Left zawarte w argumencie lpConsoleWindow nie mogą być mniejsze od zera. Podobnie składowe Bottom i Right nie mogą przekroczyć rozmiarów bufora ekranu konsoli. Funkcja również zakończy się niepowodzeniem, jeśli składowa Right jest mniejsza lub równa składowej Left albo składowa Bottom jest mniejsza lub równa składowej Top Dla konsoli, które mają więcej, niż jeden bufor ekranu, zmiany obszaru okna dla jednego bufora nie powodują zmian w innych buforach. Ta funkcja może być użyta do przewijania treści bufora ekranu konsoli przez przesuwanie pozycji prostokąta okna bez zmiany jego rozmiaru.

Zagadnienia powiązane

GetConsoleScreenBufferInfo	Pobiera informacje o określonym buforze ekranu konsoli. (funkcja)
GetLargestConsoleWindowSize	Pobiera rozmiar największego możliwego do wyświetlenia okna konsoli używającego obecnej czcionki. (funkcja)

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

Linki zewnętrzne

http://msdn.microsoft.com/en-us/library/windows/desktop/ms686125(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.