GetDlgItemInt-Funktion (winuser.h)

Artikel
08/27/2023

Übersetzt den Text eines angegebenen Steuerelements in einem Dialogfeld in einen ganzzahligen Wert.

Syntax

UINT GetDlgItemInt(
  [in]            HWND hDlg,
  [in]            int  nIDDlgItem,
  [out, optional] BOOL *lpTranslated,
  [in]            BOOL bSigned
);

Parameter

[in] hDlg

Typ: HWND

Ein Handle für das Dialogfeld, das das steuerelement enthält, das von Interesse ist.

[in] nIDDlgItem

Typ: int

Der Bezeichner des Steuerelements, dessen Text übersetzt werden soll.

[out, optional] lpTranslated

Typ: BOOL*

Gibt Erfolg oder Fehler an (TRUE gibt den Erfolg an, FALSE einen Fehler).

Wenn dieser Parameter NULL ist, gibt die Funktion keine Informationen über Erfolg oder Fehler zurück.

[in] bSigned

Typ: BOOL

Gibt an, ob die Funktion den Text am Anfang auf ein Minuszeichen untersuchen und einen ganzzahligen Wert mit Vorzeichen zurückgibt, wenn sie einen wert findet (TRUE gibt an, dass dies getan werden soll, FALSE nicht).

Rückgabewert

Typ: UINT

Wenn die Funktion erfolgreich ist, wird die Variable, auf die von lpTranslated verwiesen wird, auf TRUE festgelegt, und der Rückgabewert ist der übersetzte Wert des Steuerelementtexts.

Wenn die Funktion fehlschlägt, wird die Variable, auf die von lpTranslated verwiesen wird, auf FALSE festgelegt, und der Rückgabewert ist 0. Beachten Sie, dass ein Rückgabewert von 0 an sich nicht auf einen Fehler hinweist, da null ein möglicher übersetzter Wert ist.

Wenn lpTranslatedNULL ist, gibt die Funktion keine Informationen über Erfolg oder Fehler zurück.

Beachten Sie, dass GetDlgItemInt den Text in einen ganzzahligen Wert mit Vorzeichen übersetzt, wenn der bSigned-ParameterTRUE ist und am Anfang des Texts ein Minuszeichen (–) vorhanden ist. Andernfalls erstellt die Funktion einen ganzzahligen Wert ohne Vorzeichen. Um in diesem Fall den richtigen Wert zu erhalten, wandeln Sie den Rückgabewert in einen int-Typ um.

Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die GetDlgItemInt-Funktion ruft den Text des angegebenen Steuerelements ab, indem dem Steuerelement eine WM_GETTEXT Nachricht gesendet wird. Die Funktion übersetzt den abgerufenen Text, indem zusätzliche Leerzeichen am Anfang des Texts entfernt und dann die Dezimalstellen konvertiert werden. Die Funktion beendet die Übersetzung, wenn sie das Ende des Texts erreicht oder auf ein nichtumerisches Zeichen stößt.

Die GetDlgItemInt-Funktion gibt null zurück, wenn der übersetzte Wert größer als INT_MAX (für vorzeichenierte Zahlen) oder UINT_MAX (für zahlen ohne Vorzeichen) ist.

Beispiele

Ein Beispiel finden Sie unter Erstellen eines dialogfelds ohne Modus.

Anforderungen

Anforderung	Wert
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)