GetWindowText

Funkcja GetWindowText kopiuje tekst paska tytułu określonego okna (jeśli istnieje) do buforu. Jeśli określonego okna jest formantem, tekst formantu zostanie skopiowany. Jednak GetWindowText nie można pobrać tekst formantu w innej aplikacji.

int GetWindowText ( HWND  hWnd, / dojście do okna lub sterowania tekstemLPTSTRlpString, / / adres buforu dla tekstuintnMaxCount / / maksymalna liczba znaków do kopiowania);
 

Parametry

hWnd
Dojście do okna lub formantu zawierającego tekst.
lpString
Wskaźnik do buforu, który będzie odbierał tekstu.
nMaxCount
Określa maksymalną liczbę znaki do skopiowania do buforu, włączając znak NULL. Jeśli tekst przekracza ten limit, zostanie obcięta.

Zwraca wartości

Jeśli funkcja, wartość zwracany jest długością w znaki ciągu skopiowane, nie włączając kończącego znaku null. Jeśli okno ma pasek tytułu lub tekstu, jeśli pasek tytułu jest pusta lub uchwyt okna lub kontroli jest nieprawidłowy, wartość zwracany jest równa zero. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError.

Ta funkcja nie może pobrać tekst formant edycyjny w innej aplikacji.

Uwagi

Jeśli okno docelowe jest własnością bieżącego procesu, GetWindowText powoduje, że wiadomość WM_GETTEXT do wysłania do określonego okna lub kontroli. Jeśli okno docelowe jest własnością innego procesu i ma podpis, GetWindowText pobiera tekst podpisu okna. Jeśli okno jest podpis, wartość zwracany jest ciąg pusty.

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Wymaga wersja 1.0 lub nowsza.
Nagłówka:Zadeklarowane w pliku winuser.h.
Importowanie biblioteki:Należy użyć user32.lib.
Unicode:Implementowane jako wersje Unicode i ANSI w systemie Windows NT.

Zobacz też

Omówienie Windows, okno funkcji, GetWindowTextLength, SetWindowText, WM_GETTEXT

Index