Відображає запит у діалоговому вікні, очікує, доки користувач введе текст або натисне кнопку, і повертає значення типу String, яке містить вміст текстового поля.
Синтаксис
InputBox(prompt [, title ] [, default ] [, xpos ] [, ypos ] [, helpfile ] [, context ] )
Синтаксис функції InputBox має такі аргументи:
| Аргумент | Опис |
|---|---|
| prompt | Обов’язковий аргумент. Рядковий вираз, що відображається як повідомлення в діалоговому вікні. Максимальна довжина підказки становить приблизно 1024 символи залежно від ширини символів, що використовуються. Якщо підказка складається з кількох рядків, їх можна розділити за допомогою символу повернення каретки (Chr(13)), символу переведення рядка (Chr(10)) або комбінації символів повернення каретки та переведення рядка (Chr(13) & Chr(10)) між кожним рядком. |
| title | Необов’язковий аргумент. Рядковий вираз, що відображається в рядку заголовка діалогового вікна. Якщо опустити заголовок, у рядку заголовка відображається ім'я програми. |
| default | Необов’язковий аргумент. Рядковий вираз, що відображається в текстовому полі як стандартна відповідь за відсутності вводу. Якщо не вибрати стандартне значення, текстове поле відображатиметься пустим. |
| xpos | Необов’язковий аргумент. Числовий вираз, що вказує горизонтальну відстань у твіпах між лівим краєм діалогового вікна та лівим краєм екрана. Якщо аргумент xpos пропущено, діалогове вікно відцентровується по горизонталі. |
| ypos | Необов’язковий аргумент. Числовий вираз, що вказує вертикальну відстань у твіпах між верхнім краєм діалогового вікна та верхнім краєм екрана. Якщо ypos не вказано, діалогове вікно розташовується приблизно на одну третю екрана вниз по вертикалі. |
| helpfile | Необов’язковий аргумент. Рядковий вираз, що визначає файл довідки для надання контекстної довідки в діалоговому вікні. Якщо файл довідки надано, потрібно також вказати контекст . |
| context | Необов’язковий аргумент. Числовий вираз, що є номером контексту довідки, який відповідному розділу довідки призначив її автор. Якщо вказано контекст , потрібно також надати файл довідки . |
Примітки
Якщо вказано і файл довідки , і контекст , можна натиснути клавішу F1 (Windows) або HELP (Macintosh), щоб переглянути розділ довідки відповідно до контексту. Деякі хост-програми також автоматично додають кнопку " Довідка " до діалогового вікна. Якщо користувач натисне кнопку OK або Enter, функція InputBox поверне все, що міститься в текстовому полі. Якщо користувач натисне кнопку Cancel, функція поверне рядок нульової довжини ("").
Примітка.
Щоб указати більше часу, ніж перший названий аргумент, необхідно використати у виразі функцію InputBox . Щоб пропустити деякі аргументи розташування, потрібно ввести відповідний роздільник комами.
Приклад
Примітка.
У прикладах нижче показано використання цієї функції в модулі Visual Basic for Applications (VBA). Щоб отримати докладні відомості про використання модуля VBA, клацніть пункт Довідник розробника в розкривному списку поряд із полем Пошук і введіть у поле пошуку принаймні один термін.
У цьому прикладі показано різні способи використання функції InputBox, щоб відобразити запит на ввід значення. Якщо позиції x та y пропущено, діалогове вікно автоматично розташовується по центру для відповідних осей. Змінна MyValue містить значення, введене користувачем, якщо користувач натисне ОК або натисне клавішу 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)