Panel użytkownika
Nazwa użytkownika:
Hasło:
Nie masz jeszcze konta?
Hasło nie zostało zweryfikowane
Niniejsze hasło zostało opracowane, jednak nie zostało ono zweryfikowane przez administrację serwisu. Jeżeli znalazłeś błędy merytoryczne w niniejszym dokumencie, prosimy o ich zgłoszenie na forum w dziale Znalezione błędy.
Opracował: jankowalski25
Biblioteki C/C++

WriteConsoleOutputCharacter

[funkcja] Kopiuje określoną liczbę znaków do kolejnych komórek bufora ekranu konsoli, zaczynając od określonej lokalizacji.

Składnia

C/C++
#include <windows.h>

BOOL WINAPI WriteConsoleOutputCharacter(
HANDLE hConsoleOutput,
LPCTSTR lpCharacter,
DWORD nLength,
COORD dwWriteCoord,
LPDWORD lpNumberOfCharsWritten
);

Argumenty

ArgumentOpis
hConsoleOutputUchwyt do bufora ekranu konsoli. Uchwyt musi mieć dostęp GENERIC_WRITE.
lpCharacterZnaki do zapisania do bufora ekranu konsoli. Miejsce w pamięci na ten bufor jest alokowane na stercie dla procesu zajmującego 64 KB pamięci. Maksymalny rozmiar bufora zależy od użycia sterty.
nLengthLiczba znaków do zapisania.
dwWriteCoordStruktura » WinAPICOORD określająca współrzędne pierwszej komórki w buforze ekranu konsoli, dla której atrybuty zostaną zapisane.
lpNumberOfCharsWrittenWskaźnik do zmiennej pobierającej liczbę aktualnie zapisanych znaków.

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ę » WinAPIGetLastError.

Dodatkowe informacje

Jeśli liczba znaków do zapisania wykracza poza koniec wiersza bufora ekranu, znaki są zapisywane do następnego wiersza. Jeśli liczba znaków do zapisania wykracza poza koniec bufora ekranu konsoli, znaki są zapisywane do końca bufora ekranu konsoli. Wartości atrybutów na zapisywanych pozycjach nie są zmieniane. Ta funkcja używa 8-bitowych znaków Unicode z obecnej strony kodowej konsoli. Domyślna strona kodowa jest stroną kodową OEM. Do zmiany strony kodowej służą funkcje » WinAPISetConsoleCP oraz » WinAPISetConsoleOutputCP. Można również użyć polecenia
chcp
 lub
mode con cp select=id_strony_kodowej
.

Wymagania

Minimalny system klientaWindows 2000 Professional (tylko aplikacje biurowe).
Minimalny system serweraWindows 2000 Server (tylko aplikacje biurowe).
NagłówekWincon.h (dołącza Windows.h)
BibliotekaKernel32.lib
DLLKernel32.dll
UNICODEWriteConsoleOutputCharacterW
ANSIWriteConsoleOutputCharacterA

Linki zewnętrzne