1С Предприятие 8.0. Описание встроенного языка

Методы


Активизировать (Activate)

Синтаксис:

Активизировать()

Описание:

Активизирует уже открытую форму.

Пример:

Если Форма.Открыта() Тогда 

    Форма.Активизировать() ;

КонецЕсли ;

ВводДоступен (IslnputAvailable)

Синтаксис:

ВводДоступен()

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



Тип: Булево. Истина - ввод данных в форму возможен (фор­ма активна). Ложь - форма не активна.

Описание:

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

Пример:

Если ВводДоступен() Тогда

    Сообщить("Введите текст");

КонецЕсли;

ВыбратьИзМеню (ChooseFromMenu)

Синтаксис:

ВыбратьИзМеню(< Список значений> , <Элемент формы>)

Параметры:

<Список значений>     Обязательный

Тип СписокЗначений. Список значений, содержащий значе­ния, из которых будет осуществляться выбор.

<Элемент формы>     Обязательный

Тип Элемент управления. Элемент формы, около которого будет открыто меню выбора. Для некоторых элементов (таблич­ный документ, табличное поле) меню будет показано около ак­тивной области

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

Тип ЭлементСпискаЗначений. Выбранный меню или Неопределено, если пользователь отказался от выбора.

Описание:

Позволяет выбор значение из меню. Набор значений для выбора задается списком значений. Меню будет расположено около пере­данного элемента формы или около его активной области.

Пример:

Список = Новый СписокЗначений;

Список.Добавить(Перечисления.ВидыДопРасходов.Доставка) ;

Список.Добавить(Перечисления.ВидыДопРасходов.Разгрузка) ;

// Перечисление "ВидыДопРасходов" содержит значения "Транспорт", 

// "Доставка", "Разгрузка". По смыслу элемент "Транспорт" исключен 

ВидДР = ВыбратьИзМеню(Список.ЭлементыФормы("КнопкаДР"));

ВыбратьИзСписка (ChooseFromList)

Синтаксис:

ВыбратьИзСписка(< Список значений> , <Элемент формы> , <Начальное значение> )




Параметры:

<Список значений>     Обязательный

Тип СписокЗначений. Список значений, содержащий значе­ния, из которых будет осуществляться выбор

<Элемент формы>     Обязательный

Тип Элемент управления. Элемент формы, около которого будет открыт выпадающий список. Для некоторых элементов (табличный документ, табличное поле) выпадающий список будет показан около активной области.

<Начальное значение>       Необязательный

Тип Число, ЭлементСпискаЗначений. Задает начальный элемент, который будет активным при открытии списка

Значение по умолчанию: Если параметр не указан, в списке не будет выбрано начальное значение.

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

Тип: ЭлементСпискаЗначений. Выбранный элемент списка или Неопределено, если пользователь отказался от выбора.

Описание:

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

Пример:

Список = Новый СписокЗначений;

Список Добавить(Перечисления ВидыДопРасходов.Доставка);

Список Добавить(Перечисления ВидыДопРасходов.Разгрузка);

// Перечисление "ВидыДопРасходов" содержит значения "Транспорт", 

// "Доставка", "Разгрузка" По смыслу элемент "Транспорт" исключен 

ВидДР = ВыбратьИзСписка(Список, ЭлементыФормы("ПолеВвода"), 1);

Закрыть (Close)

Синтаксис:

Закрыть(<Параметр закрытия>)

Параметры:

<Параметр закрытия>     Необязательный

Параметр закрытия формы, открытой в модальном режиме. Эта команда будет возвращена как результат метода, открывающего форму модально.

Значение по умолчанию: Неопределено.

Описание:

Закрыть форму Если закрываемая форма была открыта в мо­дальном режиме, то метод может передать команду закрытия ме­тоду, открывшему форму.

Пример:

Закрыть("ОК");



Обновить (Refresh)

Синтаксис:

Обновить()

Описание:

Обновляет данные, представленные в форме.

Пример:

Обновить();

ОповеститьОбАктивизацииОбъекта (NotifyActivateObject)

Синтаксис:

