GetDlgItemInt 函式 (winuser.h)

發行項
03/04/2024

將對話框中指定控件的文字轉譯成整數值。

語法

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 版)