SetDlgItemTextA-Funktion (winuser.h)

Artikel
11/20/2024

Legt den Titel oder Text eines Steuerelements in einem Dialogfeld fest.

Syntax

BOOL SetDlgItemTextA(
  [in] HWND   hDlg,
  [in] int    nIDDlgItem,
  [in] LPCSTR lpString
);

Parameter

[in] hDlg

Typ: HWND-

Ein Handle für das Dialogfeld, das das Steuerelement enthält.

[in] nIDDlgItem

Typ: int

Das Steuerelement mit einem festzulegenden Titel oder Text.

[in] lpString

Typ: LPCTSTR-

Der text, der in das Steuerelement kopiert werden soll.

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

Die SetDlgItemText--Funktion sendet eine WM_SETTEXT Nachricht an das angegebene Steuerelement.

Beispiele

Ein Beispiel finden Sie unter Verwenden von Listenfeldern.

Anmerkung

Der winuser.h-Header definiert SetDlgItemText 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-dialogbox-l1-1-0 (eingeführt in Windows 8)