КнопкаФормы.КнопкаПоУмолчанию

Свойства · DefaultButton

Тип: Булево. Указывает, является ли кнопка кнопкой по умолчанию. Истина - является.

Полное описание, параметры и ограничения

КнопкаФормы.КнопкаПоУмолчанию (FormButton.DefaultButton)

КнопкаФормы (FormButton)

КнопкаПоУмолчанию (DefaultButton)

Не применяется в интерфейсе «Версия 8.5»

Доступен, начиная с версии 8.2.

Использование:
Чтение и запись.
Описание:
Тип: Булево.
Указывает, является ли кнопка кнопкой по умолчанию.
Истина - является.
Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

Использование в версии:

Доступен, начиная с версии 8.2.

Использование в интерфейсе:

Не применяется в интерфейсе «Версия 8.5»

Методическая информация

Практические примеры

Разделить имя кнопки, имя команды и активацию по умолчанию

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

Где и как запускать

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

Подготовка

  1. В учебной базе: Файл → Новый → Внешняя обработка. Создайте управляемую форму и назначьте её основной. Дайте обработке имя УчебнаяТаблица.

  2. Не добавляйте вручную реквизит Товары и одноимённые элементы: код создаст их при открытии. Модуль формы для этой задачи должен быть пустым.

  3. В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Сохраните отдельную учебную EPF и откройте через Файл → Открыть.

  4. Данные Книга/Ручка создаются в памяти формы. Справочники, документы и регистры вашей конфигурации не читаются и не записываются.

  5. Кнопка и команда УчебноеДействие создаются программно. Не добавляйте их вручную: имена должны оставаться уникальными.

  6. Проверяйте в установленной платформе 8.5.1.1343. Карточки и современное оформление дополнительно зависят от интерфейса, темы и режима совместимости; свойства не являются доказательством одинакового вида во всех клиентах.


&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    НовыеРеквизиты = Новый Массив;
    НовыеРеквизиты.Добавить(Новый РеквизитФормы("Товары", Новый ОписаниеТипов("ТаблицаЗначений")));
    НовыеРеквизиты.Добавить(Новый РеквизитФормы("Код", Новый ОписаниеТипов("Строка"), "Товары", "Код"));
    НовыеРеквизиты.Добавить(Новый РеквизитФормы("Наименование", Новый ОписаниеТипов("Строка"), "Товары", "Название"));
    НовыеРеквизиты.Добавить(Новый РеквизитФормы("Количество", Новый ОписаниеТипов("Число",
        Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)), "Товары", "Количество"));
    ЭтаФорма.ИзменитьРеквизиты(НовыеРеквизиты);
    Данные = Новый ТаблицаЗначений;
    Данные.Колонки.Добавить("Код", Новый ОписаниеТипов("Строка"));
    Данные.Колонки.Добавить("Наименование", Новый ОписаниеТипов("Строка"));
    Данные.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число",
        Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)));

    СтрокаТовара = Данные.Добавить();
    СтрокаТовара.Код = "A-01";
    СтрокаТовара.Наименование = "Книга";
    СтрокаТовара.Количество = 3;
    СтрокаТовара = Данные.Добавить();
    СтрокаТовара.Код = "B-02";
    СтрокаТовара.Наименование = "Ручка";
    СтрокаТовара.Количество = 1;

    ЭтаФорма.ЗначениеВРеквизитФормы(Данные, "Товары");
    Таблица = ЭтаФорма.Элементы.Добавить("ТаблицаТоваров", Тип("ТаблицаФормы"));
    Таблица.ПутьКДанным = "Товары";
    Таблица.Заголовок = "Учебные товары";
    Таблица.Шапка = Истина;
    Таблица.АвтоВводНезаполненного = Ложь;
    Таблица.АвтоВводНовойСтроки = Ложь;
    Для Каждого ИмяКолонки Из СтрРазделить("Код,Наименование,Количество", ",") Цикл
        Колонка = Элементы.Добавить("Товары" + ИмяКолонки, Тип("ПолеФормы"), Таблица);
        Колонка.Вид = ВидПоляФормы.ПолеВвода;
        Колонка.ПутьКДанным = "Товары." + ИмяКолонки;
        Колонка.Заголовок = ИмяКолонки;
    КонецЦикла;
    КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
    КомандаДействия.Действие = "УчебноеДействие";
    КомандаДействия.Заголовок = "Проверить учебное количество";
    КомандаДействия.Подсказка = "Действие только над данными учебной формы";
    КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
    Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
    Кнопка.ИмяКоманды = КомандаДействия.Имя;
    Кнопка.Заголовок = КомандаДействия.Заголовок;
    Кнопка.Вид = ВидКнопкиФормы.ОбычнаяКнопка;
    Кнопка.КнопкаПоУмолчанию = Истина;
    Кнопка.АктивизироватьПоУмолчанию = Истина;
    Кнопка.ПропускатьПриВводе = Ложь;
    Сообщить(Кнопка.Имя = "КнопкаУчебноеДействие");
    Сообщить(Кнопка.ИмяКоманды = "УчебноеДействие");
    Сообщить(Кнопка.Родитель = ЭтаФорма);
    Сообщить(Кнопка.КнопкаПоУмолчанию);
    Сообщить("Сочетание кнопки: " + Строка(Кнопка.СочетаниеКлавиш));
    Сообщить("Недоступность сервера: " + Строка(Кнопка.ПоведениеПриНедоступностиОсновногоСервера));
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
    Сообщить(СтрШаблон("Учебных строк: %1; общее количество: %2",
        ЭтаФорма.Товары.Количество(), ЭтаФорма.Товары.Итог("Количество")));
