НазначитьТип

Назначить тип для элемента диалога неопределенного вида.

Синтаксис:

НазначитьТип(<ИмяТипа>, <Длина>, <Точность>)

Англоязычный синоним:

AssignType

Параметры:

<ИмяТипа>	Строковое выражение — название типа данных, ко­торое назначается элементу диалога. Например: "Строка", "Число", "Справочник.Товары", "Документ.РасходнаяНак­лад­ная" и т. п.
<Длина>	Необязательный параметр. Числовое выражение — длина поля представления данных. Имеет смысл только при задании числового или строкового типа.
<Точность>	Необязательный параметр. Числовое выражение — число знаков числа после десятичной точки. Имеет смысл только при задании числового типа.

Описание:

Метод НазначитьТип позволяет назначить тип для элемента диалога, ко­торому в конфигураторе назначен тип «Неопределенный».

Данный метод доступен в контексте Модуля формы (см. «Виды программ­ных модулей»).

Пример:

Форма.ВыбКолич.НазначитьТип("Число", 15, 2);

Форма.ВыбДата.НазначитьТип("Дата");

Форма.ВыбТовар.НазначитьТип("Справочник.Товары");

Форма.ВыбДокум.НазначитьТип("Документ");

См. также: УстановитьТип, ТипЗначения, ТипЗначенияСтр

НеИзменятьВид

Позволяет запретить пользователю при выборе значения справочни­ка, документа, счета неопределенного вида изменять вид.

Синтаксис:

НеИзменятьВид(<Признак>)

Англоязычный синоним:

FixKind

Параметры:

<Признак>

Числовое выражение — признак запрета изме­нения вида. Может принимать значения: 0 — разрешить изменение вида при выборе зна­чения; 1 — запретить изменение вида при выборе зна­чения.

Возвращаемое значение:

Число — текущее значение признака.

Описание:

Метод НеИзменятьВид применяется для реквизитов диалога формы, имеющих тип справочника, документа, счета неопределенного вида. Он позво­ляет запретить при выборе значения изменение вида значения.

Предположим, в диалоге существует реквизит типа справочник неопреде­ленного вида. Вид этого элемента устанавливается при помощи встроенного языка процедурой НазначитьВид. Метод НеИзменятьВид(1) позволяет за­претить пользователю при выборе значения выбрать вид справочника.

Пример:

* Например, в некотором документе, для его реквизита «Контрагент» типа справочник неопределенного вида, назначается вид «Организации» или «Сотрудники» и запрещается интерактивное изменение вида пользовате­лем.

Процедура ВводНаОсновании(ДокОсн)

Если ДокОсн.Вид() = "Счет" Тогда

НазначитьВид(Контрагент, «Организации»);

Иначе

НазначитьВид(Контрагент, «Сотрудники»);

КонецЕсли;

Форма.Контрагент.НеИзменятьВид(1);

КонецПроцедуры

Методы контекста Модуля формы

Описанные в данном разделе методы доступны только в контексте Модуля формы (см. «Виды программных модулей»). К модулям форм относятся прак­тически все программные модули (исключение составляют Глобальный модуль, Модуль документа, Модуль вида расчета).

ОткрытьПодбор

Открыть форму для подбора значений.

Синтаксис:

ОткрытьПодбор(<ИмяОбъекта>, <ИмяФормы>, <КонтекстФормы>, <ФлагМножВыбора>,

<ТекЗнач>)

Англоязычный синоним:

OpenPermanentChoice

Параметры:

<ИмяОбъекта>	Строковое выражение — имя объекта агрегатного типа, форму списка которого требуется открыть для подбора. Можно указывать справочник, жур­нал, документ (при указании документа открыва­ется форма журнала для указанного документа). Имя объекта задается в следующем виде: "Справочник.ХХХХХ"; "Документ.ХХХХХ"; "Отчет.ХХХХХХ"; "Обработка.ХХХХХХ"; "Журнал.ХХХХХ" , где ХХХХХ — имя вида соответствующего объекта, как он задан в конфигураторе, например: "Справочник.Товары"; "Журнал.Подчиненные"; "ЖурналОпераций.ХХХХХ", где ХХХХХ — форма журнала пераций. "ПланСчетов.ХХХХХ", где ХХХХХ — идентификатор плана счетов, как он за­дан в конфигураторе. Если ХХХХХ не за­дан, то открывается подбор из любого (всех) плана счетов.
<ИмяФормы>	Строковое выражение — имя формы подбора, как она задана в конфигураторе. Поскольку и справочники и журналы могут иметь несколько форм представления, то этим параметром можно конкретно указать, какая из форм представления объекта вызывается для подбора значений.
<КонтекстФормы>	Необязательный параметр. Имя переменной, куда можно задать значение любого типа для передачи в открываемую форму. Данное значение будет доступно в открытой форме как атрибут Форма.Параметр. После исполнения данного метода система вер­нет в данную переменную контекст формы подбо­ра (см. «Передача контекста в качестве парамет­ра»). С помощью значения этого контекста можно затем произвольно манипулировать формой под­бора, пока она открыта. Пока форма открыта, тип значения данного параметра равен 100 (см. ТипЗначения), если закрыта — 0.
<ФлагМножВы6ора>	Необязательный параметр. Число: 1 — выбор не­скольких значений; 0 — выбор одного значения, после чего окно закрывается. Значение по умол­чанию: 1.
<ТекЗнач>	Необязательный параметр. В случае выбора из списка, здесь можно передать значение, на кото­рое следует изначально установить курсор при открытии формы подбора.

Описание:

Метод ОткрытьПодбор, который доступен только в контексте Модуля формы, выполняет открытие формы для подбора значений. Используется, на­пример, для подбора значения реквизита документа.

При открытии подбора по журналу подчиненных документов, т. е. когда первый параметр <ИмяОбъекта> имеет значение "Журнал.Подчиненные", документ владелец, по которому следует построить журнал подчиненных доку­ментов, передается после вызова метода через полученный контекст формы.

Пример:

Процедура Подбор()

ГруппаДляВыбора = ТекущийЭлемент();

Если ГруппаДляВыбора.ЭтоГруппа() = 0 Тогда

ГруппаДляВыбора = ГруппаДляВыбора.Родитель;

КонецЕсли;

ОткрытьПодбор("Справочник.Товары", "ДляПодбора", КонтПодб, 0);

// установим в форме подбора реквизит "ГруппаВыбора"

// используя полученный контекст формы подбора

КонтПодб.ГруппаВыбора.ВыборГруппы(1);

КонтПодб.ГруппаВыбора = ГруппаДляВыбора;

КонтПодб.Обновить(0);

УстановитьЗначениеВПодборе("ГруппаВыбора", ГруппаДляВыбора);

КонецПроцедуры

См. также: ОбработкаПодбора, УстановитьЗначениеВПодборе