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