ОповеститьОбАктивизацииОбъекта(< Активный объект> )

Параметры:

<Активный объект>     Обязательный

Тип. Ссылка на объект, либо текущая строка табличного поля. Активизированный объект.

Описание:

Оповещает формы, подчиненные данной форме об изменении активного объекта и передает ссылку на этот объект. Данное дей­ствие аналогично стандартному оповещению подчиненного спра­вочника при изменении текущего элемента в списке справочника-владельца. Может применяться в случае, когда открытие подчи­ненной формы выполнено средствами языка.

Пример:

ОповеститьОбАктивизацииОбьекта(ТекущаяСтрока) ;

См. также:

Форма, событие ОбработкаАктивизацииОбъекта.

ОповеститьОВыборе (NotifyChoice)

Синтаксис:

ОповеститьОВыборе (< Значение выбора> )

Параметры:

<3начение выбора>     Обязательный

Результат выбора.

Описание:

Посылает оповещение владельцу формы о выполнении выбора или подбора, передает ему выбранное значение и закрывает фор­му, если она открыта не в режиме множественного выбора. Дан­ное действие аналогично выполнению выбора в форме, открытой для выбора в поле ввода или поле табличного поля. Может при­меняться в случае, когда открытие формы выбора или подбора выполнено средствами языка.

Пример:

ОповеститьОВыборе(ТекущаяСтрока);

См. также:

Форма, событие ОбработкаВыбора.

ОповеститьОЗаписиНовогоОбъекта (NotifyWriteNewObject)

Синтаксис:

ОповеститьОЗаписиНовогоОбъекта (< Объект>)

Параметры:

<Объект>     Обязательный

Тип: Любая ссылка на объект ИБ. Добавленный объект.

Описание:

Оповещает владельца формы о записи нового объекта и передает ему ссылку на этот объект. Может быть использован, если добав­ление нового объекта при помощи подчиненной формы необхо­димо обработать в форме владельце.



Пример:

ОповеститьОЗаписиНовогоОбъекта (ДобавленнаяСтрока) ;

См. также:

Форма, событие ОбработкаЗаписиНовогоОбъекта.

ОтключитьОбработчикИзмененияДанных (DetachChangeDataHandler)

Синтаксис:

ОтключитьОбработчикИзмененияДанных(< Имя данных> )

Параметры:

<Имя данных>    Обязательный

Тип: Строка. Имя данных (путь к данным), изменения которых отслеживаются обработчиком. Могут быть указаны данные, свя­занные с реквизитами формы, табличными частями, а также под­чиненные данные - реквизиты этих объектов. Например, "Реквизит1.Наименование".

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

Описание:

Отключает процедуру-обработчик, ранее подключенную для вы­зова при изменении указанных данных в форме или подчиненных формах.

Пример:

ОтключитьОбработчикИзмененияДанных("ПолеВвода!");

См. также:

Форма, метод ПодключитьОбработчикИзмененияДанных.

ОтключитьОбработчикОжидания (DetachldleHandler)

Синтаксис:

ОтключитьОбработчикОжидания(< Имя процедуры>)

Параметры:

<Имя процедуры>     Обязательный

Тип: Строка. Имя процедуры, которую необходимо исключить из обработки ожидания.

Описание:

Отключает ранее подключенную процедуру - обработчик ожида­ния.

Пример:

ОтключитьОбработчикОжидания("ПриОжидании") ;

См. также:

Форма, метод ПодключитьОбработчикОжидания.

Открыта (IsOpen)

Синтаксис:

Открыта()

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

Тип: Булево.

Описание:

Определяет, открыта ли данная форма.

Пример:

Если Не Форма.Открыта() Тогда 

    Форма.Открыть();

КонецЕсли;

Открыть (Open)

Синтаксис:

Открыть()

Описание:

Открывает форму и делает ее окно активным.

Пример:

Форма = Справочники.Номенклатура.ПолучитьФормуСписка() ;

Форма.Открыть();

См. также:

Форма, метод ОткрытьМодально.

Форма, метод Закрыть.

ОткрытьМодально (DoModal)

