Функція InputBox
Відображає вікно введення, що видає користувачеві запит на введення рядка.
InputBox ( "title" , "prompt" [, "default" [, "password char" [, width = - 1 [, height = - 1 [, left = Default [, top = Default [, timeout = 0 [, hwnd ]]]]]]]]] )
| title | Заголовок вікна введення. |
| prompt | Повідомлення користувачеві, що пояснює, що необхідно ввести. |
| default | [необов'язковий]Значення, яке буде відображено у рядку введення, коли з'явиться вікно введення. |
| password char | [необов'язковий]Символ, на який будуть замінюватися всі символи. Якщо необхідно, щоб відображалися саме символи, передайте в якості параметра порожній рядок ("") (за замовчуванням) або пробіл як перший символ. Якщо буде передано рядок з кількома символами, лише перший символ буде використано для "маскування" введення. Другий та наступний символи рядка мають спеціальне значення. Див. примітки. |
| width | [необов'язковий]Ширина вікна (за замовчуванням -1). |
| height | [необов'язковий]Висота вікна (за замовчуванням -1). |
| left | [необов'язковий]Координата лівого краю вікна (за замовчуванням Default , щоб центрувати вікно). |
| top | [необов'язковий]Координата верхнього краю вікна (за замовчуванням Default , щоб центрувати вікно). |
| timeout | [необов'язковий]Час очікування (в секундах), після якого InputBox буде автоматично закритий (за замовчуванням 0, що означає, що час відображення не обмежений). |
| hwnd | [необов'язковий]Дескриптор батьківського вікна. Запобігає доступу до батьківськоговікно, доки існує InputBox. |
| Успіх: | Повертає введений рядок. |
| Помилка: | Повертає "" (порожній рядок) і встановлює значення @error рівним: |
| @error | 0 = введений рядок допустимий. |
| 1 = натиснуто кнопку скасування (Cancel). | |
| 2 = час очікування минув. | |
| 3 = помилка відкриття вікна введення. Зазвичай, причиною є неправильні параметри. | |
| 4 = вікно введення не може відображатися на жодному з моніторів. | |
| 5 = неправильно передані параметри (widthбезheightабоleftбезtop). |
Розмір вікна може бути змінений користувачем, але має мінімальні розміри 190 x 115 пікселів . За замовчуванням розмір вікна дорівнює 250 x 190 пікселів.
Довжина рядка, що повертається, не перевищує 254 символи і, якщо введений рядок містить символи повернення каретки або перекладу рядка, результат буде обрізаний до першої появи цих символів.
Другий і наступний символи параметраpasswordпризначені для обмеження введення користувача. Використовуйте пробіл як перший символ, щоб символи, що вводяться, як і раніше відображаються. Використання символуM(англ.) як другий символ параметра вказує що введення будь-якого значення примусове (англ.Mandatory). Нічого не станеться при натисканні кнопкиOk, якщо в рядку введення немає жодного значення. В цьому випадку вікно не буде зачинено.
Також можна вказати максимальну довжину рядка введення. Для цього є останні символи параметраpassword(див. приклад).
; Цей приклад містить параметри за промовчанням. ; $answer = InputBox("Заголовок", "Пояснення","Текст поля введення", "", -1, -1, Default, Default, 0)
; Діалогове вікно з'явиться у лівому верхньому кутку, відображаючи символи, що вводяться як є. $answer = InputBox ("Питання", "Де ви народилися?", "Планета Земля", "", - 1, - 1, 0, 0)
; Просить користувача ввести пароль, замість символів відображаються зірочки. Не забудьте перевірити це! $passwd = InputBox ( "Перевірка безпеки" , "Введіть пароль." , "" , "*" )
; Просить користувача ввести 1 або 2 символи у полі введення. Символ M у параметрі пароля означає, що порожній рядок не приймаються і при натисканні OK нічого не відбудеться; символ 2 означає, що неможливо ввести більше 2 символів. $value = InputBox ( "Тестування" , "Введіть 1 або 2 символи." , "" , " M2" )