Показва подкана в диалогов прозорец, изчаква потребителя да въведе текст или да щракне върху бутон и връща стойност от тип String, съдържаща съдържанието на текстовото поле.
Синтаксис
InputBox ( подкана [, заглавие ] [, по подразбиране ] [, xpos ] [, ypos ] [, помощен файл ] [, контекст ] )
Синтаксисът на функцията InputBox има следните аргументи:
|
Аргумент |
Описание |
|
Бърз |
Задължително. Израз във формата на низ, показан като съобщение в диалоговия прозорец. Максималната дължина на подканата е приблизително 1024 знака в зависимост от ширината на използваните знаци. Ако подканата се състои от повече от един ред, можете да разделите редовете с помощта на знак за нов абзац (Chr(13)), знак с информационен канал (Chr(10)) или комбинация от знаци за нов абзац и нов ред (Chr(13) & Chr(10)) между всеки ред. |
|
Заглавие |
Незадължително. Израз във формата на низ, показан в заглавната лента на диалоговия прозорец. Ако изпуснете заглавието, името на приложението се поставя в заглавната лента. |
|
по подразбиране |
Незадължително. Израз във формата на низ, показан в текстовото поле като отговор по подразбиране, ако не е предоставено друго въвеждане. Ако пропуснете по подразбиране, текстовото поле се показва празно. |
|
xpos |
Незадължително. Числов израз, който задава в туипове хоризонталното разстояние на левия ръб на диалоговия прозорец от левия край на екрана. Ако xpos е пропуснато, диалоговият прозорец е хоризонтално центриран. |
|
ypos |
Незадължително. Числов израз, който задава в туипове вертикалното разстояние на горния ръб на диалоговия прозорец от горната част на екрана. Ако ypos е пропуснато, диалоговият прозорец е вертикално позициониран приблизително една трета от пътя надолу по екрана. |
|
помощен файл |
Незадължително. Израз във формата на низ, който идентифицира помощния файл, който да се използва за предоставяне на контекстно зависими помощна информация за диалоговия прозорец. Ако е предоставен помощен файл , също трябва да се предостави контекст . |
|
Контекста |
Незадължително. Числов израз, който е номерът на контекста на помощта, присвоен на съответната помощна тема от автора на помощта. Ако е предоставен контекст , трябва също да бъде предоставен помощен файл . |
Забележки
Когато са предоставени както помощен файл , така и контекст , потребителят може да натиснете F1 (Windows) или HELP (Macintosh), за да видите помощната тема, съответстваща на контекста. Някои хост приложение, например Microsoft Office Excel 2007, също така автоматично добавят бутон "Помощ " в диалоговия прозорец. Ако потребителят щракне върху OK или натисне КЛАВИША ENTER, функцията InputBox връща това, което има в текстовото поле. Ако потребителят щракне върху "Отказ", функцията връща низ с нулева дължина ("").
Забележка: За да зададете повече от първия наименуван аргумент, трябва да използвате Полето за въвеждане в израз. За да изпуснете някои позиционни аргументи, трябва да включите съответния разделител запетая.
Пример
Забележка: Примерите по-долу илюстрират използването на тази функция във Visual Basic for Applications (VBA). За повече информация относно работата с VBA изберете Справочни материали за разработчици в падащия списък до Търсене и въведете един или няколко термина в полето за търсене.
Този пример показва различни начини за използване на функцията InputBox , за да подкани потребителя да въведе стойност. Ако позициите x и y са пропуснати, диалоговият прозорец автоматично се центрира по съответните оси. Променливата MyValue съдържа стойността, въведена от потребителя, ако потребителят щракне върху OK или натисне клавиша ENTER. Ако потребителят щракне върху "Отказ", се връща низ с нулева дължина.
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)