КонецПроцедуры

Разбор по шагам

  1. Имя кнопки уникально среди элементов, ИмяКоманды указывает обработчик через объект команды.

  2. КнопкаПоУмолчанию и АктивизироватьПоУмолчанию решают разные задачи: действие по умолчанию и начальную активность.

  3. ПропускатьПриВводе = Ложь оставляет кнопку в обходе клавиатурой.

  4. Родитель, СочетаниеКлавиш кнопки и поведение при недоступности сервера только читаем.

Как проверить результат

  1. Четыре сравнения при создании Истина: имена, родитель-форма и кнопка по умолчанию.

  2. Нажатие кнопки выводит 2 строки и количество 4; действие клавиатуры дополнительно проверьте в своём клиенте.

Ожидаемый результат

Создана рабочая учебная команда с понятной связью кнопки и обработчика.

На что обратить внимание

  1. Свойство Имя кнопки только для чтения: для переименования нельзя просто присвоить строку.

  2. Кнопка по умолчанию не означает автоматический запуск при открытии формы.

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

Подготовить свою форму для тестов без рабочих данных

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

Где и как запускать

Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.

Подготовка

  1. Только собственная пустая конфигурация УчебнаяКонфигурацияСинтаксиса. Для первого урока создайте новую внешнюю обработку УчебныйИнтерфейсТестирования с пустой основной управляемой формой Форма.

  2. Запустите два отдельных тонких клиента собственной учебной базы: тестируемый с /TESTCLIENT -TPort15380, менеджер с /TESTMANAGER. Порт 15380 — собственный учебный; убедитесь, что на нём не работает другой клиент. Не подключайте менеджер к рабочей базе/чужому приложению.

  3. В fixture назначьте событие ПриСозданииНаСервере одноимённому обработчику и вставьте весь модуль первого урока. Элементы и реквизиты вручную не создавайте. Откройте эту обработку в /TESTCLIENT.

  4. Каждый следующий урок — полный отдельный модуль формы другой обработки менеджера /TESTMANAGER с командой ВыполнитьПример. Перед каждым тестом заново откройте fixture; не выполняйте тест на изменённом состоянии предыдущего урока.

  5. Исходно первое поле Книга, второе Ручка, статус Готово, выбор book/Книга. Любые кнопки/ссылки действуют только на этой памяти формы; нет записи базы и внешних URL.

  6. Это код штатного механизма тестирования 1С, не браузерная проверка HTML. В данном окружении выполнение UI-тестов в настоящей 1С не подтверждено.

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    ЭтаФорма.АвтоЗаголовок = Ложь;
    ЭтаФорма.Заголовок = "Учебная форма guide-owned-form-2026";
    Новые = Новый Массив;
    Для Каждого ИмяРеквизита Из СтрРазделить("Первое,Второе,УчебныйСтатус,УчебныйВыбор", ",") Цикл
        Новые.Добавить(Новый РеквизитФормы(ИмяРеквизита, Новый ОписаниеТипов("Строка")));
    КонецЦикла;
    ЭтаФорма.ИзменитьРеквизиты(Новые);
    Первое = "Книга";
    Второе = "Ручка";
    УчебныйСтатус = "Готово";
    УчебныйВыбор = "book";
    Для Каждого ИмяРеквизита Из СтрРазделить("Первое,Второе,УчебныйСтатус,УчебныйВыбор", ",") Цикл
        ИмяПоля = "Поле" + ИмяРеквизита;
        Если ИмяРеквизита = "УчебныйСтатус" Тогда
            ИмяПоля = "ПолеУчебногоСтатуса";
        ИначеЕсли ИмяРеквизита = "УчебныйВыбор" Тогда
            ИмяПоля = "ПолеУчебногоВыбора";
        КонецЕсли;
        Поле = Элементы.Добавить(ИмяПоля, Тип("ПолеФормы"));
        Поле.Вид = ВидПоляФормы.ПолеВвода;
        Поле.ПутьКДанным = ИмяРеквизита;
        Поле.Заголовок = ИмяРеквизита;
    КонецЦикла;
    Элементы.ПолеУчебногоСтатуса.ТолькоПросмотр = Истина;
    Выбор = Элементы.ПолеУчебногоВыбора;
    Выбор.СписокВыбора.Добавить("book", "Книга");
    Выбор.СписокВыбора.Добавить("pen", "Ручка");
    Выбор.РежимВыбораИзСписка = Истина;
    Выбор.РедактированиеТекста = Ложь;
    Выбор.КнопкаСпискаВыбора = Истина;
    Панель = Элементы.Добавить("УчебнаяПанель", Тип("ГруппаФормы"));
    Панель.Вид = ВидГруппыФормы.КоманднаяПанель;
    Для Каждого ИмяКоманды Из СтрРазделить("УчебноеМеню,УчебноеЗакрытие", ",") Цикл
        КомандаФормы = ЭтаФорма.Команды.Добавить(ИмяКоманды);
        КомандаФормы.Действие = ИмяКоманды;
        КомандаФормы.Заголовок = ИмяКоманды;
        КомандаФормы.ИзменяетСохраняемыеДанные = Ложь;
        Кнопка = Элементы.Добавить("Кнопка" + ИмяКоманды, Тип("КнопкаФормы"), Панель);
        Кнопка.ИмяКоманды = КомандаФормы.Имя;
        Кнопка.Заголовок = ИмяКоманды;
    КонецЦикла;
    Элементы.КнопкаУчебноеЗакрытие.КнопкаПоУмолчанию = Истина;
    Надпись = Элементы.Добавить("УчебнаяНадпись", Тип("ДекорацияФормы"));
    Надпись.Вид = ВидДекорацииФормы.Надпись;
    Надпись.Заголовок = "Нажать собственную надпись";
    Надпись.Гиперссылка = Истина;
    Надпись.Подсказка = "Меняет только собственный учебный статус";
    Надпись.УстановитьДействие("Нажатие", "УчебнаяНадписьНажатие");
    Форматированная = Элементы.Добавить("УчебнаяФорматированнаяНадпись", Тип("ДекорацияФормы"));
    Форматированная.Вид = ВидДекорацииФормы.Надпись;
    Форматированная.Гиперссылка = Ложь;
    Форматированная.Заголовок = Новый ФорматированнаяСтрока("Открыть учебное пояснение", , , , "guide-owned-link-001");
    ЭтаФорма.УстановитьДействие("ОбработкаНавигационнойСсылки", "УчебнаяНавигационнаяСсылка");
    ЭтаФорма.Модифицированность = Ложь;
