Модуль ОбщийДиалог предназначен для работы с элементом управления операционной системы который служит для работы с файлами, системными цветами, принтерами и шрифтами.
С помощью модуля ОбщийДиалог можно указать имя открываемого файла, а выбор осуществлять по заданной маске, например, по типу файла. Также с помощью этого модуля можно выбрать определенный цвет.
Для работы с модулем ОбщийДиалог его сначала нужно объявить:
Диалог Это Модуль ("ОбщийДиалог").
Для примера создадим окно с четырьмя кнопками и текстовым окном для демонстрации работы этого модуля.
Вот так выглядит наше окно в начале:
Событие происходящее при нажатии на первую кнопку будет выглядеть так:
Действие Кнопка1_Щелк().
Диалог:Создать("Окно1").
Диалог:Заголовок("Выберите программу").
Диалог:Фильтр("Файлы ПРОФТ|*.v").
Если Диалог:Открыть=Да.
Текст1:Текст("Вы выбрали файл " & Диалог:ИмяФайла).
КонецЕсли.
КонецДействия.
При нажатии на первую кнопку будет выведено окно с предложением выбрать файл с расширением v:
Далее опишем что должно происходить когда пользователь нажмет вторую кнопку:
Действие Кнопка2_Щелк().
Диалог:Создать("Окно1").
Диалог:Заголовок("Выберите цвет шрифта текста").
Диалог:ВыбратьЦвет.
Текст1:ЦветФона(Диалог:Цвет).
КонецДействия.
При нажатии на вторую кнопку будет предложено выбрать цвет:
Таким образом, у нас в итоге должно получиться примерно вот такое окно:
Полностью этот пример Вы можете найти в папке Примеры.
Действия модуля ОбщийДиалог
ВыбратьПринтер
Синтаксис:
[ИДОбщегоДиалога]:ВыбратьПринтер.
ИД = [ИДОбщегоДиалога]:ВыбратьПринтер.
Описание:
Действие открывает диалоговое окно для выбора принтера. Если принтер выбран, то действие возвращает значение Истина, если пользователь выбрал Отмена, то действие возвращает Ложь.
ВыбратьЦвет
Синтаксис:
[ИДОбщегоДиалога]:ВыбратьЦвет.
ИД = [ИДОбщегоДиалога]:ВыбратьЦвет.
Описание:
Действие открывает диалоговое окно для выбора цвета. Если цвет выбран, то действие возвращает значение Истина, если пользователь выбрал Отмена, то действие возвращает Ложь. Получить выбранный цвет можно с помощью действия Цвет (см. ниже). Пример:
ОД Это Модуль ("ОбщийДиалог").
Окно1 Это Модуль ("Окно").
Действие Начало( ).
ОД:Создать("Окно1").
Окно1:Показать.
КонецДействия.
Действие Окно1_Щелк( ).
ОД:ВыбратьЦвет.
Окно1:ЦветФона(ОД:Цвет).
КонецДействия.
Действие Окно1_ПриЗакрытии().
Конец.
КонецДействия.
ВыбратьШрифт
Синтаксис:
[ИДОбщегоДиалога]:ВыбратьШрифт.
ИД = [ИДОбщегоДиалога]:ВыбратьШрифт.
Описание:
Действие открывает диалоговое окно для выбора шрифта. Если шрифт выбран, то действие возвращает значение Истина, если пользователь выбрал Отмена, то действие возвращает Ложь.
Заголовок
Синтаксис:
[ИДОбщегоДиалога]:Заголовок(ТекстЗаголовка).
ИД = [ИДОбщегоДиалога]:Заголовок.
Описание:
Действие задает или возвращает заголовок диалога. Доступно только при открытии его при открытии и сохранении файлов.
ИмяФайла
Синтаксис:
Значений не принимает.
ИД = [ИДОбщегоДиалога]:ИмяФайла.
Описание:
Действие возвращает имя файла выбранного после открытия диалога в режиме открытия или сохранения.
Открыть
Синтаксис:
[ИДОбщегоДиалога]:Открыть.
ИД = [ИДОбщегоДиалога]:Открыть.
Описание:
Действие открывает диалог в режиме открытия файлов. Если файл выбран, то действие возвращает значение Истина, если пользователь выбрал Отмена, то действие возвращает Ложь.
ПолныйПуть
Синтаксис:
Значений не принимает.
ИД = [ИДОбщегоДиалога]:ПолныйПуть.
Описание:
Действие возвращает путь к файлу выбранного после открытия диалога в режиме открытия или сохранения. Путь включает также и имя файла.
Пример.
ОД Это Модуль ("ОбщийДиалог").
Окно1 Это Модуль ("Окно").
Действие Начало( ).
ОД:Создать("Окно1").
Окно1:Показать.
КонецДействия.
Действие Окно1_Щелк( ).
ОД:Заголовок("Выберите файл:").
ОД:Сохранить.
Сообщить("Вы выбрали файл " & ОД:ПолныйПуть;48;"").
КонецДействия.
Действие Окно1_ПриЗакрытии().
Конец.
КонецДействия.
ПутьПоУмолчанию
Синтаксис:
[ИДОбщегоДиалога]:ПутьПоУмолчанию(Путь).
ИД = [ИДОбщегоДиалога]:ПутьПоУмолчанию.
Описание:
Действие задает или возвращает место в файловой системе, которое будет открываться при запуске диалога в режиме открытия или сохранения файлов.
Создать
Синтаксис:
[ИДОбщегоДиалога]:Создать("ИДОкна").
Значений не возвращает.
Описание:
Действие создает элемент типа ОбщийДиалог на окне заданном его идентификатором. Идентификатор окна должен быть заключен в кавычки как строковая константа. Каждый элемент ОбщийДиалог обязательно должен быть привязан к одному из окон.
Сохранить
Синтаксис:
[ИДОбщегоДиалога]:Сохранить.
ИД = [ИДОбщегоДиалога]:Сохранить.
Описание:
Действие открывает диалог в режиме сохранения файлов. Если имя файла введено в поле 'Имя файла', то действие возвращает значение Истина, если пользователь выбрал Отмена, то действие возвращает Ложь.
Фильтр
Синтаксис:
[ИДОбщегоДиалога]:Фильтр(СтрокаФильтра).
ИД = [ИДОбщегоДиалога]:Фильтр.
Описание:
Действие задает строку фильтра в элементе типа ОбщийДиалог. Строка фильтра должна иметь следующий вид: "Название отбора #1|Маска отбора #1|Название отбора #2|Маска отбора #2" Например, если необходимо отобрать или рисунки или текстовые файлы, то строка фильра будет иметь следующий вид: "Рисунки в формате BMP|*.bmp|Текстовые файлы|*.txt" После открытия диалога с такой установленной строкой фильтра, в списке Тип файла будет две строки: Рисунки в формате BMP Текстовые файлы При выборе соответствующей строки будет выполняться соответствующий отбор.
Цвет
Синтаксис:
Значений не принимает.
ИД = [ИДОбщегоДиалога]:Цвет.
Описание:
Действие возвращает цвет выбранный в диалоге.