SetWindowTextA-Funktion (winuser.h)
Ändert den Text der Titelleiste des angegebenen Fensters (sofern vorhanden). Wenn das angegebene Fenster ein Steuerelement ist, wird der Text des Steuerelements geändert. SetWindowText- kann jedoch den Text eines Steuerelements in einer anderen Anwendung nicht ändern.
Syntax
BOOL SetWindowTextA(
[in] HWND hWnd,
[in, optional] LPCSTR lpString
);
Parameter
[in] hWnd
Typ: HWND-
Ein Handle für das Fenster oder Steuerelement, dessen Text geändert werden soll.
[in, optional] lpString
Typ: LPCTSTR-
Der neue Titel oder Steuerelementtext.
Rückgabewert
Typ: BOOL-
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Wenn das Zielfenster dem aktuellen Prozess gehört, bewirkt SetWindowText-, dass eine WM_SETTEXT Nachricht an das angegebene Fenster oder Steuerelement gesendet wird. Wenn es sich bei dem Steuerelement um ein Listenfeld-Steuerelement handelt, das mit der WS_CAPTION Formatvorlage erstellt wurde, SetWindowText den Text für das Steuerelement und nicht für die Listenfeldeinträge festlegt.
Um den Text eines Steuerelements in einem anderen Prozess festzulegen, senden Sie die WM_SETTEXT Nachricht direkt, anstatt SetWindowText-aufzurufen.
Die SetWindowText--Funktion erweitert keine Tabstoppzeichen (ASCII-Code 0x09). Tabstoppzeichen werden als vertikale Balkenzeichen (|) angezeigt.
Beispiele
Ein Beispiel finden Sie unter Senden einer Nachricht.
Anmerkung
Der winuser.h-Header definiert SetWindowText als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform- | Fenster |
Header- | winuser.h (enthalten Windows.h) |
Library | User32.lib |
DLL- | User32.dll |
API-Satz | ext-ms-win-ntuser-window-l1-1-3 (eingeführt in Windows 10, Version 10.0.10240) |
Siehe auch
Konzeptionelle
Referenz-