Показва подкана в диалогов прозорец, изчаква потребителя да въведе текст или да щракне върху бутон, и връща низ, съдържащ съдържанието на текстовото поле.
Синтаксис
InputBox(подкана [, заглавие ] [, по подразбиране ] [, xpos ] [, ypos ] [, помощен файл ] [, контекст ] )
Синтаксисът на функцията InputBox има следните аргументи:
| Аргумент | Описание |
|---|---|
| подкана | Задължително. Израз във формата на низ, показан като съобщение в диалоговия прозорец. Максималната дължина на подканата е приблизително 1024 знака в зависимост от ширината на използваните знаци. Ако подканата се състои от повече от един ред, можете да разделите редовете с помощта на знак за връщане на нов абзац (Chr(13)), знак за въвеждане на ред (Chr(10)) или комбинация от знаци за връщане на нов абзац – въвеждане на ред (Chr(13) & Chr(10)) между всеки ред. |
| заглавие | Незадължително. Израз във формата на низ, показан в заглавната лента на диалоговия прозорец. Ако пропуснете заглавие, името на приложението се поставя в заглавната лента. |
| по подразбиране | Незадължително. Израз във формата на низ, показан в текстовото поле като отговор по подразбиране, ако не е предоставена друга информация. Ако пропуснете стойността по подразбиране, текстовото поле се показва празно. |
| xpos | Незадължително. Числов израз, който задава в туипове хоризонталното разстояние на левия ръб на диалоговия прозорец от левия край на екрана. Ако xpos е пропуснато, диалоговият прозорец е хоризонтално центриран. |
| ypos | Незадължително. Числов израз, който задава в туипове вертикалното разстояние на горния ръб на диалоговия прозорец от горната част на екрана. Ако ypos е пропуснато, диалоговият прозорец се позиционира вертикално приблизително една трета от екрана. |
| помощен файл | Незадължително. Низов израз, който идентифицира помощния файл, който ще се използва за предоставяне на чувствителна към контекста помощ за диалоговия прозорец. Ако е предоставен помощен файл , трябва да се предостави и контекст . |
| Контекст | Незадължително. Числов израз, който е номерът на контекста на помощта, присвоен на съответната помощна тема от автора на помощта. Ако е предоставен контекст , трябва да се предостави и помощен файл . |
Забележки
Когато са предоставени както помощен файл , така и контекст , потребителят може да натисне клавиша F1 (Windows) или HELP (Macintosh), за да покаже помощната тема, съответстваща на контекста. Някои хост приложения също автоматично добавят бутон за помощ към диалоговия прозорец. Ако потребителят щракне върху OK или натисне клавиша ENTER, функцията InputBox връща каквото има в текстовото поле. Ако потребителят щракне върху "Отказ", функцията връща низ с нулева дължина ("").
Забележка
За да зададете повече от първия наименуван аргумент, трябва да използвате 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)