Выводит сообщение в диалоговом окне, ожидает нажатия кнопки пользователем и возвращает значение типа Integer, которое указывает, какая кнопка была нажата. Displays a message in a dialog box, waits for the user to click a button, and returns an Integer indicating which button the user clicked.
Хотите создавать решения, которые расширяют возможности Office на разнообразных платформах? Interested in developing solutions that extend the Office experience across multiple platforms? Ознакомьтесь с новой моделью надстроек Office. Check out the new Office Add-ins model. У надстроек Office мало места по сравнению с надстройками и решениями VSTO, которые можно создавать с помощью практически любой технологии веб-программирования, например HTML5, JavaScript, CSS3 и XML. Office Add-ins have a small footprint compared to VSTO Add-ins and solutions, and you can build them by using almost any web programming technology, such as HTML5, JavaScript, CSS3, and XML.
Синтаксис Syntax
MsgBox (сообщение, [ кнопки, ] [ заголовок, ] [ файл_справки, контекст ]) MsgBox (prompt, [ buttons, ] [ title, ] [ helpfile, context ])
Синтаксис функции MsgBox включает следующие именованные аргументы: The MsgBox function syntax has these named arguments:
| Часть Part | Описание Description |
|---|---|
| сообщение prompt | Обязательный аргумент. Required. Строковое выражение, отображающееся в диалоговом окне. String expression displayed as the message in the dialog box. Максимальная длина строки аргумента сообщение составляет приблизительно 1024 знака и зависит от их ширины. The maximum length of prompt is approximately 1024 characters, depending on the width of the characters used. Если аргумент сообщение содержит несколько строк, их можно разделить с помощью знака возврата каретки (Chr(13)), знака перевода строки (Chr(10)) или сочетания этих знаков (Chr(13) & Chr(10)). If prompt consists of more than one line, you can separate the lines by using a carriage return character (Chr(13)), a linefeed character (Chr(10)), or carriage return — linefeed character combination (Chr(13) & Chr(10)) between each line. |
| кнопки buttons | Необязательный аргумент. Optional. Числовое выражение, являющееся суммой значений, указывающих количество и тип отображаемых кнопок, стиля значков, выбранной по умолчанию кнопки и модальности окна сообщения. Numeric expression that is the sum of values specifying the number and type of buttons to display, the icon style to use, the identity of the default button, and the modality of the message box. Если аргумент кнопки пропущен, по умолчанию используется значение 0. If omitted, the default value for buttons is 0. |
| заголовок title | Необязательный аргумент. Optional. Строковое выражение, отображаемое в заголовке диалогового окна. String expression displayed in the title bar of the dialog box. Если аргумент заголовок пропущен, в заголовке выводится имя приложения. If you omit title, the application name is placed in the title bar. |
| файл_справки helpfile | Необязательный аргумент. Optional. Строковое выражение, определяющее файл, в котором содержится контекстная справка для данного диалогового окна. String expression that identifies the Help file to use to provide context-sensitive Help for the dialog box. Если задан аргумент файл_справки, необходимо также указать аргумент контекст. If helpfile is provided, context must also be provided. |
| контекст context | Необязательный аргумент. Optional. Числовое выражение, представляющее собой номер контекста, присвоенный автором справки соответствующему разделу. Numeric expression that is the Help context number assigned to the appropriate Help topic by the Help author. Если задан аргумент контекст, необходимо также указать аргумент файл_справки. If context is provided, helpfile must also be provided. |
Параметры Settings
Аргумент кнопки может принимать следующие значения: The buttons argument settings are:
| Константа Constant | Значение Value | Описание Description |
|---|---|---|
| vbOKOnly vbOKOnly | 0 0 | Отображается только кнопка ОК. Display OK button only. |
| vbOKCancel vbOKCancel | 1 1 | Отображаются кнопки ОК и Отмена. Display OK and Cancel buttons. |
| vbAbortRetryIgnore vbAbortRetryIgnore | 2 2 | Отображаются кнопки Прервать, Повторить и Пропустить. Display Abort, Retry, and Ignore buttons. |
| vbYesNoCancel vbYesNoCancel | 3 3 | Отображаются кнопки Да, Нет и Отмена. Display Yes, No, and Cancel buttons. |
| vbYesNo vbYesNo | 4 4 | Отображаются кнопки Да и Нет. Display Yes and No buttons. |
| vbRetryCancel vbRetryCancel | 5 5 | Отображаются кнопки Повторить и Отмена. Display Retry and Cancel buttons. |
| vbCritical vbCritical | 16 16 | Отображается значок важного сообщения. Display Critical Message icon. |
| vbQuestion vbQuestion | 32 32 | Отображение значка Warning Query (Запрос с предупреждением). Display Warning Query icon. |
| vbExclamation vbExclamation | 48 48 | Отображение значка Warning Message (Сообщение с предупреждением). Display Warning Message icon. |
| vbInformation vbInformation | 64 64 | Отображается значок информационного сообщения. Display Information Message icon. |
| vbDefaultButton1 vbDefaultButton1 | 0 0 | По умолчанию активна первая кнопка. First button is default. |
| vbDefaultButton2 vbDefaultButton2 | 256 256 | По умолчанию активна вторая кнопка. Second button is default. |
| vbDefaultButton3 vbDefaultButton3 | 512 512 | По умолчанию активна третья кнопка. Third button is default. |
| vbDefaultButton4 vbDefaultButton4 | 768 768 | По умолчанию активна четвертая кнопка. Fourth button is default. |
| vbApplicationModal vbApplicationModal | 0 0 | Модальность на уровне приложения. Пользователь должен ответить на сообщение, чтобы продолжить работу в текущем приложении. Application modal; the user must respond to the message box before continuing work in the current application. |
| vbSystemModal vbSystemModal | 4096 4096 | Модальность на уровне системы. При ожидании ответа пользователя на сообщение приостанавливается работа всех приложений. System modal; all applications are suspended until the user responds to the message box. |
| vbMsgBoxHelpButton vbMsgBoxHelpButton | 16384 16384 | Добавляет кнопку Справка в окно сообщения. Adds Help button to the message box. |
| vbMsgBoxSetForeground vbMsgBoxSetForeground | 65536 65536 | Расположение окна сообщения на переднем плане. Specifies the message box window as the foreground window. |
| vbMsgBoxRight vbMsgBoxRight | 524288 524288 | Текст выравнивается по правому краю. Text is right-aligned. |
| vbMsgBoxRtlReading vbMsgBoxRtlReading | 1048576 1048576 | Система чтения справа налево для иврита и арабского языка. Specifies text should appear as right-to-left reading on Hebrew and Arabic systems. |
Первая группа значений (0–5) отражает число и тип кнопок в диалоговом окне. Вторая группа (16, 32, 48, 64) описывает стиль значка сообщения. Третья группа (0, 256, 512) определяет активную по умолчанию кнопку. Наконец, четвертая группа (0, 4096) устанавливает модальность сообщения. The first group of values (0-5) describes the number and type of buttons displayed in the dialog box; the second group (16, 32, 48, 64) describes the icon style; the third group (0, 256, 512) determines which button is the default; and the fourth group (0, 4096) determines the modality of the message box. При добавлении чисел в итоговое значение аргумента кнопки следует использовать только один аргумент из каждой группы. When adding numbers to create a final value for the buttons argument, use only one number from each group.
Приведенные здесь константы определены в Visual Basic для приложений, These constants are specified by Visual Basic for Applications. что позволяет заменять ими числовые значения в любом месте программы. As a result, the names can be used anywhere in your code in place of the actual values.
Возвращаемые значения Return values
| Константа Constant | Значение Value | Описание Description |
|---|---|---|
| vbOK vbOK | 1 1 | OK OK |
| vbCancel vbCancel | 2 2 | Отмена Cancel |
| vbAbort vbAbort | 3 3 | Прервать Abort |
| vbRetry vbRetry | 4 4 | Повторить Retry |
| vbIgnore vbIgnore | 5 5 | Пропустить Ignore |
| vbYes vbYes | 6 6 | Да Yes |
| vbNo vbNo | 7 7 | Нет No |
Примечания Remarks
Если одновременно указаны аргументы файл_справки и контекст, пользователь может нажать клавишу F1 (Windows) или HELP (Macintosh) для просмотра раздела справки, соответствующего аргументу контекст. When both helpfile and context are provided, the user can press F1 (Windows) or HELP (Macintosh) to view the Help topic corresponding to the context. Некоторые ведущие приложения, например Microsoft Excel, автоматически добавляют кнопку Справка в диалоговое окно. Some host applications, for example, Microsoft Excel, also automatically add a Help button to the dialog box.
Если в диалоговом окне есть кнопка Отмена, ее нажатие равносильно нажатию клавиши ESC. If the dialog box displays a Cancel button, pressing the ESC key has the same effect as clicking Cancel. Если в диалоговом окне есть кнопка Справка, для него доступна контекстная справка. If the dialog box contains a Help button, context-sensitive Help is provided for the dialog box. Однако до нажатия какой-либо другой кнопки никакое значение не возвращается. However, no value is returned until one of the other buttons is clicked.
Для указания более одного именованного аргумента необходимо использовать функцию MsgBox в выражении. To specify more than the first named argument, you must use MsgBox in an expression. Чтобы пропустить некоторые из позиционных аргументов, нужно вставить соответствующие запятые. To omit some positional arguments, you must include the corresponding comma delimiter.
Пример Example
В приведенном ниже примере функция MsgBox используется для вывода сообщения о критической ошибке в диалоговом окне с кнопками Да и Нет. This example uses the MsgBox function to display a critical-error message in a dialog box with Yes and No buttons. Кнопка Нет выбрана по умолчанию. The No button is specified as the default response. Значение, возвращаемое функцией MsgBox, зависит от нажатой пользователем кнопки. The value returned by the MsgBox function depends on the button chosen by the user. Предполагается, что DEMO.HLP является файлом справки и содержит раздел под номером контекста 1000 . This example assumes that DEMO.HLP is a Help file that contains a topic with a Help context number equal to 1000 .
См. также See also
Поддержка и обратная связь Support and feedback
Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Have questions or feedback about Office VBA or this documentation? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь. Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.
Использование функции MsgBox в VBA Excel, ее синтаксис и параметры. Значения, возвращаемые функцией MsgBox. Примеры использования.
Функция MsgBox предназначена в VBA Excel для вывода сообщения в диалоговом окне, ожидания нажатия кнопки и возврата значения типа Integer, указывающего на то, какая кнопка была нажата. Для упрощения восприятия информации, в этой статье не рассматриваются параметры, связанные с контекстной справкой и модальностью диалогового окна MsgBox.
Синтаксис функции
MsgBox ( Prompt [, Buttons ] [, Title ])
Обязательным параметром функции MsgBox является Prompt, если Buttons и Title явно не указаны, используются их значения по умолчанию. Кроме того, если необязательные параметры не указаны и возвращаемое значение не присваивается переменной, сообщение не заключается в скобки:
Пример 1
Параметры функции
| Параметр | Описание | Значение по умолчанию |
| Prompt* | Обязательный параметр. Выражение типа String, отображаемое в диалоговом окне в виде сообщения. Разделить на строки можно с помощью константы vbNewLine. | Нет |
| Buttons | Необязательный параметр. Числовое выражение, которое представляет собой сумму значений, задающих номер и тип отображаемых кнопок, стиль используемого значка, тип кнопки по умолчанию. | 0 |
| Title | Необязательный параметр. Выражение типа String, отображаемое в заголовке диалогового окна. | Имя приложения** |
*Максимальная длина параметра Prompt составляет примерно 1024 знака и зависит от их ширины.
**В Excel по умолчанию в заголовке MsgBox выводится надпись «Microsoft Excel».
Константы параметра «Buttons»
Тип и количество кнопок
| Константа | Описание | Значение |
| vbOKOnly | Отображается только кнопка OK. | 0 |
| vbOKCancel | Отображаются кнопки OK и Cancel (Отмена). | 1 |
| vbAbortRetryIgnore | Отображаются кнопки Abort (Прервать), Retry (Повторить) и Ignore (Пропустить). | 2 |
| vbYesNoCancel | Отображаются кнопки Yes (Да), No (Нет) и Cancel (Отмена). | 3 |
| vbYesNo | Отображаются кнопки Yes (Да) и No (Нет). | 4 |
| vbRetryCancel | Отображаются кнопки Retry (Повторить) и Cancel (Отмена). | 5 |
Стиль значка
| Константа | Описание | Значение |
| vbCritical | Отображается значок Critical — Критичное сообщение, сообщение об ошибке. | 16 |
| vbQuestion | Отображается значок Question — Сообщение с вопросом. | 32 |
| vbExclamation | Отображается значок Exclamation — Предупреждающее сообщение. | 48 |
| vbInformation | Отображается значок Information — Информационное сообщение. | 64 |
Для просмотра отображаемых значков, скопируйте код в свой модуль и запустите на выполнение:
Пример 2
Кнопка по умолчанию
| Константа | Описание | Значение |
| vbDefaultButton1 | По умолчанию активна первая кнопка. | 0 |
| vbDefaultButton2 | По умолчанию активна вторая кнопка. | 256 |
| vbDefaultButton3 | По умолчанию активна третья кнопка. | 512 |
Возвращаемые значения
| Константа | Кнопка | Значение |
| vbOK | OK | 1 |
| vbCancel | Отмена | 2 |
| vbAbort | Прервать | 3 |
| vbRetry | Повторить | 4 |
| vbIgnore | Пропустить | 5 |
| vbYes | Да | 6 |
| vbNo | Нет | 7 |
Значение, возвращаемое функцией MsgBox, используется для выбора дальнейших действий исполняемой программы в зависимости от нажатой кнопки.
Для третьего примера зададим следующие параметры первой функции MsgBox:
- Prompt = «Выберите кнопку!»
- Buttons = 323 (3 (vbYesNoCancel) + 64 (vbInformation) + 256 (vbDefaultButton2))
- Title = «Выбор кнопки»
Вторая функция MsgBox используется как простое информационное сообщение с параметрами по умолчанию.
Пример 3
В этом примере, в зависимости от нажатой кнопки в первом диалоговом окне, во втором сообщении выводится название нажатой кнопки. Обратите внимание, что вторая кнопка в открывшемся первом окне MsgBox выделена по умолчанию и срабатывает при нажатии клавиши «Enter».
А что будет, если первое диалоговое окно из третьего примера закрыть крестиком? Проверьте сами.
VBA Excel. Функция MsgBox (синтаксис, параметры, значения) : 5 комментариев
У Вас такие классные лекции по VBA! Очень наглядное и доступное изложение!
минуточку. будьте любезны помедленнее, я записываю.
А нельзя ли в лс на пальцах объяснить, как сделать анимированную gif иконку-баннер (для размещения на сайт) с нужными размерами, нужными кнопками и нужным текстом.
))) на гифку кнопки не наложишь, все будет как картинка! В фотошопе сделай, это элементарно!
Сергей, специалиста по созданию баннеров, к сожалению, у нас нет.
Примечание: Мы стараемся как можно оперативнее обеспечивать вас актуальными справочными материалами на вашем языке. Эта страница переведена автоматически, поэтому ее текст может содержать неточности и грамматические ошибки. Для нас важно, чтобы эта статья была вам полезна. Просим вас уделить пару секунд и сообщить, помогла ли она вам, с помощью кнопок внизу страницы. Для удобства также приводим ссылку на оригинал (на английском языке).
Базы данных Access рабочего стола функция MsgBox выводится сообщение в диалоговом окне, ожидает нажатия кнопки и возвращает целое число , указывающее, какая нажата кнопка.
MsgBox ( сообщение [ , кнопки ] [ , заголовок ] [ , файл_справки ] [ , контекст ] )
Функция MsgBox имеет следующие аргументы:
Обязательный аргумент. Строковое выражение, отображаемое как сообщение в диалоговом окне. Максимальная длина строки аргумента сообщение составляет приблизительно 1024 знаков и зависит от их ширины. Если аргумент сообщение содержит несколько строк, их можно разделить с помощью знака возврата каретки ( Chr (13 )), знака перевода строки ( Chr (10 )) или сочетания этих знаков ( Chr (13 ) & Chr (10 ))
Необязательный аргумент. Числовое выражение, которое представляет собой сумму значений, указывающих число и тип отображаемых кнопок, стиль значка, кнопку, используемую по умолчанию, а также то, является ли окно сообщения модальным. Если аргумент кнопки пропущен, по умолчанию используется значение 0.
Необязательный аргумент. Строковое выражение, отображаемое в заголовке диалогового окна. Если аргумент заголовок опущен, в заголовке выводится имя приложения.
Необязательный аргумент. Строковое выражение, определяющее файл, в котором содержится контекстная справка для данного диалогового окна. Если задан аргумент файл_справки, необходимо также указать аргумент контекст.
Необязательный аргумент. Числовое выражение, представляющее собой номер контекста, присвоенный автором справки соответствующему разделу. Если задан аргумент контекст, необходимо также указать аргумент файл_справки.
Аргумент кнопкиTE000127245 имеет следующие параметры:
