SetWindowTextW-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 SetWindowTextW(
[in] HWND hWnd,
[in, optional] LPCWSTR lpString
);
Parameter
[in] hWnd
Typ: HWND
Ein Handle für das Fenster oder Steuerelement, dessen Text geändert werden soll.
[in, optional] lpString
Typ: LPCWSTR
Der neue Titel oder Steuerelementtext.
Rückgabewert
Typ: BOOL
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Bemerkungen
Wenn sich das Zielfenster im Besitz des aktuellen Prozesses befindet, bewirkt SetWindowText , dass eine WM_SETTEXT Nachricht an das angegebene Fenster oder Steuerelement gesendet wird. Wenn das Steuerelement jedoch ein Listenfeld-Steuerelement ist, das mit der WS_CAPTION-Formatvorlage erstellt wurde, legt SetWindowText den Text für das Steuerelement fest, nicht für die Listenfeldeinträge.
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 Registerkartenzeichen (ASCII-Code 0x09). Tabulatorzeichen werden als vertikale Balkenzeichen (|) angezeigt.
Beispiele
Ein Beispiel finden Sie unter Senden einer Nachricht.
Hinweis
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 Aliases 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
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winuser.h (windows.h einschließen) |
| Bibliothek | User32.lib |
| DLL | User32.dll |
| APIs | ext-ms-win-ntuser-window-l1-1-3 (eingeführt in Windows 10, Version 10.0.10240) |
Weitere Informationen
Konzept
Verweis