Microsoft® Visual Basic® Scripting Edition

Microsoft® Visual Basic® Scripting Edition
Η MsgBox

Περιγραφή

Αναπτύσσει, εκθέτει ένα μήνυμα μέσα σ’ ένα dialog box, περιμένει το χρήστη να πατήσει ένα κουμπί και επιστρέφει μια τιμή που δείχνει πιο κουμπί

πάτησε ο χρήστης.

Σύνταξη

MsgBox(prompt[, buttons][, title][, helpfile, context])

Η σύνταξη της διαδικασίας MsgBox αποτελείται απο τα εξής ορίσματα :

ΜΕΡΟΣ ΠΕΡΙΓΡΑΦΗ

prompt Αναπτύσσεται μια έκφραση συμβολοσειράς όπως το μήνυμα μέσα στο dialog box. Το ανώτερο όριο σε μήκος που μπορεί να φτάσει το prompt είναι ακριβώς 1024 χαρακτήρες, όριο το οποίο εξαρτάται και απο το πλάτος των χαρακτήρων που χρησιμοποιούνται. Αν το prompt αποτελείται απο περισσότερες απο μια γραμμές, χρησιμοποιώντας ένα χαρακτήρα επιστροφής (Chr (13)), ένα χαρακτήρα αλλαγής γραμμών (Chr (10)), ή ένα συνδυασμό των δυο παραπάνω (Chr (13)& Chr (10)) μεταξύ της κάθε γραμμής.

buttons Αριθμητική έκφραση που αντιπροσωπεύει το άθροισμα των τιμών που προςδιορίζουν τον αριθμό και τον τύπο των κουμπιών που αναπτύσσονται, το στυλ της εικόνας που θα χρησιμοποιηθεί, την ταυτότητα του προκαθορισμένου button και τον τύπο του message box. Ανατρέξτε στο τμήμα των εγκαταστάσεων που αναφέρεται στις τιμές. Αν παραλείπεται ή δεν βρίσκεται καν εκεί η προκαθορισμένη τιμή για τα κουμπιά είναι 0.

title Μια έκφραση συμβολοσειράς που εμφανίζεται και αναπτύσσεται στη μπάρα τίτλων του dialog box. Αν παραλείψετε το title, το application name τοποθετείται στη μπάρα τίτλων.

helpfile Μια έκφραση συμβολοσειράς που αναγνωρίζει το φάκελο Help ο οποιός χρηςιμοποιείται για την παροχή βοήθειας στο dialog box. Αν υπάρχει το helpfile τότε πρέπει αναγκαστικά να υπάρχει και το context. Το helpfile δεν είναι διαθέσιμο σε, για πλατφόρμες 16-bit.

context Αριθμητική έκφραση η οποία αναγνωρίζει τον αριθμό Helpcontext που έχει οριστεί απο τον δημιουργό του Help προς το κατάλληλο τοπικό Help. Αν υπάρχει το context τότε πρέπει να υπάρχει επίσης και το helpfile. Το context δεν είναι διαθέσιμο σε, για πλατφόρμες 16-bit.

ΕΓΚΑΤΑΣΤΑΣΕΙΣ

Οι εγκαταστάσεις του ορίσματος buttons είναι :

ΣΤΑΘΕΡΑ ΤΙΜΗ ΠΕΡΙΓΡΑΦΗ

VbOKOnly 0 Αναπτύσσει μόνο το κουμπί Ok.

VbOKCancel 1 Αναπτύσσει τα κουμπιά OK καιCancel.

VbAbortRetryIgnore 2 Αναπτύσσει τα κουμιά Abort, Retry και Ignore.

VbYesNoCancel 3 Αναπτύσσει τα κουμπιά Yes, No και Cancel.

VbYesNo 4 Αναπτύσσει τα κουμπιά Yes και No.

vbRetryCancel 5 Αναπτύσσει τα κουμπιά Retry και Cancel.

VbCritical 16 Αναπτύσσει την εικόνα Critical Message.

VbQuestion 32 Αναπτύσσει την εικόνα Warning Query.

VbExclamation 48 Αναπτύσσει την εικόνα Warning Message.

VbInformation 64 Αναπτύσσει την εικόνα Information Message.

vbDefaultButton1 0 Το πρώτο κουμπί είναι προκαθορισμένο.

vbDefaultButton2 256 Το δεύτερο κουμπί είναι προκαθορισμένο.

vbDefaultButton3 512 Το τρίτο κουμπί είναι προκαθορισμένο.

vbDefaultButton4 768 Το τέταρτο κουμπί είναι προκαθορισμένο.

VbApplicationModal 0 Τύπος Application. Ο χρήστης πρέπει να ανταποκριθεί και να απαντήσει στο message box πριν συνεχίσει να εργάζεται πάνω στη τρέχουσα application.

VbSystemModal 4096 Τύπος του συστήματος. Όλες οι αιτήσεις αναβάλλονται μέχρι ο χρήστης να ανταποκριθεί και να απαντήσει στο message box.

Η πρώτη ομάδα τιμών (0-5) περιγράφει τον αριθμό και τον τύπο των κουμπιών που αναπτύσσονται μέσα στο dialog box. Η δεύτερη ομάδα (16,32,48,64) περιγράφει το στυλ της εικόνας. Η τρίτη ομάδα (0,256,512,768) καθορίζει ποιό κουμπί είναι το προκαθορισμένο και η τέταρτη ομάδα (0,4096) καθορίζει τον τύπο του message box. Όταν προσθέτετε για να δημιουργήσετε μια τελική τιμή για το όρισμα buttons, χρησιμοποιήστε μόνο έναν αριθμό απο τη κάθε ομάδα.

