У настільних базах даних 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

Відображення тексту справа наліво для івриту й арабської мови.


Порада.:  В Access 2010 у побудовнику виразів є функція IntelliSense, за допомогою якої можна дізнатися, які аргументи необхідні для виразу. 

Перша група значень (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

Ні


Примітки

Коли задано обидва аргументи helpfile і context, користувач може натиснути клавішу F1 (Windows) або Help (Macintosh), щоб переглянути розділ довідки, який відповідає контексту. Деякі хост-програми, наприклад Microsoft Excel, також автоматично додають кнопку довідки до діалогового вікна.

Якщо діалогове вікно відображає кнопку скасувати , НАТИСКАННЯ клавіші ESC має такий самий ефект, як і натискання кнопки "Скасувати". Якщо діалогове вікно містить кнопку довідки , у діалоговому вікні надається контекстно-чутлива Довідка. Проте значення не повертається, доки не буде натиснуто один із інших кнопок.

Примітка.: Щоб указати більше, ніж перший іменований аргумент, потрібно використовувати повідомлення в вираз. Щоб пропустити деякі позиційні аргументи, потрібно додати відповідний роздільник комами.

Приклад

Примітка.: У прикладах нижче показано використання цієї функції в модулі 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

Потрібна додаткова довідка?

Отримуйте нові функції раніше за інших

Приєднатися до Microsoft оцінювачів >

Ця інформація корисна?

Наскільки ви задоволені якістю мови?
Що вплинуло на ваші враження?

Дякуємо за відгук!

×