===== CreateStringInputVA =====
==== Синтаксис ====
<code c>GUI* CreateStringInputVA( int, ... );</code>

==== Описание ====
Функция создает окно для ввода текста

==== Параметры ====
  * **int** - 0
== Переменные аргументы: ==
  * **VAR_BOOK** - указатель на BOOK к которой необходимо привязать GUI
  * **VAR_HEADER_TEXT** - strID текста, используемого в качестве заголовка окна
  * **VAR_OK_PROC** - указатель на функцию, которая будет выполнена при подтверждении
  * **VAR_PREV_ACTION_PROC** - указатель на функцию, которая будет выполнена при нажатии на клавишу назад
  * **VAR_LONG_BACK_PROC** - указатель на функцию, которая будет выполнена при удержании клавиши назад

  * **VAR_STRINP_MODE** - устанавливает тип вводимого теста

  * **VAR_STRINP_FIXED_TEXT** - strID фиксированого(не удаляемого) текста в окне
  * **VAR_STRINP_TEXT** - strID предустановленого текста
  * **VAR_STRINP_NEW_LINE** - устанавливает курсор вводимого текста на новую строку (0-не устанавливать, 1 - установить)
  * **VAR_STRINP_ENABLE_EMPTY_STR** - разрешает/запрещает подтверждение пустой строки при вводе (0 - запретить, 1 - разрешить)

  * **VAR_STRINP_MAX_LEN** - параметр устанавливает максимальную длину для вводимой строки
  * **VAR_STRINP_MIN_LEN** - параметр устанавливает минимальную длину для вводимой строки
  * **VAR_STRINP_IS_PASS_MODE** - включает режим для ввода пароля, вводимый текст будет скрываться звездочками (1 - включить)
  * **VAR_STRINP_OK_ON_DIEZ** - устанавливает подтверждение вводимого текста на нажатие решётки (1-установить)

  * **VAR_STRINP_SET_INT_VAL** - устанавливает значение типа int, как текст в окне
  * **VAR_STRINP_MIN_INT_VAL** - устанавливает минимальное значение для целого числа
  * **VAR_STRINP_MAX_INT_VAL** - устанавливает максимальное значение для целого числа

==== Тип вводимого текста ====
<code c>
enum INPUT_TYPES {
  IT_REAL=0,
  IT_STRING=1,
  IT_INTEGER=2,
  IT_PHONE_NUMBER=3,
  IT_DIGITAL_PASS=4,
  IT_DIGITAL_IP=5,
  IT_URL=6,
  IT_UNSIGNED_DIGIT=9,
  IT_EXTRA_DIGIT=10,
  IT_ABC_OR_DIGIT=11,
  IT_EXTRA_DIGIT_2=12,
  IT_ABC_OR_DIGIT_2=13,
};
</code>

==== Возвращаемое значение ====
Возвращает указатель на созданный GUI

==== Пример ====
<code c>
void OnBackCreateStringInput(BOOK * bk, u16 *string, int len)
{
  FreeBook(bk);
}

void OnOkCreateStringInput(BOOK * bk, wchar_t *string, int len)
{
  MessageBox(EMPTY_TEXTID,TextID_Create(string,ENC_UCS2,len),NOIMAGE,1,7000,0);
}

void CreateStringInput_(void)
{
  BOOK *StrInput = new BOOK;
  CreateBook(StrInput,0,0,"StringInputTest",-1,0);
  CreateStringInputVA(0,
                    VAR_BOOK(StrInput),
                    VAR_STRINP_MODE(1),
                    VAR_STRINP_FIXED_TEXT(STR("Fixed Text: ")),
                    VAR_STRINP_TEXT(STR("Text")),
                    VAR_STRINP_NEW_LINE(0),
		    VAR_STRINP_MAX_LEN(128),
		    VAR_STRINP_MIN_LEN(4),
                    VAR_STRINP_OK_ON_DIEZ(1),
                    VAR_PREV_ACTION_PROC(OnBackCreateStringInput),
                    VAR_LONG_BACK_PROC(OnBackCreateStringInput),
                    VAR_OK_PROC(OnOkCreateStringInput),
                    0);
}
</code>

==== См.также ====
[[StringInput_GetStringAndLen]]