Admin: 1 revision imported

2021-02-07T06:51:47Z

1 revision imported

Admin at 11:25, 30 October 2020

2020-10-30T11:25:38Z

New page

{{infobox function
|name=MassSelectObjects
|object=[[Функции общего назначения]]
|caption=Загрузка модулей
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку или число, неверный путь, отсутствует заданный модуль
|visual=1}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
Функция позволяет загружать и инициировать выполнение модуля и формы в модальном режиме для выбора множества объектов базы данных из списка объектов, при этом возможно начальное позиционирование на указанный объект, определение требуемого объекта формы списка объектов (если их несколько), изменение заголовка формы, использование других возможностей. В момент выбора очередного объекта пользователем, система вызывает особую функцию выбора (возможно с доп. параметром), имя которой задается в первом аргументе. Функция не возвратится до тех пор, пользователь не закроет исполняемый модуль, при этом, модуль может изменить переданные параметры, если они представляли собой переменные. Функция не может использоваться для локальных клиентов, не связанных с базой данных. Путь, задаваемый вторым аргументом этой функции, может представлять собой [[Имена файлов|серверный файловый путь]] (пример: '''Modules\FreeForms\Касса\Список доверенностей''') или наименование объекта базы данных в виде <code><Тип объекта>.<Вид объекта></code> (пример '''Ref.Номенклатура'''), система преобразовывает его в соответствующий путь. По своему действию функция совпадает с функцией [[SelectObject]], однако, после выбора элемента пользователем, будет вызвана именованная процедура из контекста вызывавшего модуля, после чего пользователь сможет продолжить выбор. Выбор заканчивается только после того, как пользователь закрывает форму выбора. Некоторые отличия этой функции от [[LoadModule]], [[OpenObject]], а также особенности поведения модуля и формы, открытых этой функцией:
* Функция работает только в модальном режиме, выбор режима загрузки недоступен.
* В открытой функцией форме идентифицируется (по умолчанию задается в [[Студия/Редактор форм|Студии]], см. isDefaultControl) табличный элемент формы, список или древовидный элемент формы, которые используются для выбора объекта. При нажатии на клавишу ''Enter'', либо двойном клике мышью, система автоматически закроет форму и передаст выбранный объект в виде результата.
* По умолчанию запрещен выбор папок справочников, чтобы разрешить выбор папок наряду с обычными элементами, необходимо установить галку ''areFoldersSelectable'' на используемом для выбора элементе формы в [[Студия/Редактор форм|Студии]], либо указать возможность выбора папок в аргументе <Дополнительные установки> этой функции.
* Если в таблице элементов объекта присутствует по крайней мере один периодический реквизит, в заголовок формы будет также добавлена дата загрузки периодических реквизитов. Изменение периода загрузки реквизитов производится с помощью функций [[Form.BegPeriodDate]] и [[Form.EndPeriodDate]]. При этом функция ''Form.EndPeriodDate'' автоматически обновит таблицу элементов объекта.
* Модуль и форма, используемые системой по умолчанию задаются в [[Студия/Конфигурация данных проекта|Студии]] и зависят от дополнительных установок, передаваемых в эту функцию. К примеру, для выбора элементов может быть задана одна форма по умолчанию, а для выбора папок другая.
Загрузка модуля проходит следующие этапы:
{{Load module stages}}

== Синтаксис ==
<code>
'''MassSelectObjects'''(''<Имя функции для принятия результата выбора (STRING)>'',''<Путь или имя базы данных (STRING)>''{{OptionalByRef|,<Параметр>,<Опция>}}{{Optional|,<Имя модуля (STRING)>{{Default|{{Eq}}"Module"}},<Имя формы (STRING)>{{Default|{{Eq}}"SelectForm"}},<Объект для позиционирования>,<Наименование объекта формы, осуществляющего выбор (STRING)>,<Заголовок формы (STRING)>,<Параметр функции принятия выбора>,<Дополнительные установки (INT)>{{Default|{{Eq}}0}}}})
</code>
==== Аргументы ====
* <code>''<Имя функции для принятия результата выбора (STRING)>''</code> - Имя функции вызывавшего модуля, которая последовательно получает выбранные пользователем элементы. Функция будет вызвана внутри контекста вызывавшей формы и может дополнительно принять один аргумент, используемый по усмотрению разработчика. Функция определяется в следующем виде: <code>Function <ИмяФункции>(<Выбранный элемент>{{Optional|,<Дополнительный параметр функции>}})</code>.
* <code>''<Путь или имя базы данных (STRING)>''</code> - Строковое представление данного аргумента может представлять собой путь к объекту базы данных, относительный путь к папке проекта на сервере. См. описание этой функции для более полной информации.
* <code>''<Параметр>,<Опция>''</code> - {{ByRef}} {{Optional}} Аргументы передаются в вызываемый модуль без изменения, и могут использоваться по усмотрению разработчика. Аргументы будут доступы начиная с первого вызова модуля под именами '''Param''' и '''Option'''. При открытии/загрузке объектов базы данных первый аргумент (''Param'') рекомендуется использовать для указания на родителя (Parent) текущего элемента или списка элемента справочников. Система сама может пытаться использовать по умолчанию значение этого аргумента, как родителя справочника при загрузке объектов (это поведение, однако, может быть изменено). Если аргументы представлены переменными и модуль вызывается в модальном режиме, вызываемая программа может изменить значения этих переменных и, после того, как вызываемый модуль закончит работу, измененные значения будут переданы в исходных переменных.
* <code>''<Имя модуля (STRING)>''</code> - {{Optional}} Имя загружаемого модуля, если этот параметр не указан, будет использовано имя, заданное в [[Студия/Конфигурация данных проекта|Студии]], либо '''Module''', если в проекте модуль не задан.
* <code>''<Имя формы (STRING)>''</code> - {{Optional}} Имя загружаемой формы, если этот параметр не указан, будет использовано имя, заданное в [[Студия/Конфигурация данных проекта|Студии]], либо '''SelectForm''', если в проекте форма не задана. Если форма не будет использоваться (загруженный модуль будет закрыт, так как функция ''OnOpen'' возвратит 0, либо произойдет исключение и пр.), т.е. загрузка будет прервана до начала загрузки визуальной части, этот параметр не имеет значения.
* <code>''<Объект для позиционирования>''</code> - {{Optional}} Объект базы данных, на который будет выполнено позиционирование экранного элемента, в котором осуществляется выбор.
* <code>''<Наименование объекта формы, осуществляющего выбор (STRING)>''</code> - {{Optional}} Наименование объекта формы, в котором осуществляется выбор. Если этот параметр не задан, таким объектом принимается элемент формы, имеющий признак isDefaultControl, задаваемый в [[Студия/Редактор форм|Студии]].
* <code>''<Заголовок формы (STRING)>''</code> - {{Optional}} Задает заголовок формы выбора, заголовок можно изменить и после загрузки формы.
* <code>''<Параметр функции принятия выбора>''</code> - {{Optional}} Может использоваться, к примеру, если несколько вызовов ''MassSelectObjects'' используют одну функцию выбора, чтобы последняя смогла отличить один вызов от другого.
* <code>''<Дополнительные установки (INT)>''</code> - {{Optional}} Битовая маска, определяющая дополнительные установки выбора:
** Бит 0 (1) -- Разрешает выбирать папки справочников (1), либо только элементы (0, по умолчанию).
** Бит 1 (2) -- Форсирует выбор родителя справочника до начала выбора элемента, если справочник имеет родителей (по умолчанию -- нет). Данный пункт позволяет открыть другие формы выбора для выбора родителей данного справочника, если они заданы до того, как произойдет открытие формы выбора элемента. Выбранные родители будут установлены, как родительский элемент на элементе формы, в котором отображены выбираемые элементы (соответствует установке [[Form.ParentElement]]). Формы для выбора родителей вызываются с установками по умолчанию, если необходимо произвести выбор родителей с установками, отличными от умолчания, программа должна предусмотреть вызов функций [[SelectObject]] для выбора родителей и передачи выбранного родителя в форму выбора подчиненных элементов самостоятельно.

==== Возвращаемое значение ====
Функция не возвращает значимый результат.

== Примеры ==
<pre>
//Функция инициирует выбор документов определенного вида из журнала документов "ОбщийЖурнал"
MassSelectObjects("ПриПодбореДокументов","Jor.ОбщийЖурнал",ВидДокументов,0,"Module","SelectForm",аДокТек,,"Выберите требуемые документы:",aList);

//Функция подбора может выглядеть сл. образом, заполняется список спДокументы
Function ПриПодбореДокументов(aEl,oList)
If isEmpty(aEl) Then
Exit;
EndIf;
If aEl.DBName()<>ВидДокументов Then
Box("Документ "+aEl+" несовместим с выбранным типом фильтра!",Q_STOP);
Exit;
EndIf;
If спДокументы.Find(aEl)>0 Then
Box("Документ "+aEl+" уже был выбран!",Q_STOP);
Exit;
EndIf;
спДокументы.Add(aEl);
EndFunction
</pre>

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

MassSelectObjects - Revision history

Admin: 1 revision imported

Admin at 11:25, 30 October 2020