ΤΙΜΕΣ

Η function MsgBox έχει τις ακόλουθες επιστροφές τιμών :

ΣΤΑΘΕΡΑ ΤΙΜΗ ΚΟΥΜΠΙ

VbOK 1 OK

VbCancel 2 Cancel

VbAbort 3 Abort

VbRetry 4 Retry

vbIgnore 5 Ignore

vbYes 6 Yes

vbNo 7 No

Σχόλια

Όταν και το helpfile και το context υπάρχουν, ο χρήστης μπορεί να πατήσει το F1 για να δει το Help που αντιστοιχεί στο context.

Αν το dialog box αναπτύσσει ένα κουμπί Cancel, τότε πατώντας το κλειδί Esc έχει το ίδιο αποτέλεσμα με το να κάνετε κλικ στο Cancel. Αν το dialog box περιέχει ένα κουμπί Help, τότε προσφέρεται στο dialog box το όρισμα Help context-sensitive. Παρ’ όλ’ αυτά δεν επιστρέφεται καμία τιμή, μέχρι να πατηθεί κάποιο από τα υπόλοιπα κουμπιά.

ΜΕΡΟΣ	ΠΕΡΙΓΡΑΦΗ
prompt	Αναπτύσσεται μια έκφραση συμβολοσειράς όπως το μήνυμα μέσα στο dialog box. Το ανώτερο όριο σε μήκος που μπορεί να φτάσει το prompt είναι ακριβώς 1024 χαρακτήρες, όριο το οποίο εξαρτάται και απο το πλάτος των χαρακτήρων που χρησιμοποιούνται. Αν το prompt αποτελείται απο περισσότερες απο μια γραμμές, χρησιμοποιώντας ένα χαρακτήρα επιστροφής (Chr (13)), ένα χαρακτήρα αλλαγής γραμμών (Chr (10)), ή ένα συνδυασμό των δυο παραπάνω (Chr (13)& Chr (10)) μεταξύ της κάθε γραμμής.
buttons	Αριθμητική έκφραση που αντιπροσωπεύει το άθροισμα των τιμών που προςδιορίζουν τον αριθμό και τον τύπο των κουμπιών που αναπτύσσονται, το στυλ της εικόνας που θα χρησιμοποιηθεί, την ταυτότητα του προκαθορισμένου button και τον τύπο του message box. Ανατρέξτε στο τμήμα των εγκαταστάσεων που αναφέρεται στις τιμές. Αν παραλείπεται ή δεν βρίσκεται καν εκεί η προκαθορισμένη τιμή για τα κουμπιά είναι 0.
title	Μια έκφραση συμβολοσειράς που εμφανίζεται και αναπτύσσεται στη μπάρα τίτλων του dialog box. Αν παραλείψετε το title, το application name τοποθετείται στη μπάρα τίτλων.
helpfile	Μια έκφραση συμβολοσειράς που αναγνωρίζει το φάκελο Help ο οποιός χρηςιμοποιείται για την παροχή βοήθειας στο dialog box. Αν υπάρχει το helpfile τότε πρέπει αναγκαστικά να υπάρχει και το context. Το helpfile δεν είναι διαθέσιμο σε, για πλατφόρμες 16-bit.
context	Αριθμητική έκφραση η οποία αναγνωρίζει τον αριθμό Helpcontext που έχει οριστεί απο τον δημιουργό του Help προς το κατάλληλο τοπικό Help. Αν υπάρχει το context τότε πρέπει να υπάρχει επίσης και το helpfile. Το context δεν είναι διαθέσιμο σε, για πλατφόρμες 16-bit.

ΣΤΑΘΕΡΑ	ΤΙΜΗ	ΠΕΡΙΓΡΑΦΗ
VbOKOnly	0	Αναπτύσσει μόνο το κουμπί Ok.
VbOKCancel	1	Αναπτύσσει τα κουμπιά OK καιCancel.
VbAbortRetryIgnore	2	Αναπτύσσει τα κουμιά Abort, Retry και Ignore.
VbYesNoCancel	3	Αναπτύσσει τα κουμπιά Yes, No και Cancel.
VbYesNo	4	Αναπτύσσει τα κουμπιά Yes και No.
vbRetryCancel	5	Αναπτύσσει τα κουμπιά Retry και Cancel.
VbCritical	16	Αναπτύσσει την εικόνα Critical Message.
VbQuestion	32	Αναπτύσσει την εικόνα Warning Query.
VbExclamation	48	Αναπτύσσει την εικόνα Warning Message.
VbInformation	64	Αναπτύσσει την εικόνα Information Message.
vbDefaultButton1	0	Το πρώτο κουμπί είναι προκαθορισμένο.
vbDefaultButton2	256	Το δεύτερο κουμπί είναι προκαθορισμένο.
vbDefaultButton3	512	Το τρίτο κουμπί είναι προκαθορισμένο.
vbDefaultButton4	768	Το τέταρτο κουμπί είναι προκαθορισμένο.
VbApplicationModal	0	Τύπος Application. Ο χρήστης πρέπει να ανταποκριθεί και να απαντήσει στο message box πριν συνεχίσει να εργάζεται πάνω στη τρέχουσα application.
VbSystemModal	4096	Τύπος του συστήματος. Όλες οι αιτήσεις αναβάλλονται μέχρι ο χρήστης να ανταποκριθεί και να απαντήσει στο message box.

ΣΤΑΘΕΡΑ	ΤΙΜΗ	ΚΟΥΜΠΙ
VbOK	1	OK
VbCancel	2	Cancel
VbAbort	3	Abort
VbRetry	4	Retry
vbIgnore	5	Ignore
vbYes	6	Yes
vbNo	7	No