共用方式為


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,而傳回值為零。 請注意,因為零是可能的轉譯值,所以零的傳回值本身不會表示失敗。

如果 lpTranslatedNULL,則函式不會傳回成功或失敗的相關信息。

請注意,如果 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 版)

另請參閱

概念

對話框

GetDlgCtrlID

GetDlgItem

GetDlgItemText

參考

SetDlgItemInt