GetDlgItemInt

Die GetDlgItemInt -Funktion übersetzt den Text eines angegebenen Steuerelements in einem Dialogfeld in einen ganzzahligen Wert.

(UINT GetDlgItemInt HWND  hDlg,, / / handle auf das DialogfeldintnIDDlgItem, / / SteuerelementbezeichnerBOOL* LpTranslated,  / / zeigt auf Variable zum Empfangen von Erfolg/Misserfolg / / IndikatorBOOLbSigned / / gibt an, ob der Wert mit oder ohne Vorzeichen ist);
 

Parameter

hDlg
Behandeln Sie, um das Dialogfeld mit dem Steuerelement von Interesse.
nIDDlgItem
Dialogfeld Element-ID, die das Steuerelement angibt, dessen Text übersetzt werden soll.
lpTranslated
Zeiger auf eine boolesche Variable, die einen Funktion Erfolg/Misserfolg Wert empfängt. TRUE, wenn erfolgreich, FALSE gibt Fehler.

Dieser Parameter ist optional: NULL sein. In diesem Fall gibt die Funktion keine Informationen über Erfolg oder Misserfolg.

bSigned
Gibt an, ob die Funktion sollte überprüfen Sie den Text für ein Minus-Zeichen am Anfang und einen Ganzzahl mit Vorzeichen-Wert zurückgeben, wenn er eine findet. TRUE gibt an, dass dies getan, FALSE, dass es nicht sein sollte.

Rückgabewerte

Wenn die Funktion erfolgreich ausgeführt wird, die Variable, auf die LpTranslated auf TRUE festgelegt ist, und der Rückgabewert ist der übersetzte Wert der Steuerelementtext.

Wenn die Funktion fehlschlägt, ist die Variable, auf den LpTranslated auf FALSE festgelegt, und der Rückgabewert ist 0 (null). Beachten Sie, dass da NULL einen möglichen übersetzten Wert ist, ein Rückgabewert von 0 (null) nicht von selbst fehlschlagen anzugeben ist.

Wenn LpTranslated NULL ist, gibt die Funktion keine Informationen über Erfolg oder Misserfolg.

Wenn der bSigned -Parameter TRUE ist, gibt an, dass der Wert abgerufen werden soll ein Ganzzahlwert mit Vorzeichen ist, umgewandelt den Rückgabewert in einen Int -Typ. Rufen Sie Fehlerinformationen verlängert bekommen, GetLastError.

Bemerkungen

Die GetDlgItemInt -Funktion Ruft den Text des angegebenen Steuerelements dem Steuerelement WM_GETTEXT Nachricht senden. Die Funktion verschiebt den abgerufenen Text um Strippen zusätzlichen Leerzeichen am Anfang des Textes und konvertieren dann die Dezimalstellen. Die Funktion beendet das übersetzen, wenn es das Ende des Textes erreicht oder ein nicht-numerische Zeichen stößt.

Wenn der bSigned -Parameter TRUE, die GetDlgItemInt -Funktion überprüft ein Minuszeichen (-) am Anfang des Textes ist und den Text in eine Ganzzahl mit Vorzeichen-Wert übersetzt. Andernfalls erstellt die Funktion einen Ganzzahlwert ohne Vorzeichen.

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

Windows CE: Textzeichenfolgen mit mehr als 48 Zeichen können nicht übersetzt werden.

QuickInfo

&Nbsp; Windows NT: Version 3.1 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Version 1.0 oder höher benötigt.
Header:In winuser.h deklarierten.
Importieren Bibliothek:Verwenden Sie user32.lib.

Siehe auch

Übersicht über Dialogfelder, Dialogfeld Feld Funktionen, GetDlgCtrlID, GetDlgItem, GetDlgItemText, SetDlgItemInt

Index