• 12/13/2018
  • Чтение занимает 2 мин
    • o

В этой статье

Отображает приглашение в диалоговом окне, ждет, пока пользователь введет текст или нажмет кнопку, и возвращает строку с содержимым текстового поля.Displays a prompt in a dialog box, waits for the user to input text or click a button, and returns a String containing the contents of the text box.

СинтаксисSyntax

InputBox(Prompt, [ Title ], [ Default ], [ кспос ], [ ИПОС ], [ HelpFile, context ])InputBox(prompt, [ title ], [ default ], [ xpos ], [ ypos ], [ helpfile, context ])

В синтаксисе функции InputBox представлены следующие именованные аргументы:The InputBox 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.
заголовок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.
defaultdefaultНеобязательно.Optional. Строковое выражение, отображаемое в текстовом поле в качестве ответа по умолчанию, если ввод вообще не будет выполнен.String expression displayed in the text box as the default response if no other input is provided. Если пропустить аргумент default, соответствующее текстовое поле отображается пустым.If you omit default, the text box is displayed empty.
кспосxposНеобязательно.Optional. Числовое выражение, задающее в твипах расстояние по горизонтали от левого края диалогового окна до левого края экрана.Numeric expression that specifies, in twips, the horizontal distance of the left edge of the dialog box from the left edge of the screen. Если аргумент xpos пропускается, диалоговое окно выравнивается по горизонтальной оси.If xpos is omitted, the dialog box is horizontally centered.
ипосyposНеобязательно.Optional. Числовое выражение, задающее в твипах расстояние по вертикали от верхнего края диалогового окна до верхнего края экрана.Numeric expression that specifies, in twips, the vertical distance of the upper edge of the dialog box from the top of the screen. Если аргумент ypos пропускается, диалоговое окно позиционируется по вертикальной оси и отстоит от верхнего края окна примерно на треть от высоты экрана.If ypos is omitted, the dialog box is vertically positioned approximately one-third of the way down the screen.
файл_справки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.

Если одновременно указаны аргументы файл_справки и контекст, пользователь может нажать клавишу 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. Если пользователь нажимает кнопку ОК или клавишу ВВОД, функция InputBox возвращает любой текст из текстового поля.If the user chooses OK or presses ENTER, the InputBox function returns whatever is in the text box. Если пользователь нажимает кнопку Cancel (Отмена), функция возвращает строку нулевой длины (“”).If the user chooses Cancel, the function returns a zero-length string (“”).

Читайте также:  Огурец полезные и опасные свойства огурцов

Примечание

Чтобы задать больше чем один первый именованный аргумент, необходимо использовать функцию InputBox в выражении.To specify more than the first named argument, you must use InputBox in an expression. Чтобы пропустить некоторые из позиционных аргументов, нужно вставить соответствующие запятые.To omit some positional arguments, you must include the corresponding comma delimiter.

ПримерExample

В этом примере показывается различные способы использования функции InputBox, чтобы пригласить пользователя ввести значение.This example shows various ways to use the InputBox function to prompt the user to enter a value. Если позиции x и y пропустить, диалоговое окно будет автоматически центрироваться относительно соответствующих осей.If the x and y positions are omitted, the dialog box is automatically centered for the respective axes. Переменная MyValue содержит значение, введенное пользователем, если пользователь нажимает кнопку ОК или нажимает клавишу ВВОД.The variable MyValue contains the value entered by the user if the user chooses OK or presses the ENTER key. Если пользователь нажимает кнопку Cancel (Отмена), возвращается строка нулевой длины.If the user chooses Cancel, a zero-length string is returned.

Dim Message, Title, Default, MyValue
Message = “Enter a value between 1 and 3” ‘ Set prompt.
Title = “InputBox Demo” ‘ Set title.
Default = “1” ‘ Set default.
‘ Display message, title, and default value.
MyValue = InputBox(Message, Title, Default)

‘ Use Helpfile and context. The Help button is added automatically.
MyValue = InputBox(Message, Title, , , , “DEMO.HLP”, 10)

‘ Display dialog box at position 100, 100.
MyValue = InputBox(Message, Title, Default, 100, 100)

См. такжеSee also

  • Метод Application.InputBox (Excel)Application.InputBox method (Excel)
  • Функции (Visual Basic для приложений)Functions (Visual Basic for Applications)

Поддержка и обратная связь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.