MsgBox функциясы

Тілқатысу терезесінде хабар көрсетеді, пайдаланушының түймені басуын күтеді және қай түйменің пайдаланылғандығын көрсететін Integer түріндегі мәнді қайтарады.

Синтаксис

MsgBox(шақыру [, түймешіктер ] [, тақырып ] [, анықтамафайлы ] [, мәтінмән ] )

MsgBox функциясында келесі аргумент болады:

Дәлел

Сипаттама

шақыру

Міндетті дәлел. Тілқатысу терезесінде көрсетілетін хабар түріндегі жол өрнегі. Шақыру дәлелінің жолының ең үлкен ұзындығы шамамен 1024 таңбаға жетеді және ол пайдаланылатын таңбалардың еніне байланысты болады. Егер шақыру дәлелінде бірнеше жол болса, оларды каретканы қайтару таңбасы (Chr(13)), жаңа жол таңбасы (Chr(10)) немесе осы таңбалардың тіркесімі (Chr(13) & Chr(10)) арқылы бөлуге болады.

түймешіктер

Қосымша дәлел. Көрсетілетін түймешіктердің саны мен түрін, белгіше мәнерін, әдепкі белсенді түймешікті және хабар терезесінің модальдығын көрсететін мәндердің қосындысы болып табылатын сандық өрнек. Егер түймешіктер дәлелі көрсетілмесе, әдепкі күй бойынша 0 мәні пайдаланылады.

тақырып

Қосымша дәлел. Тілқатысу терезесінің тақырып жолында көрсетілетін жол өрнегі. Егер тақырып дәлелі жоқ болса, терезе тақырыбында бағдарлама атауы беріледі.

анықтамафайлы

Қосымша дәлел. Осы тілқатысу терезесінің мәтінмәндік анықтамасы орналасқан анықтама файлын анықтайтын жол өрнегі. Егер анықтамафайлы дәлелі берілсе, мәтінмән дәлелін де көрсету керек.

мәтінмән

Қосымша дәлел. Анықтама авторы тиісті бөлімге берген мәтінмән нөмірі болып табылатын санды өрнек. Егер мәтінмән дәлелі берілсе, анықтамафайлы дәлелін де көрсету керек.


Параметрлер

Түймешіктер аргумент мынадай параметрлер болады:

Тұрақты мән

Мән

Сипаттама

vbOKOnly

0

Тек OK түймешігі ғана көрсетіледі.

vbOKCancel

1

OK және Болдырмау түймешіктері көрсетіледі.

vbAbortRetryIgnore

2

Доғару, Қайталау және Елемеу түймешіктері көрсетіледі.

vbYesNoCancel

3

Иә, Жоқ және Болдырмау түймешіктері көрсетіледі.

vbYesNo

4

Иә және Жоқ түймешіктері көрсетіледі.

vbRetryCancel

5

Қайталау және Болдырмау түймешіктері көрсетіледі.

vbCritical

16

Маңызды хабар белгішесі көрсетіледі.

vbQuestion

32

Ескерту сұрауы     белгішесі көрсетіледі.

vbExclamation

48

Ескерту хабары     белгішесін көрсетеді.

vbInformation

64

Ақпараттық хабар белгішесін көрсетеді.

vbDefaultButton1

0

Әдепкіде бірінші түйме белсенді болады.

vbDefaultButton2

256

Әдепкіде екінші түйме белсенді болады.

vbDefaultButton3

512

Әдепкіде үшінші түйме белсенді болады.

vbDefaultButton4

768

Әдепкіде төртінші түйме белсенді болады.

vbApplicationModal

0

Бағдарлама деңгейіндегі модальдық. Ағымдық бағдарламада жұмысты жалғастыру үшін пайдаланушы хабарға жауап беруі тиіс.

vbSystemModal

4096

Жүйе деңгейіндегі модальдық. Пайдаланушының хабарға жауап беруін күткен кезде барлық бағдарламалардың жұмысы уақытша тоқтатылады.

vbMsgBoxHelpButton

16384

Хабардың тілқатысу терезесіне "Анықтама" түймешігі қосылады

VbMsgBoxSetForeground

65536

Хабар терезесі үстіңгі бетке шығарылады

vbMsgBoxRight

524288

Хабар мәтіні оң жақ шетпен тураланады

