InputBox
Функция InputBox позволяет ввести одну строку текста.
int WINAPI InputBox(
const char *Title,
const char *Prompt,
const char *HistoryName,
const char *SrcText,
char *DestText,
int DestLength,
const char *HelpTopic,
DWORD Flags
);
Параметры
Title
Заголовок окна ввода. Может быть равен NULL или "".
Prompt
Приглашение на ввод данных. Может быть равен NULL или "".
HistoryName
Адрес строки для "истории". Установите в NULL если "история" ввода не используется.
SrcText
Исходные данные для ввода и редактирования. Может быть равен NULL или "".
DestText
"Приемник" введенных данных. Может указать на ту же область памяти что и SrcText.
DestLength
Размер "приемника"
HelpTopic
Адрес строки с
названием темы
помощи в формате "<FullPath>Topic", например:
"<D:\\FAR\\Plugins\\Foo\\>FooInfo"
Установите в NULL если подсказка не используется.
Flags
Может быть комбинацией следующих значений (перечисленние
INPUTBOXFLAGS):
| Константа | Описание |
| FIB_ENABLEEMPTY |
даже если строка ввода пуста функция вернет значение TRUE. |
| FIB_PASSWORD |
используется для ввода пароля - вводимый текст на экране отрисовывается символами '*'. |
| FIB_EXPANDENV |
после успешного ввода, в строке DestText идентификаторы переменных окружения заменяются на их значения, например, если пользователь ввел '%TEMP%', то DestText будет содержать 'C:\TEMP'. |
| FIB_NOUSELASTHISTORY |
не использовать предыдущее значение из истории, оставить строку ввода пустой; актуален, если параметр HistoryName не равен NULL. |
| FIB_BUTTONS |
показать разделительную линию и кнопки [Ok] и [Cancel]. Диалог увеличится на 2 строки. |
| FIB_NOAMPERSAND |
не показывать в приглашении ввода амперсанд, использовать его для определения горячей клавиши. |
Возвращаемое значение
Функция возвращает TRUE в случае успешного ввода строки и
FALSE, если пользователь прервал ввод.
Замечания
FAR Manager использует данную функцию, когда пользователь пытается создать
папку:
Пример
Смотрите также: