SetConsoleTitle

[funkcja] Zmienia tytuł okna konsoli.

Składnia

#include <windows.h>

BOOL WINAPI SetConsoleTitle( LPCTSTR lpConsoleTitle );

Argumenty

Argument	Opis
LPCTSTR lpConsoleTitle	Łańcuch znaków, który ma zostać wyświetlony na pasku tytułowym okna konsoli. Całkowita długość łańcucha musi być mniejsza niż 64 tysiące znaków.

Zwracana wartość

Zwraca wartość różną od zera w przypadku sukcesu. W przeciwnym wypadku funkcja zwraca wartość 0.

Aby uzyskać rozszerzone informacje o błędzie, wywołaj funkcję _{» WinAPI ♦}GetLastError.

Opis szczegółowy

Funkcja zmienia tytuł okna konsoli. Gdy proces zakończy swoje działanie, system przywraca oryginalny tytuł okna konsoli.

Niniejsza funkcja używa zarówno kodowania Unicode jak i 8-bitowych znaków dla aktualnej strony kodowej konsoli. Domyślnym kodowaniem dla konsoli jest OEM-owa strona kodowa systemu. Aby zmienić stronę kodową konsoli, użyj funkcji SetConsoleCP lub SetConsoleOutputCP.

Wymagania

Minimalny obsługiwany klient	Windows 2000 Professional
Minimalny obsługiwany serwer	Windows 2000 Server
Biblioteka	Kernel32.lib
DLL	Kernel32.dll
Nazwa Unicode	SetConsoleTitleW
Nazwa ANSI	SetConsoleTitleA

Przykład

#include <windows.h>

int main()
{
SetConsoleTitleA( "Nowy napis na belce tytułowej okna konsoli" );
return 0;
}

Zagadnienia powiązane

GetConsoleTitle	Pobiera aktualny tytuł okna konsoli. (funkcja)

Linki zewnętrzne

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