КонецПроцедуры

&НаКлиенте
Процедура УчебноеМеню(Команда)
    Значения = Новый СписокЗначений;
    Значения.Добавить("book", "Книга");
    Значения.Добавить("pen", "Ручка");
    УчебныйСтатус = "Меню открыто";
    ЭтаФорма.ПоказатьВыборИзМеню(Новый ОписаниеОповещения("УчебноеМенюЗавершено", ЭтотОбъект), Значения, Элементы.ПолеПервое);
КонецПроцедуры

&НаКлиенте
Процедура УчебноеМенюЗавершено(ВыбранныйЭлемент, ДополнительныеПараметры) Экспорт
    Если ВыбранныйЭлемент = Неопределено Тогда
        УчебныйСтатус = "Отмена меню";
    Иначе
        Если ТипЗнч(ВыбранныйЭлемент) <> Тип("ЭлементСпискаЗначений") Тогда
            ВызватьИсключение "Результат учебного меню имеет неожиданный тип";
        КонецЕсли;
        Если ВыбранныйЭлемент.Значение <> "book" И ВыбранныйЭлемент.Значение <> "pen" Тогда
            ВызватьИсключение "Получено не учебное значение";
        КонецЕсли;
        УчебныйСтатус = "Меню: " + ВыбранныйЭлемент.Значение;
    КонецЕсли;
    ЭтаФорма.Модифицированность = Ложь;
