แสดงพร้อมท์ในกล่องโต้ตอบ รอให้ผู้ใช้ใส่ข้อความหรือคลิกปุ่ม และส่งกลับ สตริง ที่มีเนื้อหาของกล่องข้อความ
ไวยากรณ์
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) เพื่อดูหัวข้อวิธีใช้ที่สอดคล้องกับบริบทแอปพลิเคชันโฮสต์ บาง แอปพลิเคชันโฮสต์ ยังเพิ่มปุ่ม วิธีใช้ ลงในกล่องโต้ตอบโดยอัตโนมัติอีกด้วย ถ้าผู้ใช้คลิก ตกลง หรือกด 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)