Версия: 1.1
Перечень операторов платформы QSP для работы с экраном основного описания ограничен очисткой, выводом и получением всего содержимого. Данный модуль расширяет этот функционал, добавляя возможность (в html-режиме) манипулировать отдельными областями экрана, не затрагивая остальные.
Для реализации возможностей модуля выводимый на экран текст (или html-код) необходимо разбить на области с помощью тега <region id="ID">…</region>, например:
<region id="title">Заголовок</region> / <region id="text">Текст</region>
где ID — уникальный идентификатор области. После этого с помощью операторов модуля к этим областям можно обращаться по отдельности: получать и изменять их содержимое.
Пока существует только версия модуля с русскоязычными командами.
| otg_lib_screen.qsp | Сам модуль. |
| example_screen.qsp | Пример работы с модулем. |
| otg_lib_screen_help.html | Документация по работе с модулем (вы как раз её читаете) |
Первым делом необходимо подключить к своему проекту сам модуль. Для этого файл модуля нужно скопировать в тот же каталог, в котором находится основной проект, после чего в начало кода проекта добавить команду "ADDQST" (для QSP версии 5.7.0):
ADDQST 'otg_lib_screen.qsp'
Все локации модуля начинаются с префикса "Экран.", а переменные — с префикса "otg_", поэтому пересечения с данными основного проекта быть не должно.
| Экран.Получить | Получает содержимое указанной области. |
| Экран.Установить | Устанавливает содержимое указанной области. |
| Экран.Добавить | Добавляет текст в конец содержимого указанной области. |
| Экран.Вставить | Добавляет текст в начало содержимого указанной области. |
Получает содержимое указанной области.
Синтаксис:
func('Экран.Получить', <Имя области>, <Текст>)
Параметры:
| Имя области | Обязательный параметр. Строка с уникальным строковым идентификатором области. |
| Текст | Необязательный параметр. Текст, в котором нужно искать указанную область. Если параметр не указан, то берётся содержимое экрана основного описания. |
Пример:
$Заголовок = func('Экран.Получить', 'title')
Устанавливает содержимое указанной области.
Синтаксис:
GS 'Экран.Установить', <Имя области>, <Устанавливаемый текст>, <Текст>, <Не выводить на экран>
Параметры:
| Имя области | Обязательный параметр. Строка с уникальным строковым идентификатором области. |
| Устанавливаемый текст | Обязательный параметр. Текст, которым необходимо заменить содержимое указанной области. |
| Текст | Необязательный параметр. Текст, в котором нужно искать указанную область. Если параметр не указан, то берётся содержимое экрана основного описания. |
| Не выводить на экран | Необязательный параметр. Если параметр не указан или равен 0, то после изменения содержимого указанной области содержимое экрана будет замещено текстом, в котором содержалась область. |
Пример:
GS 'Экран.Установить', 'title', 'Мрачная поляна'
Добавляет текст в конец содержимого указанной области.
Синтаксис:
GS 'Экран.Добавить', <Имя области>, <Добавляемый текст>, <Текст>, <Не выводить на экран>
Параметры:
| Имя области | Обязательный параметр. Строка с уникальным строковым идентификатором области. |
| Добавляемый текст | Обязательный параметр. Текст, который необходимо добавить в конец содержимого указанной области. |
| Текст | Необязательный параметр. Текст, в котором нужно искать указанную область. Если параметр не указан, то берётся содержимое экрана основного описания. |
| Не выводить на экран | Необязательный параметр. Если параметр не указан или равен 0, то после изменения содержимого указанной области содержимое экрана будет замещено текстом, в котором содержалась область. |
Пример:
GS 'Экран.Добавить', 'text', 'Вы подобрали камень'
Добавляет текст в начало содержимого указанной области.
Синтаксис:
GS 'Экран.Вставить', <Имя области>, <Добавляемый текст>, <Текст>, <Не выводить на экран>
Параметры:
| Имя области | Обязательный параметр. Строка с уникальным строковым идентификатором области. |
| Добавляемый текст | Обязательный параметр. Текст, который необходимо добавить в начало содержимого указанной области. |
| Текст | Необязательный параметр. Текст, в котором нужно искать указанную область. Если параметр не указан, то берётся содержимое экрана основного описания. |
| Не выводить на экран | Необязательный параметр. Если параметр не указан или равен 0, то после изменения содержимого указанной области содержимое экрана будет замещено текстом, в котором содержалась область. |
Пример:
GS 'Экран.Вставить', 'text', 'Вы подобрали камень'
Версия 1.1: