ฟังก์ชันGetDlgItemIntแปลข้อความของตัวควบคุมที่ระบุในกล่องโต้ตอบเข้าใช้ค่าจำนวนเต็ม.
(UINT GetDlgItemInt HWND hDlg, / / จัดการกับกล่องโต้ตอบintnIDDlgItem, / / รหัสควบคุมBOOL* lpTranslated, / / ชี้ไปที่ตัวแปรที่จะได้รับความสำเร็จความล้มเหลว / / ตัวบ่งชี้BOOLbSigned / / ระบุว่า มูลค่าจะลงนาม หรือไม่ถูก);
พารามิเตอร์นี้ไม่จำเป็นต้องมีก็ได้: สามารถเป็น NULL ได้ ในกรณีนี้ ฟังก์ชันจะส่งกลับไม่มีข้อมูลเกี่ยวกับความสำเร็จหรือความล้มเหลว.
ถ้าฟังก์ชันสำเร็จ ตัวแปรชี้ไปตามlpTranslatedถูกตั้งค่าเป็น TRUE และค่าส่งกลับ ค่าของตัวควบคุมข้อความแปล.
ถ้าฟังก์ชันล้มเหลว ตัวแปรชี้ไปตามlpTranslatedถูกตั้งค่าเป็น FALSE และส่งคืนค่าเป็นศูนย์ หมายเหตุว่า เนื่องจากศูนย์เป็นค่าแปลได้ ค่าที่ส่งกลับของศูนย์ไม่ได้ ด้วยตัวเองแสดงความล้มเหลว.
ถ้าlpTranslatedเป็น NULL ฟังก์ชันจะส่งกลับไม่มีข้อมูลเกี่ยวกับความสำเร็จหรือความล้มเหลว.
ถ้าพารามิเตอร์bSignedเป็น TRUE การระบุค่าถูกเรียกว่าค่าจำนวนเต็มที่มีลายเซ็น ทอดค่าส่งกลับไปเป็นชนิดint การขอเพิ่มเติมข้อมูลข้อผิดพลาด โทร GetLastError.
ฟังก์ชันGetDlgItemIntดึงข้อความของตัวควบคุมที่กำหนด โดยการส่งตัวควบคุมข้อความ WM_GETTEXT ฟังก์ชันการแปลข้อความดึงข้อมูล โดยการปอกช่องว่างเพิ่มเติมที่จุดเริ่มต้นของข้อความ และการแปลงตัวเลขฐานสิบแล้ว ฟังก์ชันการหยุดการแปลเมื่อมาถึงจุดสิ้นสุดของข้อความ หรือพบอักขระไม่ใช่ตัวเลข.
ถ้าพารามิเตอร์bSignedเป็น TRUE เช็คฟังก์ชันGetDlgItemIntสำหรับเครื่องหมาย (-) จุดเริ่มต้นของข้อความ และแปลข้อความเป็นค่าจำนวนเต็มที่มีการเซ็นชื่อ มิฉะนั้น ฟังก์ชันสร้างใช้ค่าจำนวนเต็มที่ไม่มีลายเซ็น.
ฟังก์ชันGetDlgItemIntจะส่งกลับค่าศูนย์ถ้าค่าแปลมากกว่า INT_MAX (สำหรับตัวเลขที่มีการเซ็นชื่อ) หรือ UINT_MAX (สำหรับตัวเลขที่ไม่ได้ลงทะเบียน).
Windows CE: ไม่สามารถแปลสตริงข้อความ โดยใช้อักขระที่มากกว่า 48.
nbsp Windows &NT:ต้องการเวอร์ชัน 3.1 หรือรุ่นที่ใหม่กว่า
Windows:ต้องใช้ Windows 95 หรือรุ่นที่ใหม่กว่า
Windows CE:ต้องการเวอร์ชัน 1.0 หรือรุ่นใหม่กว่า
หัวข้อ:ประกาศใน winuser.h
ไลบรารีที่นำเข้า:ใช้ user32.lib.
ภาพรวมของกล่องโต้ตอบฟังก์ชันของกล่องโต้ตอบ GetDlgCtrlID, GetDlgItem, GetDlgItemText, SetDlgItemInt