Set Stretch
ScaleBoxЧто это
Exec-функция класса ScaleBox (виджет). Устанавливает режим масштабирования дочернего содержимого (EStretch). Применяется, когда нужно изменить способ подгонки размера контента под габариты контейнера — например, переключить с равномерного заполнения на растяжение по одной оси.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- Target (ScaleBox Object Reference) — ссылка на ScaleBox, в котором меняется режим
- In Stretch (EStretch) — новое значение режима растяжения (None, Fill, ScaleToFitX, ScaleToFitY, ScaleToFill, UserSpecified)
Выходы (данные):
- нет (void)
Когда используется
В динамических интерфейсах, где пропорции контента должны подстраиваться под контейнер в зависимости от состояния (например, изображение меняет режим с Fill на ScaleToFit при переключении в полноэкранный режим).
Типичные проблемы
- Выбор неподходящего режима EStretch (например, ScaleToFitX вместо ScaleToFill) — контент либо обрезается, либо не заполняет контейнер.
- Вызов на уничтоженном или не добавленном в дерево виджете (ScaleBox не инициализирован) — изменение не вступит в силу, ошибка не возникнет, но визуально ничего не изменится.