SetWindowText

Funkcję SetWindowText zmiany tekst paska tytułu określonego okna (jeśli istnieje). Jeśli określonego okna jest formantem, tekst formantu jest zmieniony. Jednakże SetWindowText nie można zmienić tekst formantu w innej aplikacji.

(BOOL SetWindowText HWND  hWnd, / / dojście do okna lub kontroliLPCTSTRlpString / / adresu ciągu);
 

Parametry

hWnd
Dojście do okna lub kontroli, których tekst ma być zmieniony.
lpString
Wskaźnik ciąg zakończony zerem, by służyć jako nowy tekst tytułu lub formantu.

Zwraca wartości

Jeśli funkcja, wartość zwracany jest różna od zera.

Jeśli funkcja zawiedzie, wartość zwracany jest równa zero. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError.

Uwagi

Jeśli okno docelowe jest własnością bieżącego procesu, SetWindowText powoduje, że wiadomość WM_SETTEXT do wysłania do określonego okna lub kontroli. Jeśli formant jest formantem pola listy utworzonej przy użyciu stylu WS_CAPTION, jednak SetWindowText ustawia tekst dla formantu, a nie dla wpisów pole listy.

Funkcję SetWindowText nie rozwiń znaki tabulacji (kod ASCII 0x09). Znaki tabulacji są wyświetlane jako znaki kreski pionowej (|).

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, GetWindowText, WM_SETTEXT

Index