Εμφανίζει ένα μήνυμα σε ένα παράθυρο διαλόγου, περιμένει τον χρήστη να εισαγάγει κείμενο ή να κάνει κλικ σε ένα κουμπί και επιστρέφει μια συμβολοσειρά που περιέχει τα περιεχόμενα του πλαισίου κειμένου.
Σύνταξη
InputBox ( ερώτηση [, τίτλος ] [, προεπιλογή ] [, xpos ] [, απόθεσος ] [, helpfile ] [, περιβάλλον ] )
Η σύνταξη της συνάρτησης InputBox περιλαμβάνει τα παρακάτω ορίσματα:
|
Όρισμα |
Περιγραφή |
|---|---|
|
Ερώτηση |
Υποχρεωτικό. Η παράσταση συμβολοσειράς εμφανίζεται ως μήνυμα στο παράθυρο διαλόγου. Το μέγιστο μήκος του μηνύματος είναι περίπου 1024 χαρακτήρες, ανάλογα με το πλάτος των χαρακτήρων που χρησιμοποιούνται. Εάν το μήνυμα αποτελείται από περισσότερες από μία γραμμές, μπορείτε να διαχωρίσετε τις γραμμές χρησιμοποιώντας έναν χαρακτήρα επαναφοράς (Chr(13)), ένα χαρακτήρα τροφοδοσίας γραμμής (Chr(10)) ή ένα συνδυασμό χαρακτήρων επαναφοράς-τροφοδοσίας γραμμής (Chr(13) & Chr(10)) μεταξύ κάθε γραμμής. |
|
Τίτλο |
Προαιρετικό. Η παράσταση συμβολοσειράς εμφανίζεται στη γραμμή τίτλου του παραθύρου διαλόγου. Εάν παραλείψετε τον τίτλο, το όνομα της εφαρμογής τοποθετείται στη γραμμή τίτλου. |
|
προεπιλογή |
Προαιρετικό. Η παράσταση συμβολοσειράς εμφανίζεται στο πλαίσιο κειμένου ως προεπιλεγμένη απάντηση εάν δεν παρέχονται άλλα δεδομένα εισαγωγής. Εάν παραλείψετε την προεπιλογή, το πλαίσιο κειμένου εμφανίζεται κενό. |
|
xpos |
Προαιρετικό. Αριθμητική παράσταση που καθορίζει, σε twip, την οριζόντια απόσταση του αριστερού άκρου του παραθύρου διαλόγου από το αριστερό άκρο της οθόνης. Εάν παραλειφθεί το όρισμα xpos , το παράθυρο διαλόγου κεντράρεται οριζόντια. |
|
ypos |
Προαιρετικό. Αριθμητική παράσταση που καθορίζει, σε twip, την κατακόρυφη απόσταση του επάνω άκρου του παραθύρου διαλόγου από το επάνω μέρος της οθόνης. Εάν παραλειφθεί το όρισμα θέση , το παράθυρο διαλόγου τοποθετείται κατακόρυφα στο ένα τρίτο περίπου της διαδρομής προς τα κάτω στην οθόνη. |
|
αρχείο βοήθειας |
Προαιρετικό. Παράσταση συμβολοσειράς που προσδιορίζει το αρχείο Βοήθειας που θα χρησιμοποιηθεί για την παροχή βοήθειας ευαίσθητων πληροφοριών περιβάλλοντος για το παράθυρο διαλόγου. Εάν παρέχεται αρχείο helpfile, πρέπει επίσης να παρέχεται περιβάλλον. |
|
Πλαίσιο |
Προαιρετικό. Αριθμητική παράσταση που είναι ο αριθμός περιβάλλοντος της Βοήθειας που έχει εκχωρηθεί στο κατάλληλο θέμα της Βοήθειας από τον συντάκτη της Βοήθειας. Εάν παρέχονται πληροφορίες περιβάλλοντος, πρέπει επίσης να παρέχεται αρχείο βοήθειας. |
Παρατηρήσεις
Όταν παρέχονται τόσο αρχεία βοήθειας όσο και πληροφορίες περιβάλλοντος , ο χρήστης μπορεί να πατήσει το πλήκτρο F1 (Windows) ή HELP (Macintosh) για να δει το θέμα της Βοήθειας που αντιστοιχεί στο περιβάλλον. Ορισμένα κεντρική εφαρμογή προσθέτουν επίσης αυτόματα ένα κουμπί Βοήθειας στο παράθυρο διαλόγου. Εάν ο χρήστης κάνει κλικ στο κουμπί OK ή πατήσει το πλήκτρο ENTER, η συνάρτηση InputBox επιστρέφει ό,τι υπάρχει στο πλαίσιο κειμένου. Εάν ο χρήστης κάνει κλικ στο κουμπί Άκυρο, η συνάρτηση επιστρέφει μια συμβολοσειρά μηδενικού μήκους ("").
Σημείωση: Για να καθορίσετε περισσότερα από το πρώτο επώνυμο όρισμα, πρέπει να χρησιμοποιήσετε το InputBox σε ένα παράσταση. Για να παραλείψετε ορισμένα ορίσματα θέσης, πρέπει να συμπεριλάβετε τον αντίστοιχο οριοθέτη με κόμματα.
Παράδειγμα
Σημείωση: Παραδείγματα που ακολουθούν δείχνουν τη χρήση αυτής της συνάρτησης σε μια λειτουργική μονάδα Visual Basic for Applications (VBA). Για περισσότερες πληροφορίες σχετικά με την εργασία με τη VBA, επιλέξτε Αναφορά προγραμματιστών στην αναπτυσσόμενη λίστα δίπλα στην Αναζήτηση και πληκτρολογήστε έναν ή περισσότερους όρους στο πλαίσιο αναζήτησης.
Αυτό το παράδειγμα δείχνει διάφορους τρόπους χρήσης της συνάρτησης InputBox για να ζητήσει από το χρήστη να εισαγάγει μια τιμή. Εάν παραλειφθεί η θέση x και y, το παράθυρο διαλόγου στοιχίζεται αυτόματα στο κέντρο για τους αντίστοιχους άξονες. Η μεταβλητή MyValue περιέχει την τιμή που έχει εισαγάγει ο χρήστης εάν ο χρήστης κάνει κλικ στο κουμπί OK ή πατήσει το πλήκτρο 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)
