Тип: Строка. Содержит текст закладки страницы.
Полное описание, параметры и ограничения
СтраницаПанели.Заголовок (PanelPage.Caption)
СтраницаПанели (PanelPage)
Заголовок (Caption)
Доступен, начиная с версии 8.0.
Использование:
Чтение и запись.
Описание:
Тип: Строка.
Содержит текст закладки страницы.
Доступность:
Толстый клиент.
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Очистить только отдельную пустую учебную панель
После Очистить коллекция не имеет ноль страниц: платформа оставляет одну новую страницу. Все старые ссылки считаются недействительными.
Где и как запускать
Полный модуль собственной обычной формы. Только толстый клиент с обычными формами. Действие кнопки — экспортная процедура с первым параметром Элемент.
Подготовка
Создайте отдельную внешнюю обработку с обычной формой. Запускайте толстым клиентом в режиме обычных форм, не в рабочей конфигурации.
Создайте отдельную ПУСТУЮ вложенную панель УчебнаяПанель без любых элементов внутри неё. Не используйте панель с надписями из остальных уроков.
Кнопку УчебнаяКоманда разместите ВНЕ этой пустой панели. В редакторе включите распределение по страницам.
Событие ПриОткрытии формы свяжите с процедурой ПриОткрытии. Нажатие кнопки вручную не назначайте: оно связывается с процедурой ВыполнитьУчебнуюКоманду через Действие.
Каждый урок заменяет полный модуль отдельной копии формы. Страницы принадлежат только этой форме; документы и настройки базы не изменяются.
Процедура ПриОткрытии()
Панель = ЭтаФорма.ЭлементыФормы.УчебнаяПанель;
Панель.Страницы.Добавить("УчебнаяДляОчистки", "Удалится при очистке");
Сообщить(Панель.Страницы.Количество());
Кнопка = ЭтаФорма.ЭлементыФормы.УчебнаяКоманда;
Кнопка.Заголовок = "Выполнить учебную проверку";
Кнопка.УстановитьДействие("Нажатие", Новый Действие("ВыполнитьУчебнуюКоманду"));
КонецПроцедуры
Процедура ВыполнитьУчебнуюКоманду(Элемент) Экспорт
Панель = ЭтаФорма.ЭлементыФормы.УчебнаяПанель;
Страницы = Панель.Страницы;
Страницы.Очистить();
Сообщить(Страницы.Количество() = 1);
НоваяСтраница = Страницы.Получить(0);
НоваяСтраница.Имя = "УчебнаяПослеОчистки";
НоваяСтраница.Заголовок = "Новая пустая страница";
НоваяСтраница.Видимость = Истина;
НоваяСтраница.Доступность = Истина;
Панель.ТекущаяСтраница = НоваяСтраница;
Сообщить(Страницы.Найти("УчебнаяДляОчистки") = Неопределено);
Сообщить(Страницы.Найти("УчебнаяПослеОчистки") = НоваяСтраница);
КонецПроцедурыРазбор по шагам
Урок использует другую пустую вложенную панель, а не панель с надписями из первых пяти уроков.
До очистки добавляется своя пустая страница. После очистки остаётся одна новая страница, что прямо проверяется.
Получить(0) вызывается уже после очистки. Старые страницы не сохраняются в переменных и не используются.
Новая страница получает собственное имя, заголовок и становится текущей. Кнопка вне очищаемой панели остаётся.
Как проверить результат
При открытии выводится исходное количество плюс 1; после нажатия три Истина.
Повторное нажатие также оставляет одну новую пустую страницу и работающую внешнюю кнопку.
Ожидаемый результат
Показано особое поведение Очистить: одна новая пустая страница, а не пустая коллекция.
На что обратить внимание
Очистка панели с элементами управления удалит их; этот код предназначен только пустой учебной панели.
Не очищайте главную панель или рабочую форму.
Операция меняет интерфейс текущей копии, а не метаданные сохранённой обработки.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Переключать две страницы и хранить учебные данные страницы
Вкладки Основное и Проверка содержат разные надписи. Кнопка переключает текущую страницу и показывает число, связанное именно с ней.
Где и как запускать
Полный модуль собственной обычной формы. Только толстый клиент с обычными формами. Действие кнопки — экспортная процедура с первым параметром Элемент.
Подготовка
Создайте отдельную внешнюю обработку с обычной формой. Запускайте толстым клиентом в режиме обычных форм, не в рабочей конфигурации.
Разместите отдельную вложенную панель УчебнаяПанель. В редакторе создайте ровно две её страницы с именами Основное и Проверка, включите распределение по страницам и выключите режим прокручиваемых страниц.
На странице Основное разместите надпись «Книга: 3», на странице Проверка — надпись «Сумма: 750». Кнопку УчебнаяКоманда разместите ВНЕ УчебнаяПанель, на основной панели формы.
Событие ПриОткрытии формы свяжите с процедурой ПриОткрытии. Нажатие кнопки вручную не назначайте: оно связывается с процедурой ВыполнитьУчебнуюКоманду через Действие.
Каждый урок заменяет полный модуль отдельной копии формы. Страницы принадлежат только этой форме; документы и настройки базы не изменяются.
Процедура ПриОткрытии()
Панель = ЭтаФорма.ЭлементыФормы.УчебнаяПанель;
Страницы = Панель.Страницы;
Если Страницы.Количество() <> 2 Тогда
ВызватьИсключение "Нужны ровно две собственные страницы";
КонецЕсли;
Основное = Страницы.Найти("Основное");
Проверка = Страницы.Найти("Проверка");
Если Основное = Неопределено Или Проверка = Неопределено Тогда
ВызватьИсключение "Создайте страницы Основное и Проверка";
КонецЕсли;
Панель.РаспределятьПоСтраницам = Истина;
Панель.ОтображениеЗакладок = ОтображениеЗакладок.Сверху;
Основное.Видимость = Истина;
Основное.Доступность = Истина;
Проверка.Видимость = Истина;
Проверка.Доступность = Истина;
Панель.ТекущаяСтраница = Основное;
Основное.Заголовок = "Товар";
Основное.Значение = Новый Структура("Количество", 3);
Проверка.Заголовок = "Расчёт";
Проверка.Значение = Новый Структура("Сумма", 750);
Основное.КартинкаЗаголовка = Новый Картинка;
Проверка.КартинкаЗаголовка = Новый Картинка;
Сообщить(Основное.Имя = "Основное" И Проверка.Имя = "Проверка");
Сообщить(ТипЗнч(ЭтаФорма.Панель) = Тип("Панель"));
Кнопка = ЭтаФорма.ЭлементыФормы.УчебнаяКоманда;
Кнопка.Заголовок = "Выполнить учебную проверку";
Кнопка.УстановитьДействие("Нажатие", Новый Действие("ВыполнитьУчебнуюКоманду"));
КонецПроцедуры
Процедура ВыполнитьУчебнуюКоманду(Элемент) Экспорт
Панель = ЭтаФорма.ЭлементыФормы.УчебнаяПанель;
Страницы = Панель.Страницы;
Основное = Страницы.Найти("Основное");
Проверка = Страницы.Найти("Проверка");
Если Основное = Неопределено Или Проверка = Неопределено Тогда
ВызватьИсключение "Не найдены собственные страницы";
КонецЕсли;
Если Панель.ТекущаяСтраница = Основное Тогда
Панель.ТекущаяСтраница = Проверка;
Сообщить(Проверка.Значение.Сумма);
Иначе
Панель.ТекущаяСтраница = Основное;
Сообщить(Основное.Значение.Количество);
КонецЕсли;
Сообщить(Панель.ТекущаяСтраница.Заголовок);
КонецПроцедурыРазбор по шагам
Найти ищет внутренние имена страниц, не надписи на вкладках; отсутствие проверяется до обращения к свойствам.
Значение — произвольные данные страницы. Здесь это две собственные структуры, не реквизиты документа.
ТекущаяСтраница принимает сам объект страницы. Кнопка переключает его, затем читает данные выбранной страницы.
Пустая Картинка допустима для заголовка. Произвольный PNG в КартинкаЗаголовка не подставляется: программно доступны Пустая или ИзБиблиотеки.
ЭтаФорма.Панель — главная панель. УчебнаяПанель — отдельная вложенная панель; код не очищает главную.
Как проверить результат
При открытии два Истина и видна надпись Книга: 3.
Первое нажатие: 750 и Расчёт, видна Сумма: 750. Второе: 3 и Товар.
Ожидаемый результат
Реальное переключение содержимого вкладок и чтение собственных данных страницы.
На что обратить внимание
Имя и Заголовок не взаимозаменяемы.
Значение страницы не записывает данные автоматически.
Не применяйте учебную очистку к ЭтаФорма.Панель рабочей формы.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.