У локальній базі даних Access функція MsgBox відображає повідомлення в діалоговому вікні, чекає, доки користувач натисне кнопку, і поверне ціле число , яке вказує, яку кнопку натиснув користувач.
Синтаксис
MsgBox(prompt [, buttons ] [, title ] [, helpfile ] [, context ] )
Синтаксис функції MsgBox має такі аргументи:
| Аргумент | Опис |
|---|---|
| prompt | Обов’язковий аргумент. Рядковий вираз, що відображається як повідомлення в діалоговому вікні. Максимальна довжина запиту – приблизно 1024 символи залежно від ширини використаних символів. Якщо запит складається з кількох рядків, лінії можна розділити за допомогою символу повернення каретки (Chr(13)), символу каналу (Chr(10)) або повернення каретки – комбінації символів лінійного каналу (Chr(13) & Chr(10)) між кожним рядком. |
| buttons | — необов’язковий аргумент. числовий вираз, який становить суму значень, що вказує кількість і тип кнопок, які потрібно відобразити, стиль піктограми, ідентичність кнопки за замовчуванням і модальність поля повідомлення. Якщо його не вказано, значення за замовчуванням для кнопок – 0. |
| title | Необов’язковий аргумент. Рядковий вираз, що відображається в рядку заголовка діалогового вікна. Якщо пропустити заголовок, ім'я програми опиниться в рядку заголовка. |
| helpfile | Необов’язковий аргумент. Рядковий вираз, що визначає файл довідки для надання контекстної довідки в діалоговому вікні. Якщо надано аргумент helpfile , потрібно також указати контекст . |
| 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) визначає модальність вікна повідомлення. Додаючи числа, щоб створити остаточне значення для аргументу "кнопки", використовуйте лише одне число з кожної групи.
Примітка.
Ці константи визначено в модулі 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