SetDlgItemInt-Funktion (winuser.h)

Artikel
08/28/2023

Legt den Text eines Steuerelements in einem Dialogfeld auf die Zeichenfolgendarstellung eines angegebenen ganzzahligen Werts fest.

Syntax

BOOL SetDlgItemInt(
  [in] HWND hDlg,
  [in] int  nIDDlgItem,
  [in] UINT uValue,
  [in] BOOL bSigned
);

Parameter

[in] hDlg

Typ: HWND

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

[in] nIDDlgItem

Typ: int

Das zu ändernde Steuerelement.

[in] uValue

Typ: UINT

Der ganzzahlige Wert, der zum Generieren des Elementtexts verwendet wird.

[in] bSigned

Typ: BOOL

Gibt an, ob der uValue-Parameter signiert oder nicht signiert ist. Wenn dieser Parameter TRUE ist, wird uValue signiert. Wenn dieser Parameter TRUE ist und uValue kleiner als 00 ist, wird ein Minuszeichen vor der ersten Ziffer in der Zeichenfolge platziert. Wenn dieser Parameter FALSE ist, ist uValue ohne Vorzeichen.

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.

Hinweise

Um den neuen Text festzulegen, sendet diese Funktion eine WM_SETTEXT Nachricht an das angegebene Steuerelement.

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 (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-dialogbox-l1-1-2 (eingeführt in Windows 10, Version 10.0.10240)