AskString - Revision history

Admin: 1 revision imported

2024-09-06T11:03:13Z

1 revision imported

1>Admin at 16:46, 31 July 2024

2024-07-31T16:46:30Z

Admin: 1 revision imported

2021-02-07T06:43:09Z

1 revision imported

Admin at 14:20, 8 June 2019

2019-06-08T14:20:26Z

New page

{{infobox function
|name=AskString
|object=[[Функции общего назначения]]
|caption=Визуальные функции
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку, число
|visual=1}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
Функция выводит модальный диалог редактирования текста, заданного первым аргументом. Текст может содержать как одну строку, так быть и многострочным. Результат редактирования возвращается в переменной, задающей первый аргумент.

== Синтаксис ==
<code>
'''AskString'''({{ByRef|<Текст для редактирования (STRING)>}}{{Optional|,<Заголовок диалога (STRING)>,<Максимальная длина строки (INT)>{{Default|{{Eq}}256}},<Тип строки (INT)>{{Default|{{Eq}}0}}}}):''<Пользователь нажал на ОК (INT)>''
</code>
==== Аргументы ====
* <code>''<Текст для редактирования (STRING)>''</code> - {{ByRef}} Переменная, содержащая строку, которую необходимо отредактировать.
* <code>''<Заголовок диалога (STRING)>''</code> - {{Optional}} Заголовок диалога редактирования строки
* <code>''<Максимальная длина строки (INT)>''</code> - {{Optional}} Задает максимально возможную длину строки (по умолчанию 256), для неограниченной длины строки, необходимо указать 0.
* <code>''<Тип строки (INT)>''</code> - {{Optional}} Задает тип редактируемой строки:
** '''0''' -- (по умолчанию) текст представляет собой одну строку, невозможен ввод многострочного текста.
** '''1''' -- текст может содержать множество строк, диалог будет показан в виде окна, а не поля.
** '''-1''' -- текст представляет собой одну строку, невозможен ввод многострочного текста, строка по умолчанию не будет выделена при показе диалога (удобно, если в основном происходит добавление текста в строку, а не редактирование нового текста).

==== Возвращаемое значение ====
Возвращает 1, если пользователь нажал "ОК", иначе возвращает 0.

== Примеры ==
<pre>
//Выбирает табельные номера работников в многострочном окне, сохраняет их в реквизит текущего элемента.
Стр:="";
If AskString(Стр,"Введите табельные номера через запятую:",0,1) Then
aEl.ТабельныеНомераРаботников:=Replace(Стр,_NEWLINE,"");
EndIf;
</pre>

← Older revision	Revision as of 11:03, 6 September 2024
(No difference)

@@ Line 26: / Line 26: @@
 ** '''0''' -- (по умолчанию) текст представляет собой одну строку, невозможен ввод многострочного текста.
 ** '''1''' -- текст может содержать множество строк, диалог будет показан в виде окна, а не поля.
 ** '''-1''' -- текст представляет собой одну строку, невозможен ввод многострочного текста, строка по умолчанию не будет выделена при показе диалога (удобно, если в основном происходит добавление текста в строку, а не редактирование нового текста).

← Older revision	Revision as of 06:43, 7 February 2021
(No difference)