Відображає запит у діалоговому вікні, очікує, доки користувач введе текст або натисне кнопку, і повертає значення типу 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 | Необов’язковий аргумент. Рядковий вираз, що визначає файл довідки для надання контекстної довідки в діалоговому вікні. Якщо надано аргумент helpfile , потрібно також указати контекст . |
| context | Необов’язковий аргумент. Числовий вираз, що є номером контексту довідки, який відповідному розділу довідки призначив її автор. Якщо надано контекст , також потрібно вказати helpfile . |
Примітки
Коли надаються обидва файли довідки та контекст , користувач може натиснути клавішу 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)