GetConsoleTitle

[funkcja] Pobiera aktualny tytuł okna konsoli.

Składnia

#include <windows.h>

DWORD WINAPI GetConsoleTitle(
LPTSTR lpConsoleTitle,
DWORD nSize
);

Argumenty

Argument	Opis
LPTSTR lpConsoleTitle	Wskaźnik na bufor do którego zostanie wczytany aktualny tytuł okna konsoli. Zwrócony łańcuch znaków będzie zakończony znakiem terminalnym. Jeżeli bufor jest za mały aby pomieścić cały tytuł okna, funkcja zapisze do bufora tyle znaków ile się zmieści oraz zakończy go znakiem terminalnym.
DWORD nSize	Rozmiar bufora przekazanego poprzez pierwszy argument. Rozmiar jest wyrażony w liczbie 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 pobiera aktualny 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	GetConsoleTitleW
Nazwa ANSI	GetConsoleTitleA

Przykład

#include <windows.h>
#include <tchar.h>

int main()
{
TCHAR sStary[ 1024 ];
GetConsoleTitle( sStary, 1024 );
SetConsoleTitle( _T( "Nowy tytuł konsoli" ) );
MessageBox( NULL, _T( "Nowy tytuł konsoli został ustawiony" ), _T( "Komunikat" ), MB_OK );
SetConsoleTitle( sStary );
MessageBox( NULL,( _T( "Stary tytuł konsoli został ustawiony" ), _T( "Komunikat" ), MB_OK );
return 0;
}

Zagadnienia powiązane

SetConsoleTitle	Zmienia tytuł okna konsoli. (funkcja)

Linki zewnętrzne

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