GetWindowText

Składnia

Argumenty

Argument	Opis
hWnd	Uchwyt do okna zawierającego tekst.
lpString	Bufor przyjmujący tekst. Jeśli łańcuch znaków jest zbyt długi, zostanie skrócony i zakończony znakiem zerowym.
nMaxCount	Maksymalna liczba znaków do skopiowania do bufora (włączając znak zerowy).

Zwracana wartość

Jeśli funkcja zakończy się prawidłowo, zwracaną wartością jest długość (w znakach) skopiowanego łańcucha znaków (bez znaku zerowego). Jeśli okno nie ma pola z tekstem, tekst w polu jest pusty lub uchwyt do okna jest nieprawidłowy, zwracaną wartością jest zero. Aby uzyskać rozszerzone informacje o błędzie, wywołaj funkcję _{» WinAPI ♦} GetLastError.

Dodatkowe informacje

Jeśli określone okno jest własnością bieżącego procesu, funkcja wysyła komunikat WM_GETTEXT do określonego okna. Jeśli określone okno jest własnością innego procesu mającego pole z tekstem, funkcja pobiera ten tekst. Jeśli okno nie ma pola z tekstem, zwracaną wartością jest pusty łańcuch znaków. To pozwala programom na wywołanie tej funkcji bez otrzymania braku odpowiedzi, jeśli proces, który jest właścicielem wybranego okna nie odpowiada. Jednak jeśli wybrane okno nie odpowiada i należy do wywoływanego programu, funkcja spowoduje, że wywoływany program przetsanie odpowiadać. Aby pobrać tekst kontrolki z innego procesu, wyślij komunikat WM_GETTEXT bezpośrednio zamiast wywoływania tej funkcji.

Wymagania

Minimalny system klienta	Windows 2000 Professional (tylko aplikacje biurowe).
Minimalny system serwera	Windows 2000 Server (tylko aplikacje biurowe).
Nagłówek	Winuser.h (dołącza Windows.h)
Biblioteka	User32.lib
DLL	User32.dll
UNICODE	GetWindowTextW
ANSI	GetWindowTextA

Linki zewnętrzne

• http://msdn.microsoft.com/en-us/library/ms633520(vs.85).aspx