GetDlgItemInt

De GetDlgItemInt functie vertaalt de tekst van een opgegeven besturingselement in een dialoogvenster in een integer-waarde.

(UINT GetDlgItemInt HWND  hDlg, / / ingang naar het dialoogvensterintnIDDlgItem, / / control identifierBOOL* lpTranslated,  / / punten aan variabele te ontvangen succes/mislukking / / indicatorBOOLbSigned / / geeft aan of de waarde is ondertekend of niet-ondertekende);
 

Parameters

hDlg
Ingang naar het dialoogvenster met het besturingselement van belang.
nIDDlgItem
Dialoogvenster item-id dat aangeeft van het besturingselement waarvan de tekst is te vertalen.
lpTranslated
Aanwijzer naar een Boole-variabele die een functie succes/mislukking waarde ontvangt. TRUE geeft aan succes, FALSE geeft mislukking aan.

Deze parameter is optioneel: NULL kan worden. In dat geval retourneert de functie geen informatie over succes of falen.

bSigned
Hiermee geeft u aan of de functie moet onderzoeken van de tekst voor een minteken aan het begin en een ondertekende integer-waarde retourneren als het er één vindt. TRUE geeft aan dat dit zijn moet gedaan, FALSE dat het niet zou moeten.

Retourwaarden

Als de functie slaagt, de variabele waarnaar wordt verwezen door lpTranslated is ingesteld op TRUE, en de geretourneerde waarde is de vertaalde waarde van het besturingselement tekst.

Als de functie mislukt, de variabele waarnaar wordt verwezen door lpTranslated is ingesteld op FALSE, en de retourwaarde is nul. Merk op dat, aangezien een mogelijk vertaalde de waarde nul wordt, een retourwaarde van nul niet door zelf mislukking aangeven doet.

Als lpTranslated NULL is, retourneert de functie geen informatie over succes of falen.

Als de bSigned -parameter TRUE is, waarbij wordt aangegeven dat de waarde moet worden opgehaald een ondertekende integer-waarde, is de retourwaarde een int type gegoten. Te krijgen uitgebreide foutinformatie, Bel GetLastError.

Opmerkingen

De GetDlgItemInt functie wordt de tekst van het opgegeven besturingselement opgehaald via het besturingselement een WM_GETTEXT bericht. De functie vertaalt de opgehaalde tekst door strippen geen extra spaties aan het begin van de tekst en vervolgens de decimalen te converteren. De functie stopt wanneer het bereikt het einde van de tekst of een niet-numeriek teken ontmoetingen vertalen.

Als de parameter bSigned is ingesteld op TRUE, de GetDlgItemInt functie controles voor een minteken (-) aan het begin van de tekst en de tekst in een ondertekende integer-waarde vertaalt. Anders, de functie maakt een niet-ondertekende integer-waarde.

De functie GetDlgItemInt retourneert nul als de vertaalde waarde groter dan INT_MAX (voor ondertekende getallen) of UINT_MAX (voor niet-ondertekende getallen is).

Windows CE: Tekenreeksen met meer dan 48 tekens kunnen niet worden vertaald.

Syntaxisinfo

nbsp; Windows &NT: versie 3.1 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Versie 1.0 of hoger vereist.
Header:Verklaard in winuser.h.
Bibliotheek importeren:User32.lib gebruiken.

Zie ook

Overzicht van dialoogvenster vakken, dialoogvenster vak functies, GetDlgCtrlID, GetDlgItem, GetDlgItemText, SetDlgItemInt

Index