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

Процедуры и функции интерактивной работы


Вопрос (DoQueryBox)

Синтаксис:

Вопрос(<Текст вопроса> , <Режим>, <Таймаут>)

Параметры:

<Текст вопроса> - Обязательный

Тип: Строка. Текст задаваемого вопроса.

<Режим> - Обязательный

Тип: системное перечисление РежимДиалогаВопрос. Задает состав кнопок диалога и возможные варианты ответов.

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

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

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

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

Тип: системное перечисление КодВозвратаДиалога. В зависимости от реакции поль­зователя возвращается одно из значений системного перечисления.



Описание:

Выводит на экран окно вопроса.

Пример:

Режим = РежимДиалогаВопрос.ДаНет;

Ответ = Вопрос("Продолжить выполнение операции?", Режим,0) ;

Если Ответ = КодВозвратаДиалога.Нет Тогда

    Возврат ;

КонецЕсли ;

См. также:

Глобальный контекст, метод Предупреждение.

ОбработкаПрерыванияПользователя

Синтаксис:

ОбработкаПрерыванияПользователя()

Описание:

Метод предназначен для прерывания работы встроенного языка при нажатии пользователем комбинации клавиш Ctrl+Break.

Метод проверяет, была ли нажата пользователем комбинация Ctrl+Break. Если да, то выполнение встроенного языка прекращается и выдается соответствующее сообщение. Рекомендуется использовать в длительных циклических операциях. Метод будет иметь действия, если операция инициирована определенным интерактивным действием пользователя:

- нажатие кнопки на форме;

- выбор пункта меню или кнопки панели инструментов (форме или интерфейса);

- действия инициируемые обработчиками событий "Выбор" элементов управления.

Пример:

// ТабДокФ - элемент управления типа "Табличный документ";

ТабДок = ЭлементФормы.ТабДокФ;

Выборка = Справочник.Номенклатура.Выбрать();

Пока Выборка.Следующий() Цикл




    Если Выборка.ПометкаУдаления Тогда

        Продолжить;

    КонецЕсли;

    Секция = Макет.ПолучитьОбласть("Строка");

    Секция.Параметры.СвойствоТекст = Выборка.Наименование;

    ТабДок.Вывести(Секция);

    ОбработкаПрерыванияПользователя();

КонецЦикла;

Оповестить (Notify)

Синтаксис:

Оповестить(<Имя события> , <Параметр> , <Источник>)

Параметры:

<Имя события> - Необязательный

Тип: Строка. Имя события. Может быть использовано для идентификации сообщений принимающими их формами.

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

Тип: Произвольный. Параметр сообщения. Могут быть переданы любые необходимые данные.

<Источник>_- Необязательный

Тип: Произвольный. Источник события. Например, в качестве источника может быть указана другая форма.

Описание:

Посылает оповещение всем открытым формам. Если для формы задана процедура-обработчик события ОбработкаОповещения, то она будет запущена, в процедуру будут переданы указанные параметры.

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

Пример:

Оповестить("ЗакрытьФорму", ЭтаФорма);

См. также:

Форма, событие ОбработкаОповещения.

ОткрытьЗначение (OpenValue)

Синтаксис:

ОткрытьЗначение (< Значение>)

Параметры:

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

Тип: Произвольный. Значение любого типа, который может быть показан системой в диалоге.

Описание:

Показывает в диалоге переданное значение. Вид диалога зависит от типа переданного значения.

Пример:

Товар =

Справочники.Номенклатура.НайтиПоКоду(КодТовара);

ОткрытьЗначение(Товар);

ОткрытьИндексСправки (OpenHelpIndex)

Синтаксис:

ОткрытьИндексСправки(<Текст для поиска>)

Параметры:

<Текст для поиска> (необязательный)

Тип: Строка. Начальный текст для позиционирования в списке ключевых слов и выражений справки по приложению.

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



Тип: Булево.

Описание:

Открывает окно со списком ключевых слов и выражений (индексом) справки по приложению.

ОткрытьСодержаниеСправки (OpenHelpContent)

Синтаксис:

ОткрытьСодержаниеСправки()

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

Тип: Булево.

Описание:

Открывает окно с содержанием справки по приложению.

ОткрытьСправку (OpenHelp)

Синтаксис:

ОткрытьСправку(<Объект метаданных>)

Параметры:

<Объект метаданных> (необязательный)

Тип: Объект описания метаданного. Объект метаданных, по которому требуется вывести справочную информацию.

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

Тип: Булево.

Описание:

Открывает окно со справочной информацией по объекту метаданных.

Пример:

ОткрытьСправку (Метаданные.Справочник.Контрагенты);

ОчиститьСообщения (ClearMessages)

Синтаксис:

ОчиститьСообщения()

Описание:

Очищает окно сообщений.

Пример:

ОчиститьСообщения();

Предупреждение (DoMessageBox)

Синтаксис:

Предупреждение (< Текст предупреждения> , <Таймаут>}

Параметры:

<Текст предупреждения> - Обязательный

Тип: Строка. Текст предупреждения.

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

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

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

Описание:

Выводит на экран окно предупреждения.

Пример:

Предупреждение("Выберите документ!", 10);

Сигнал (Веер)

Синтаксис:

Сигнал()

Описание:

Воспроизводит звуковой сигнал. Устройство, воспроизводящее звук, а также характер звукового сигнала зависят от программно-аппаратного состава компьютера и звуковых установок ОС.

Пример:

Сигнал() ;

Сообщить (Message)

Синтаксис:

Сообщить(<Текст сообщения>, <Статус>)

Параметры:

<Текст сообщения> - Обязательный

Тип: Строка. Текст сообщения.

<Статус> - Необязательный

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

Значение по умолчанию: Обычное.



Описание:

Выводит текст сообщения в окно сообщений. Если в момент вы­ зова окно сообщений отсутствует, то будет открыто новое окно сообщений. Сообщение, в зависимости от его смысловой нагруз­ки, можно пометить одной из пиктограмм, входящих в предопре­деленный набор.

Пример:

Сообщить("Выбранный товар отсутствует на складе!", СтатусСообщения.Важное) ;

Состояние (Status)

Синтаксис:

Состояние(<Техст сообщения>)

Параметры:

<Текст сообщения> Необязательный

Тип: Строка. Строка, предназначенная для вывода в строку со­стояния.

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

Описание:

Выводит текст в строку состояния.

Пример:

Состояние("Выполняется обновление информационной базы');

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

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