Hiển thị lời nhắc trong hộp thoại, chờ người dùng nhập văn bản hoặc bấm vào một nút và trả về một Chuỗi chứa nội dung của hộp văn bản.
Cú pháp
InputBox ( prompt [, title ] [, default ] [, xpos ] [, ypos ] [, helpfile ] [, context ] )
Cú pháp hàm InputBox có các đối số sau đây:
Đối số |
Mô tả |
---|---|
Nhắc |
Bắt buộc. Biểu thức chuỗi được hiển thị dưới dạng thông báo trong hộp thoại. Độ dài tối đa của dấu nhắc là khoảng 1024 ký tự, tùy thuộc vào độ rộng của các ký tự được sử dụng. Nếu dấu nhắc bao gồm nhiều dòng, bạn có thể phân tách các dòng bằng ký tự xuống dòng (Chr(13)), ký tự dòng (Chr(10)), hoặc tổ hợp ký tự dòng trả về–dòng xuống (Chr(13) & Chr(10)) giữa mỗi dòng. |
Tiêu đề |
Không bắt buộc. Biểu thức chuỗi được hiển thị trong thanh tiêu đề của hộp thoại. Nếu bạn bỏ qua tiêu đề, tên ứng dụng sẽ được đặt trong thanh tiêu đề. |
mặc định |
Không bắt buộc. Biểu thức chuỗi được hiển thị trong hộp văn bản là phản hồi mặc định nếu không có dữ liệu đầu vào nào khác được cung cấp. Nếu bạn bỏ qua mặc định, hộp văn bản sẽ được hiển thị trống. |
xpos |
Không bắt buộc. Biểu thức số xác định, theo twip, khoảng cách ngang của cạnh trái của hộp thoại từ cạnh trái của màn hình. Nếu xpos được bỏ qua, hộp thoại sẽ được căn giữa theo chiều ngang. |
ypos |
Không bắt buộc. Biểu thức số xác định, theo twip, khoảng cách dọc của cạnh trên của hộp thoại từ đầu màn hình. Nếu bỏ qua ypos , hộp thoại sẽ được định vị theo chiều dọc xấp xỉ một phần ba chiều xuống màn hình. |
trợ giúp |
Không bắt buộc. Biểu thức chuỗi xác định tệp Trợ giúp sử dụng để cung cấp Trợ giúp theo ngữ cảnh cho hộp thoại. Nếu có trợ giúp, bạn cũng phải cung cấp ngữ cảnh. |
Bối cảnh |
Không bắt buộc. Biểu thức số là số ngữ cảnh Trợ giúp được gán cho chủ đề Trợ giúp thích hợp của tác giả Trợ giúp. Nếu ngữ cảnh được cung cấp, bạn cũng phải cung cấp trợ giúp. |
Chú thích
Khi cả trợ giúp và ngữ cảnh được cung cấp, người dùng có thể nhấn F1 (Windows) hoặc HELP (Macintosh) để xem chủ đề Trợ giúp tương ứng với ngữ cảnh. Một ứng dụng lưu trữ cũng tự động thêm nút Trợ giúp vào hộp thoại. Nếu người dùng bấm OK hoặc nhấn ENTER, hàm InputBox sẽ trả về bất kỳ nội dung nào có trong hộp văn bản. Nếu người dùng bấm Hủy bỏ, hàm sẽ trả về chuỗi độ dài bằng 0 ("").
Lưu ý: Để xác định nhiều hơn đối số có tên đầu tiên, bạn phải sử dụng InputBox trong một biểu thức. Để bỏ qua một số tham đối vị trí, bạn phải đưa vào dấu tách bằng dấu phẩy tương ứng.
Ví dụ
Lưu ý: Các ví dụ sau thể hiện cách sử dụng hàm này trong mô-đun Visual Basic for Applications (VBA). Để biết thêm thông tin về cách làm việc với VBA, chọn Tham khảo dành cho Nhà phát triển trong danh sách thả xuống cạnh Tìm kiếm, rồi nhập một hoặc nhiều từ vào hộp tìm kiếm.
Ví dụ này cho thấy nhiều cách khác nhau để sử dụng hàm InputBox để nhắc người dùng nhập giá trị. Nếu các vị trí x và y được bỏ qua, hộp thoại sẽ được tự động căn giữa cho các trục tương ứng. Biến số MyValue chứa giá trị do người dùng nhập nếu người dùng bấm OK hoặc nhấn phím ENTER. Nếu người dùng bấm Hủy bỏ, chuỗi độ dài bằng 0 sẽ được trả về.
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)