КонецПроцедуры

&НаКлиенте
Процедура УчебнаяНадписьНажатие()
    УчебныйСтатус = "Надпись нажата";
    ЭтаФорма.Модифицированность = Ложь;
КонецПроцедуры

&НаКлиенте
Процедура УчебнаяНавигационнаяСсылка(НавигационнаяСсылкаФорматированнойСтроки, СтандартнаяОбработка)
    СтандартнаяОбработка = Ложь;
    Если НавигационнаяСсылкаФорматированнойСтроки <> "guide-owned-link-001" Тогда
        ВызватьИсключение "Ссылка не относится к собственному учебному сценарию";
    КонецЕсли;
    УчебныйСтатус = "Учебная ссылка обработана";
    ЭтаФорма.Модифицированность = Ложь;
КонецПроцедуры

&НаКлиенте
Процедура УчебноеЗакрытие(Команда)
    ЭтаФорма.Модифицированность = Ложь;
    ЭтаФорма.Закрыть();
КонецПроцедуры

Разбор по шагам

  1. Сначала проверяется имя собственной пустой конфигурации, затем программно создаются четыре строковых реквизита и элементы.

  2. Кнопка меню вызывает неблокирующий ПоказатьВыборИзМеню; callback имеет ВыбранныйЭлемент, ДополнительныеПараметры и Экспорт.

  3. Обычная надпись использует Нажатие() без параметров. Форматированная надпись имеет Гиперссылка=Ложь, ссылку в пятом параметре конструктора и обработчик навигации на уровне формы.

  4. Событие формы навигации имеет два параметра; СтандартнаяОбработка=Ложь запрещает штатный переход. Отдельное одноимённое событие декорации не назначается.

  5. Кнопка закрытия по умолчанию закрывает только эту память формы. Она не подтверждает запись документа и не завершает клиент.

Как проверить результат

  1. В точной форме четыре поля: Книга, Ручка, Готово, Книга для значения book. Есть две надписи и две собственные кнопки.

  2. После самостоятельного ручного нажатия надписей меняется только статус; сайт или документ не открывается. Перед тестами заново откройте форму.

Ожидаемый результат

Готов полностью заполненный независимый fixture для обучения автоматизации форм.

На что обратить внимание

  1. Не открывайте в рабочей конфигурации и не заменяйте собственные селекторы на первый объект приложения.

  2. Успешное построение модуля статически не является подтверждением UI-теста в 1С.

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

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.