У локальній базі даних Access ця MsgBox функція відображає повідомлення в діалоговому вікні, очікує, доки користувач не натисне кнопку, і повертає відповідне Integer значення, що вказує, яку кнопку він вибрав.
Синтаксис
MsgBox(prompt[, buttons][, title][, helpfile][, context])
Синтаксис MsgBox цих функцій має такі аргументи:
| Аргумент | Опис |
|---|---|
prompt |
Обов’язковий аргумент. Рядковий вираз, що відображається як повідомлення в діалоговому вікні. Максимальна довжина символів prompt становить близько 1024 символів залежно від ширини символів, що використовуються. Якщо prompt рядки мають кілька рядків, їх можна розділити символом повернення каретки (Chr(13)), символом переведення рядка (Chr(10)) або комбінацією повернення каретки та переведення рядка (Chr(13) & Chr(10)) між кожним рядком. |
buttons |
— необов’язковий аргумент. Числовий вираз, що представляє собою суму значень, які визначають кількість і тип кнопок, стиль піктограм, що використовуватиметься, ідентичність стандартної кнопки та модальність вікна повідомлення. Якщо цей аргумент пропущено, значення за замовчуванням буде buttons0. |
title |
Необов’язковий аргумент. Рядковий вираз, що відображається в рядку заголовка діалогового вікна. Якщо його titleне ввести, ім'я програми відображатиметься в рядку заголовка. |
helpfile |
Необов’язковий аргумент. Рядковий вираз, що визначає файл довідки для надання контекстної довідки в діалоговому вікні. Якщо helpfile надано, context то також має бути надано. |
context |
Необов’язковий аргумент. Числовий вираз, що є номером контексту довідки, який відповідному розділу довідки призначив її автор. Якщо context надано, helpfile то також має бути надано. |
Параметри
Параметри buttons аргументів:
| Константа | Значення | Опис |
|---|---|---|
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 |
У тексті можна відображати текст із письмом справа наліво в системі івриту й арабської мови. |
Перша група значень (05із ) описує кількість і тип кнопок, які відображаються в діалоговому вікні. Друга група (16, 32, 48) 64описує стиль піктограм. Третя група (0, 256, 512) визначає, яка кнопка є стандартною. Четверта група (0, 4096) визначає модальність вікна повідомлення. Під час додавання чисел для створення остаточного значення аргументу buttons використовуйте лише одне число з кожної групи.
Примітка.
Ці константи визначено в модулі Visual Basic for Applications. Тому можна використовувати імена будь-де в коді замість фактичних значень.
Значення, що повертаються
| Константа | Значення | Опис |
|---|---|---|
vbOK |
1 |
OK |
vbCancel |
2 |
Скасувати |
vbAbort |
3 |
Перервати |
vbRetry |
4 |
Повторити |
vbIgnore |
5 |
Пропустити |
vbYes |
6 |
Так |
vbNo |
7 |
Ні |
Примітки
Якщо і те, і helpfile інше надано context , користувач може натиснути клавішу F1 у Windows або Довідку в macOS, щоб переглянути розділ довідки, який відповідає context. Деякі хост-програми, наприклад Microsoft Excel, також автоматично додають кнопку "Довідка " до діалогового вікна.
Якщо в діалоговому вікні відображається кнопка "Скасувати ", натискання клавіші Esc забезпечує такий же ефект, як і вибір кнопки "Скасувати". Якщо діалогове вікно містить кнопку «Довідка », для нього надається контекстна довідка. Однак значення не повертається, доки користувач не натисне одну з інших кнопок.
Примітка.
У виразі потрібно вказати MsgBox більше, ніж перший іменований аргумент. Щоб пропустити деякі аргументи розташування, потрібно ввести відповідний роздільник комами.
Приклад
Примітка.
У прикладі нижче показано, як використовувати цю функцію в модулі Visual Basic for Applications (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