Синтаксис:

ОткрытьМодально (< Таймаут>)

Параметры:

<Таймаут>     Необязательный



Тип: Число. Время показа формы в секундах, по истечении кото­рого  форма  будет   закрыта  с  параметром   закрытия Неопределено.

Значение по умолчанию: Если значение параметра не задано или равно 0, время показа не ограничено.

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

Тип: Произвольный. Команда закрытия формы.

Описание:

Открывает форму в модальном режиме.

Пример:

ФормаСписка = Справочники.Объекты.ПолучитьФормуСписка();

ФормаСписка.ОткрытьМодально() ;

См. также:

Форма, метод Открыть. Форма, метод Закрыть.

ПодключитьОбработчикИзмененияДанных (AttachChangeDataHandler)

Синтаксис:

ПодключитьОбработчикИзмененияДанных(< Имя данных> , <Имя процедуры> , <Отслеживать подчиненные данные>)

Параметры:

<Имя данных>    Обязательный

Тип: Строка. Имя данных (путь к данным), изменения которых необходимо отслеживать. Могут быть указаны данные, связанные с реквизитами формы, табличными частями, а также подчинен­ные данные - реквизиты этих объектов. Например, "Реквизит1.Наименование".

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

<Имя процедуры>     Обязательный

Тип: Строка. Имя процедуры, подключаемой в качестве обра­ботчика изменения данных. Процедура должна иметь один пара­метр, в который при вызове процедуры будет передана строка-путь к измененным данным, по структуре аналогичная параметру Имя данных.

<Отслеживать подчиненные данные>     Необязательный

Тип: Булево. Признак того, что процедуру-обработчик нужно вызывать и при изменении данных, подчиненных заданным в па­раметре Имя данных, Например, при изменении их реквизитов.

Значение по умолчанию: Ложь.

Описание:

Подключает процедуру-обработчик, вызываемую при изменении указанных данных в форме или подчиненных формах.

Пример:

ПодключитьОбработчикИзмененияДанных("ПолеВвода1", "ПриИзменении");

См. также:

Форма, метод ОтключитьОбработчикИзмененияДанных.



ПодключитьОбработчикОжидания (AttachldleHandler)

Синтаксис:

ПодключитьОбработчикОжидания(< Имя процедуры> , <Интервал>)

Параметры:

<Имя процедуры>     Обязательный

Тип: Строка. Имя процедуры, подключаемой в качестве обра­ботчика ожидания.

<Интервал>    Обязательный

Тип: Число. Интервал времени в секундах, по истечению которо­го должна вызываться процедура - обработчик ожидания.

Описание:

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

Пример:

ПодключитьОбработчикОжидания("ПриОжидании", 1) ;

См. также:

Форма, метод ОтключитьОбработчикОжидания.

Глобальный             контекст,             метод ПодключитьОбработчикОжидания.

ПолучитьДействие (GetAction)

Синтаксис:

ПолучитьДействие(<Событие>)

Параметры:

<Событие>    Обязательный

Тип: Строка. Имя события, для которого необходимо получить действие.

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

Тип: Действие.

Описание:

Получает процедуру-обработчик (действие) указанного события формы.

Пример:

ТекущееДействиеПриЗакрытии = ПолучитьДействие("ПриЗакрытии");

См. также:

Действие.

УстановитьДействие (SetAction)

Синтаксис:

УстановитьДействие (<Событие> , <Действие>)

Параметры:

<Событие>    Обязательный

Тип: Строка. Имя события, для которого устанавливается новое действие.

<Действие>    Обязательный

Тип: Действие. Действие, которое будет выполнено при полу­чении от формы указанного события

Описание:

Назначает новую процедуру-обработчик (действие) для указанно­го события формы.

Пример:

ДействиеПриЗакрытииФормы = Новый Действие("ПриЗакрытииФормы");

УстановитьДействие("ПриЗакрытии", ДействиеПриЗакрытииФормы);

См.также:

Форма, метод ПолучитьДействие, Действие.

«««««««««« 1С:Предприятие 8.0 »»»»»»»»»»

Содержание раздела