Тип: СочетаниеКлавиш. Содержит сочетание клавиш кнопки. Действие сочетания клавиш приводит к выполнению команды, связанной с данной кнопкой. Если у команды назначено сочетание клавиш и у кнопки, связанной с командой, назначено сочетание клавиш, то для выполнения команды можно выполнить любое из этих сочетаний клавиш.
Полное описание, параметры и ограничения
КнопкаФормы.СочетаниеКлавиш (FormButton.Shortcut)
КнопкаФормы (FormButton)
СочетаниеКлавиш (Shortcut)
Доступен, начиная с версии 8.2.
Использование:
Только чтение.
Описание:
Тип: СочетаниеКлавиш.
Содержит сочетание клавиш кнопки. Действие сочетания клавиш приводит к выполнению команды, связанной с данной кнопкой. Если у команды назначено сочетание клавиш и у кнопки, связанной с командой, назначено сочетание клавиш, то для выполнения команды можно выполнить любое из этих сочетаний клавиш.
Доступность:
Тонкий клиент, веб-клиент, сервер, толстый клиент.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Назначить сочетание клавиш команде, не писать в readonly-свойство кнопки
У команды СочетаниеКлавиш доступно для записи, у кнопки оно только для чтения. Выбираем учебное Ctrl+Shift+Space и проверяем поля объекта сочетания.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
В учебной базе: Файл → Новый → Внешняя обработка. Создайте управляемую форму и назначьте её основной. Дайте обработке имя УчебнаяТаблица.
Не добавляйте вручную реквизит Товары и одноимённые элементы: код создаст их при открытии. Модуль формы для этой задачи должен быть пустым.
В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Сохраните отдельную учебную EPF и откройте через Файл → Открыть.
Данные Книга/Ручка создаются в памяти формы. Справочники, документы и регистры вашей конфигурации не читаются и не записываются.
Кнопка и команда УчебноеДействие создаются программно. Не добавляйте их вручную: имена должны оставаться уникальными.
Проверяйте в установленной платформе 8.5.1.1343. Карточки и современное оформление дополнительно зависят от интерфейса, темы и режима совместимости; свойства не являются доказательством одинакового вида во всех клиентах.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
НовыеРеквизиты = Новый Массив;
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Товары", Новый ОписаниеТипов("ТаблицаЗначений")));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Код", Новый ОписаниеТипов("Строка"), "Товары", "Код"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Наименование", Новый ОписаниеТипов("Строка"), "Товары", "Название"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)), "Товары", "Количество"));
ЭтаФорма.ИзменитьРеквизиты(НовыеРеквизиты);
Данные = Новый ТаблицаЗначений;
Данные.Колонки.Добавить("Код", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Наименование", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)));
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "A-01";
СтрокаТовара.Наименование = "Книга";
СтрокаТовара.Количество = 3;
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "B-02";
СтрокаТовара.Наименование = "Ручка";
СтрокаТовара.Количество = 1;
ЭтаФорма.ЗначениеВРеквизитФормы(Данные, "Товары");
Таблица = ЭтаФорма.Элементы.Добавить("ТаблицаТоваров", Тип("ТаблицаФормы"));
Таблица.ПутьКДанным = "Товары";
Таблица.Заголовок = "Учебные товары";
Таблица.Шапка = Истина;
Таблица.АвтоВводНезаполненного = Ложь;
Таблица.АвтоВводНовойСтроки = Ложь;
Для Каждого ИмяКолонки Из СтрРазделить("Код,Наименование,Количество", ",") Цикл
Колонка = Элементы.Добавить("Товары" + ИмяКолонки, Тип("ПолеФормы"), Таблица);
Колонка.Вид = ВидПоляФормы.ПолеВвода;
Колонка.ПутьКДанным = "Товары." + ИмяКолонки;
Колонка.Заголовок = ИмяКолонки;
КонецЦикла;
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Проверить учебное количество";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
КомандаДействия.СочетаниеКлавиш = Новый СочетаниеКлавиш(Клавиша.Space, Ложь, Истина, Истина);
Сочетание = КомандаДействия.СочетаниеКлавиш;
Сообщить(Сочетание.Клавиша = Клавиша.Space);
Сообщить(Сочетание.Ctrl);
Сообщить(Сочетание.Shift);
Сообщить(Не Сочетание.Alt);
Сообщить("Сочетание самой кнопки: " + Строка(Кнопка.СочетаниеКлавиш));
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
Сообщить(СтрШаблон("Учебных строк: %1; общее количество: %2",
ЭтаФорма.Товары.Количество(), ЭтаФорма.Товары.Итог("Количество")));
КонецПроцедуры
Разбор по шагам
Конструктор принимает основную клавишу, Alt, Control и Shift именно в этом порядке.
Сочетание назначаем команде; одноимённое свойство кнопки не присваиваем.
Проверяем состав сочетания по типизированным полям, не по строковому представлению.
В клиенте проверяйте конфликты с платформой, ОС и браузером; щелчок кнопкой остаётся альтернативой.
Как проверить результат
Четыре сравнения Истина: Space, Ctrl, Shift и отсутствие Alt.
Если сочетание не перехвачено окружением, оно выполняет команду 2/4; иначе назначьте другое свободное сочетание в учебной копии.
Ожидаемый результат
Настроено собственное сочетание команды с соблюдением режима доступа свойств.
На что обратить внимание
Не назначайте глобально важные системные сочетания на опасные действия.
Сочетание кнопки не обязательно копирует сочетание команды; это разные точки назначения.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Разделить имя кнопки, имя команды и активацию по умолчанию
Одна кнопка связана с командой, которая только показывает количество двух собственных товаров. Настройки клавиатурного обхода не меняют данные.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
В учебной базе: Файл → Новый → Внешняя обработка. Создайте управляемую форму и назначьте её основной. Дайте обработке имя УчебнаяТаблица.
Не добавляйте вручную реквизит Товары и одноимённые элементы: код создаст их при открытии. Модуль формы для этой задачи должен быть пустым.
В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Сохраните отдельную учебную EPF и откройте через Файл → Открыть.
Данные Книга/Ручка создаются в памяти формы. Справочники, документы и регистры вашей конфигурации не читаются и не записываются.
Кнопка и команда УчебноеДействие создаются программно. Не добавляйте их вручную: имена должны оставаться уникальными.
Проверяйте в установленной платформе 8.5.1.1343. Карточки и современное оформление дополнительно зависят от интерфейса, темы и режима совместимости; свойства не являются доказательством одинакового вида во всех клиентах.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
НовыеРеквизиты = Новый Массив;
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Товары", Новый ОписаниеТипов("ТаблицаЗначений")));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Код", Новый ОписаниеТипов("Строка"), "Товары", "Код"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Наименование", Новый ОписаниеТипов("Строка"), "Товары", "Название"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)), "Товары", "Количество"));
ЭтаФорма.ИзменитьРеквизиты(НовыеРеквизиты);
Данные = Новый ТаблицаЗначений;
Данные.Колонки.Добавить("Код", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Наименование", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)));
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "A-01";
СтрокаТовара.Наименование = "Книга";
СтрокаТовара.Количество = 3;
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "B-02";
СтрокаТовара.Наименование = "Ручка";
СтрокаТовара.Количество = 1;
ЭтаФорма.ЗначениеВРеквизитФормы(Данные, "Товары");
Таблица = ЭтаФорма.Элементы.Добавить("ТаблицаТоваров", Тип("ТаблицаФормы"));
Таблица.ПутьКДанным = "Товары";
Таблица.Заголовок = "Учебные товары";
Таблица.Шапка = Истина;
Таблица.АвтоВводНезаполненного = Ложь;
Таблица.АвтоВводНовойСтроки = Ложь;
Для Каждого ИмяКолонки Из СтрРазделить("Код,Наименование,Количество", ",") Цикл
Колонка = Элементы.Добавить("Товары" + ИмяКолонки, Тип("ПолеФормы"), Таблица);
Колонка.Вид = ВидПоляФормы.ПолеВвода;
Колонка.ПутьКДанным = "Товары." + ИмяКолонки;
Колонка.Заголовок = ИмяКолонки;
КонецЦикла;
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Проверить учебное количество";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
Кнопка.Вид = ВидКнопкиФормы.ОбычнаяКнопка;
Кнопка.КнопкаПоУмолчанию = Истина;
Кнопка.АктивизироватьПоУмолчанию = Истина;
Кнопка.ПропускатьПриВводе = Ложь;
Сообщить(Кнопка.Имя = "КнопкаУчебноеДействие");
Сообщить(Кнопка.ИмяКоманды = "УчебноеДействие");
Сообщить(Кнопка.Родитель = ЭтаФорма);
Сообщить(Кнопка.КнопкаПоУмолчанию);
Сообщить("Сочетание кнопки: " + Строка(Кнопка.СочетаниеКлавиш));
Сообщить("Недоступность сервера: " + Строка(Кнопка.ПоведениеПриНедоступностиОсновногоСервера));
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
Сообщить(СтрШаблон("Учебных строк: %1; общее количество: %2",
ЭтаФорма.Товары.Количество(), ЭтаФорма.Товары.Итог("Количество")));
КонецПроцедуры
Разбор по шагам
Имя кнопки уникально среди элементов, ИмяКоманды указывает обработчик через объект команды.
КнопкаПоУмолчанию и АктивизироватьПоУмолчанию решают разные задачи: действие по умолчанию и начальную активность.
ПропускатьПриВводе = Ложь оставляет кнопку в обходе клавиатурой.
Родитель, СочетаниеКлавиш кнопки и поведение при недоступности сервера только читаем.
Как проверить результат
Четыре сравнения при создании Истина: имена, родитель-форма и кнопка по умолчанию.
Нажатие кнопки выводит 2 строки и количество 4; действие клавиатуры дополнительно проверьте в своём клиенте.
Ожидаемый результат
Создана рабочая учебная команда с понятной связью кнопки и обработчика.
На что обратить внимание
Свойство Имя кнопки только для чтения: для переименования нельзя просто присвоить строку.
Кнопка по умолчанию не означает автоматический запуск при открытии формы.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.