vbMsgBoxRtlReading

1048576

Хабар мәтіні оңнан солға көрсетіледі. Бұл мүмкіндік иврит немесе араб тілі пайдаланылатын жүйелерге арналған.


Мәндердің бірінші тобы (0–5) тілқатысу терезесіндегі түймешіктердің саны мен түрін көрсетеді. Екінші топ (16, 32, 48, 64) хабар белгішесінің мәнерін сипаттайды. Үшінші топ (0, 256, 512) әдепкі белсенді түймешікті анықтайды. Төртінші топ (0, 4096) хабардың модальдығын анықтайды. Түймешіктер дәлелінің соңғы мәніне сандарды қосқанда топтан тек қана бір дәлелді пайдалану керек.

Note: Бұл тұрақты мән бағдарламаларға арналған Visual Basic тарапынан анықталған. Сондықтан, бағдарламаның кез келген жеріндегі санды мәндерді олармен алмастыруға болады.

Қайтарылатын мәндер

Тұрақты мән

Мән

Сипаттама

vbOK

1

OK

vbCancel

2

Болдырмау

vbAbort

3

Доғару

vbRetry

4

Қайталау

vbIgnore

5

Елемеу

vbYes

6

Иә

vbNo

7

Жоқ


Ескертпелер

Егер анықтамафайлы және мәтінмән дәлелдері көрсетілсе, пайдаланушы F1 (Windows) немесе HELP (Macintosh) пернесін басып, мәтінмән дәлелі арқылы берілген анықтама бөлімін аша алады. Кейбір хост-бағдарлама, мысалы, Microsoft Office Excel 2007, Анықтама түймешігін автоматты түрде тілқатысу терезесіне қосады.

Егер тілқатысу терезесінде Болдырмау түймешігі көрсетілсе, Болдырмау түймешігін басу ESC пернесін басумен бірдей болады. Егер тілқатысу терезесінде Анықтама түймешігі көрсетілсе, бұл терезе үшін мәтінмәндік анықтаманы пайдалануға болады. Бірақ, қандай болмасын басқа бір түймешікті басқанша ешқандай мән қайтарылмайды.

Note: Аталған дәлелдердің біріншісін ғана емес, олардың бірнешеуін көрсету үшін MsgBox функциясын өрнек пайдаланыңыз. Кейбір аргумент қоспау үшін, оларды үтір түріндегі бөлгішпен алмастырыңыз.

Мысал

Note: Төмендегі үлгілер осы жетені Бағдарламаларға арналған Visual Basic (VBA) модулінде пайдаланылуын көрсетеді. VBA модулімен жұмыс істеу туралы көбірек ақпарат алу үшін, жайылмалы шаршыдағы Іздеу түймешігінің қасындағы Жасақтаушы сілтемелері түймешігін нұқып, іздеу жолағына бір немесе бірнеше шартты ендіріңіз.

Бұл мысалда MsgBox функциясы критикалық қате туралы хабарды "Иә" және "Жоқ" түймешіктерімен тілқатысу терезесінде көрсету үшін пайдаланылады. "Жоқ" түймешігі әдепкі күй бойынша белсенді болады. MsgBox функциясы қайтаратын мән пайдаланушы басқан түймешікке байланысты болады. DEMO.HLP файлы анықтама файлы болады және онда нөмірі 1000 болатын бөлім бар деп есептеледі.

Dim Msg, Style, Title, Help, Ctxt, Response, MyString
Msg = "Do you want to continue?"
Style = vbYesNo + vbCritical + vbDefaultButton2
Title = "MsgBox Demonstration"
Help = "DEMO.HLP"
Ctxt = 1000
Response = MsgBox(Msg, Style, Title, Help, Ctxt)
If Response = vbYes Then ' User chose Yes.
MyString = "Yes" ' Perform some action.
Else ' User chose No.
MyString = "No" ' Perform some action.
End If
Дағдыларды жетілдіру
Оқыту курсымен танысыңыз
Жаңа мүмкіндіктерге бірінші болып қол жеткізу
Office Insider бағдарламасына қосылу

Осы ақпарат пайдалы болды ма?

Пікіріңіз үшін рақмет!

Пікіріңізге рақмет! Сізді Office қолдау көрсету қызметіндегі агенттердің бірімен байланыстырған жөн болуы мүмкін.

×