แสดงพร้อมท์ในกล่องโต้ตอบ รอให้ผู้ใช้ใส่ข้อความหรือคลิกปุ่ม และส่งกลับ สตริง ที่มีเนื้อหาของกล่องข้อความ
ไวยากรณ์
InputBox ( prompt [, title ] [, default ] [, xpos ] [, ypos ] [, helpfile ] [, context ] )
ไวยากรณ์ของฟังก์ชัน InputBox มีอาร์กิวเมนต์ดังนี้
|
อาร์กิวเมนต์ |
คำอธิบาย |
|
พร้อมท์ |
จำเป็น นิพจน์สตริงที่แสดงเป็นข้อความในกล่องโต้ตอบ ความยาวสูงสุดของ พร้อมท์ คือประมาณ 1024 อักขระ ขึ้นอยู่กับความกว้างของอักขระที่ใช้ ถ้า พร้อมท์ ประกอบด้วยบรรทัดมากกว่าหนึ่งบรรทัด คุณสามารถแยกบรรทัดโดยใช้อักขระขึ้นบรรทัดใหม่ (Chr(13)) อักขระตัวบรรทัด (Chr(10)) หรืออักขระขึ้นบรรทัดใหม่เป็นอักขระขึ้นบรรทัดใหม่ (Chr(13) & Chr(10)) ระหว่างแต่ละบรรทัด |
|
ชื่อ เรื่อง |
ไม่จำเป็น นิพจน์สตริงที่แสดงในแถบชื่อเรื่องของกล่องโต้ตอบ ถ้าคุณละ ชื่อเรื่อง ชื่อแอปพลิเคชันจะถูกวางในแถบชื่อเรื่อง |
|
เริ่มต้น |
ไม่จำเป็น นิพจน์สตริงที่แสดงในกล่องข้อความเป็นการตอบสนองเริ่มต้นถ้าไม่มีการป้อนข้อมูลอื่น ถ้าคุณละ ค่าเริ่มต้น ไว้ กล่องข้อความจะแสดงเป็นว่างเปล่า |
|
xpos |
ไม่จำเป็น นิพจน์ตัวเลขที่ระบุระยะห่างแนวนอนของขอบซ้ายของกล่องโต้ตอบจากขอบด้านซ้ายของหน้าจอเป็นหน่วยทวิป ถ้าละ xpos ไว้ กล่องโต้ตอบจะถูกจัดกึ่งกลางในแนวนอน |
|
ypos |
ไม่จำเป็น นิพจน์ตัวเลขที่ระบุเป็นหน่วยทวิป ซึ่งเป็นระยะห่างแนวตั้งของขอบบนของกล่องโต้ตอบจากด้านบนของหน้าจอ ถ้าละ ypos ไว้ กล่องโต้ตอบจะอยู่ในตําแหน่งแนวตั้งประมาณหนึ่งในสามของทางลงมาบนหน้าจอ |
|
helpfile |
ไม่จำเป็น นิพจน์สตริงที่ระบุไฟล์วิธีใช้เพื่อใช้ในการแสดงวิธีใช้แบบตามบริบทสําหรับกล่องโต้ตอบ ถ้ามี helpfile ให้ไว้ ต้องระบุ บริบท ด้วย |
|
บริบท |
ไม่จำเป็น นิพจน์ตัวเลขที่เป็นหมายเลขบริบทวิธีใช้ที่กําหนดให้กับหัวข้อวิธีใช้ที่เหมาะสมโดยผู้เขียนวิธีใช้ ถ้ามี เนื้อหา อยู่ จะต้องมี helpfile ให้ไว้ด้วย |
ข้อสังเกต
เมื่อทั้ง helpfile และบริบทมีให้ ผู้ใช้สามารถกด F1 (Windows) หรือ HELP (Macintosh) เพื่อดูหัวข้อวิธีใช้ที่สอดคล้องกับบริบท บาง แอปพลิเคชันโฮสต์ ตัวอย่างเช่น Microsoft Office Excel 2007 จะเพิ่มปุ่ม วิธีใช้ ลงในกล่องโต้ตอบโดยอัตโนมัติ ถ้าผู้ใช้คลิก ตกลง หรือกด ENTER ฟังก์ชัน กล่องป้อนข้อมูล จะส่งกลับค่าใดๆ ก็ตามที่อยู่ในกล่องข้อความ ถ้าผู้ใช้คลิก ยกเลิก ฟังก์ชันจะส่งกลับสตริงที่มีความยาวเป็นศูนย์ ("")
หมายเหตุ: เมื่อต้องการระบุอาร์กิวเมนต์ที่มีชื่อมากกว่า นิพจน์ อาร์กิวเมนต์แรก เมื่อต้องการละบางอาร์กิวเมนต์ที่ใช้ระบุตําแหน่ง คุณต้องใส่ตัวคั่นจุลภาคที่สอดคล้องกัน
ตัวอย่าง
หมายเหตุ: ตัวอย่างต่อไปนี้จะสาธิตการใช้ฟังก์ชันนี้ในโมดูล Visual Basic for Applications (VBA) สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการทํางานกับ VBA ให้เลือก การอ้างอิงสําหรับนักพัฒนา ในรายการดรอปดาวน์ที่อยู่ถัดจาก ค้นหา แล้วใส่คําอย่างน้อยหนึ่งคําในกล่องค้นหา
ตัวอย่างนี้แสดงวิธีการต่างๆ ในการใช้ฟังก์ชัน InputBox เพื่อพร้อมท์ให้ผู้ใช้ใส่ค่า ถ้าละตําแหน่ง x และ y ไว้ กล่องโต้ตอบจะถูกจัดกึ่งกลางสําหรับแกนที่เกี่ยวข้องโดยอัตโนมัติ ตัวแปร MyValue มีค่าที่ป้อนโดยผู้ใช้ ถ้าผู้ใช้คลิก ตกลง หรือกดแป้น ENTER ถ้าผู้ใช้คลิก ยกเลิก สตริงที่มีความยาวเป็นศูนย์จะถูกส่งกลับ
Dim Message, Title, Default, MyValue
Message = "Enter a value between 1 and 3" ' Set prompt.
Title = "InputBox Demo" ' Set title.
Default = "1" ' Set default.
' Display message, title, and default value.
MyValue = InputBox(Message, Title, Default)
' Use Helpfile and context.
' The Help button is added automatically.
MyValue = InputBox(Message, Title,,,,"DEMO.HLP", 10)
' Display dialog box at position 100, 100.
MyValue = InputBox(Message, Title, Default, 100, 100)
