GetDlgItemInt 函式 (winuser.h)
將對話框中指定控件的文字轉譯成整數值。
語法
UINT GetDlgItemInt(
[in] HWND hDlg,
[in] int nIDDlgItem,
[out, optional] BOOL *lpTranslated,
[in] BOOL bSigned
);
參數
[in] hDlg
類型： HWND
包含相關控件之對話框的句柄。
[in] nIDDlgItem
類型： int
要翻譯其文字之控件的標識碼。
[out, optional] lpTranslated
類型： BOOL*
表示成功或失敗 (TRUE 表示成功， FALSE 表示失敗) 。
如果此參數為 NULL，則函式不會傳回成功或失敗的相關信息。
[in] bSigned
類型： BOOL
指出函式是否應該在開頭檢查減號的文字，並在找到一個 (TRUE 時傳回帶正負號的整數值，指定應該這麼做， FALSE 表示不應該) 。
傳回值
類型： UINT
如果函式成功， lpTranslated 所指向的變數會設定為 TRUE，而傳回值則是控件文字的轉譯值。
如果函式失敗， lpTranslated 所指向的變數會設定為 FALSE，而傳回值為零。 請注意，因為零是可能的轉譯值，所以零的傳回值本身不會表示失敗。
如果 lpTranslated 為 NULL，則函式不會傳回成功或失敗的相關信息。
請注意，如果 bSigned 參數為 TRUE ，而且文字開頭有減號 (- ) ，GetDlgItemInt 會將文字轉譯成帶正負號的整數值。 否則，函式會建立不帶正負號的整數值。 若要在此案例中取得適當的值，請將傳回值轉換成 int 類型。
若要取得擴充的錯誤資訊，請呼叫 GetLastError。
備註
GetDlgItemInt 函式會傳送控件WM_GETTEXT訊息，以擷取指定控件的文字。 函式會移除文字開頭的任何額外空格，然後轉換小數字數，來轉譯擷取的文字。 函式會在到達文字結尾或遇到非數值字元時停止翻譯。
如果轉譯的值大於帶正負號數位的INT_MAX (，則 GetDlgItemInt 函式會傳回零，或針對未帶正負號) 的數位傳回UINT_MAX () 。
範例
如需範例，請參閱 建立無模式對話框。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | winuser.h (包括 Windows.h) |
| 程式庫 | User32.lib |
| Dll | User32.dll |
| API 集合 | ext-ms-win-ntuser-dialogbox-l1-1-2 (於 Windows 10 10.0.10240 版) |
另請參閱
概念
參考