Инструменты пользователя

Инструменты сайта


products:pussy:concepts:property

Это старая версия документа!


Свойство

FIXME

Свойство - это компонент для хранения типизированных данных, а по факту это класс Python, который предоставляет по запросу элемент графического интерфейса для отображения и редактирования хранимых данных. В составе Плагинов для PUSSY используется для хранения пользовательских настроек внутри Контейнера Свойства, также ничто не мешает использовать их в любых целях. Фреймворк PUSSY предлагает некоторое количество готовых свойств.

Познакомимся с понятиями, которые характеризуют Свойства:

  • Значение – это важные данные, которые Свойство хранить в себе;
  • Параметры – это служебные данные, которые определяют поведение Свойства, по сути являются полями экземпляра класса свойства, их отличительной особенностью является то, что их имя как правило начинается на «p_»;
  • Виджет – этот термин должен быть знаком разработчикам Qt приложений, это элемент графического интерфейса, через который пользователь производит манипуляции со значением.

Если рассуждать в парадигме MVC (Model View Controller (на русском: Модель Представление Контроллер)), то Свойство действует на уровнях модели и представления, тут есть один важный момент: виджет создается при обращении к специальному методу, также чтобы обновить значение Свойства требуется вызвать специальный метод.

property_scheme.jpg

Типы свойств

Как сказано ранее: Свойства это классы Python, которые унаследованы от одного из 2-х базовых классов: с механизмом валидации значения (PropertyValidated) и без (Property).

PropertyValidated реализует механизмы валидации значения, согласно установленным параметрам, валидация происходит автоматически при изменении самого свойства или параметров, от которых он зависит. Приведу простой пример, есть свойство для ввода целых чисел (IntProperty), которое имеет параметры p_minimum, p_maximum, минимальное и максимальное значения соответственно. Если IntProperty имеет значение равное 10, а p_minimum =1, p_maximum = 15, то при изменении p_maximum = 5, значение свойства будет равно 5. Это механизм добавлен для того, чтобы значение свойства никогда не выходило за установленные пределы.

Дополнительную информацию читайте в материалах: Properties

products/pussy/concepts/property.1701102775.txt.gz · Последнее изменение: (внешнее изменение)