ФормаКлиентскогоПриложения.ОтображатьКоманднуюПанель

Свойства · ShowCommandBar

Тип: Булево, Неопределено. Признак отображения командных панелей формы: Если свойство имеет значение Ложь, то командные панели (верхняя и нижняя) не отображаются. Иначе: Если предопределенный элемент формы КоманднаяПанель содержит кнопки, НазначениеДействия имеет значение Обычное или Создание, то форма содержит верхнюю командую панель, заполненную этими кнопками. Если предопределенный элемент формы КоманднаяПанель содержит кнопки, связанные с командами, у которых свойство НазначениеДействия имеет значение Завершение, то форма содержит нижнюю командую панель, заполненную этими кнопками. Если группа кнопок содержит элементы, попадающие и в верхнюю, и в нижнюю командные панели, то для нижней командной панели создается новый элемент формы типа ГруппаФормы, который будет содержать элементы для нижней панели.

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

ФормаКлиентскогоПриложения.ОтображатьКоманднуюПанель (ClientApplicationForm.ShowCommandBar)

ФормаКлиентскогоПриложения (ClientApplicationForm)

ОтображатьКоманднуюПанель (ShowCommandBar)

Применяется только в интерфейсе «Версия 8.5»

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

Использование:
Чтение и запись.
Описание:
Тип: Булево, Неопределено.
Признак отображения командных панелей формы:
Если свойство имеет значение Ложь, то командные панели (верхняя и нижняя) не отображаются.

Иначе:
Если предопределенный элемент формы КоманднаяПанель содержит кнопки, НазначениеДействия имеет значение Обычное или Создание, то форма содержит верхнюю командую панель, заполненную этими кнопками.

Если предопределенный элемент формы КоманднаяПанель содержит кнопки, связанные с командами, у которых свойство НазначениеДействия имеет значение Завершение, то форма содержит нижнюю командую панель, заполненную этими кнопками.

Если группа кнопок содержит элементы, попадающие и в верхнюю, и в нижнюю командные панели, то для нижней командной панели создается новый элемент формы типа ГруппаФормы, который будет содержать элементы для нижней панели.

Доступность:

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

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

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

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

Применяется только в интерфейсе «Версия 8.5»

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

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

Разместить расчёт в настоящей командной панели формы

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

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

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

Подготовка

  1. В отдельной учебной базе платформы 8.5.1.1343 создайте внешнюю обработку УчебнаяФорма85 с пустой управляемой основной формой. Используйте тонкий клиент Windows.

  2. В свойствах формы → События назначьте ПриСозданииНаСервере. Вставьте полный модуль урока, включая клиентские и серверные помощники, на уровне модуля.

  3. Не создавайте вручную ЗначениеПримера, ПолеПримера и кнопку: код создаёт их полностью. Каждый урок запускайте в отдельной копии своей формы.

  4. Сохраните свою EPF и откройте её в учебной базе. Собственное количество начинается с 3, цена книги задана в коде как 250; исходный расчёт равен 750.

  5. Связанный реквизит помечен как СохраняемыеДанные для изучения поведения формы. Это признак реквизита формы, а не автоматическая запись книги, файла или документа в базу.

  6. Команда расчёта имеет ИзменяетСохраняемыеДанные = Ложь. Уроки изменяют только свой интерфейс и значения собственной формы, не конфигурацию и не рабочие данные.

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

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

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

&НаКлиенте
Процедура УчебноеДействие(Команда)
    Если ТипЗнч(ЗначениеПримера) <> Тип("Число") Тогда
        ВызватьИсключение "Собственное количество должно быть числом";
    КонецЕсли;
    Если ЗначениеПримера < 1 ИЛИ ЗначениеПримера > 10 ИЛИ ЗначениеПримера <> Цел(ЗначениеПримера) Тогда
        ВызватьИсключение "Для учебного расчёта выберите целое количество от 1 до 10";
    КонецЕсли;
    Цена = 250;
    Сумма = ЗначениеПримера * Цена;
    Сообщить(Сумма >= 250 И Сумма <= 2500);
    Сообщить(Сумма / Цена = ЗначениеПримера);
    Сообщить(СтрШаблон("Собственные книги: %1 × %2 = %3", ЗначениеПримера, Цена, Сумма));
    Сообщить(ЭтаФорма.ОтображатьКоманднуюПанель = Истина);
    Сообщить(ЭтаФорма.ОтображатьКнопкуЗакрытия);
КонецПроцедуры

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

  1. КоманднаяПанель — возвращаемая формацией автоматическая группа. Само readonly-свойство формы не заменяем новым объектом.

  2. Созданную кнопку добавляем с третьим аргументом ЭтаФорма.КоманднаяПанель, поэтому она действительно принадлежит этой панели.

  3. НазначениеДействия.Обычное относится к собственной команде и позволяет разместить её в верхней панели. ПоложениеКоманднойПанели задаётся отдельно.

  4. ОтображатьЗаголовок и ОтображатьКнопкуЗакрытия управляют представлением формы; они не делают количество автоматически сохраняемым документом.

  5. Кнопка панели рассчитывает собственную сумму. После просмотра закройте свою форму штатной кнопкой; никаких записей книги не создаётся.

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

  1. Ожидаются четыре Истина и сумма 750 при исходных 3. Кнопка расчёта должна быть в автоматической панели.

  2. Способ открытия и режим основного окна влияют на видимый заголовок. ОтображатьЗаголовок = Истина не обещает его показ в каждом режиме.

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

Собственная команда связана с настоящей командной панелью, и ограничения заголовка объяснены отдельно.

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

  1. ОтображатьЗаголовок и ОтображатьКнопкуЗакрытия не применяются в интерфейсе Версия8_2.

  2. Наличие кнопки закрытия зависит также от способа открытия формы.

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

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

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

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

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

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