JSplitter v2.1.6.2 / v1.5.10.1 [10.08.2018]

Список разделов Аудиоплеер foobar2000 Плагины

Описание: Все о плагинах, компонентах, расширениях

Сообщение #1 LUR » 21.03.2018, 06:06

Плагин представляет собой панель, совмещающую функциональность сплиттера (контейнера для панелей других плагинов) и хоста скриптов JavaScript.

Особенности функционала:

1. Панели добавляются в сплиттер в произвольном порядке, где с ними можно работать как с обычными окнами Windows, а именно: перемещать, изменять их размер, сворачивать, разворачивать, закрывать. Т.е. при работе с плагином foobar2000 превращается в приложение с MDI интерфейсом (Multi Document Interface). Для точного позиционирования панелей предусмотрено отображение координат и их редактирование "на лету" в заголовке окна панели (полезно при дизайне интерфейса сборки). Также имеется возможность настраивать цвета и шрифт заголовка окон панелей.

1.PNG


2. Поддерживается управление размещением панелей в сплиттере через стандартный "размещатель" Columns UI.
3. В основе хоста скриптов лежат JScript Panel / WSH Panel Mod, соответственно имеет все возможности данных панелей + дополнительные расширения API, касающиеся сплиттера.
4. Поддерживается управление панелями в сплиттере из скриптов. Возможно программно перемещать, скрывать, изменять размер панелей.
5. Имеется специальное API для быстрого создания кнопок в корне панели.

Итог: по своей задумке функционала повторяет Mega Panel Splitter, но с приятными дополнениями в виде ручного управления перемещением панелей и простого API для создания кнопок. Ну а еще может кому-то просто понравится использовать foobar2000 в виде MDI приложения, кто знает.

Дисклеймер: Функциональность сплиттера работает ТОЛЬКО в COLUMNS UI. В DUI данный плагин превращается в обычный JScript Panel / WSH Panel Mod.

СКАЧАТЬ JSplitter v2.1.6.2 (Версия, основанная на JScript Panel v2.1.6)
АНГЛИЙСКАЯ ВЕРСИЯ
РУССКАЯ ВЕРСИЯ
ЗЕРКАЛО
АНГЛИЙСКАЯ ВЕРСИЯ
РУССКАЯ ВЕРСИЯ

СКАЧАТЬ JSplitter v1.5.10.1 (Версия, основанная на WSH Panel Mod v1.5.10)
АНГЛИЙСКАЯ ВЕРСИЯ
РУССКАЯ ВЕРСИЯ
ЗЕРКАЛО
АНГЛИЙСКАЯ ВЕРСИЯ
РУССКАЯ ВЕРСИЯ

Краткое руководство
Для добавления панелей в сплиттер можно воспользоваться 2-мя способами:

1. С помощью контекстного меню панели плагина:

2.PNG
2.PNG (7.04 КБ) Просмотров: 5421


2. С помощью стандартного размещателя Columns UI:

4.PNG


3. С помощью списка панелей, вызываемого из окна конфигурации скрипта. Список панелей можно также использовать для добавления, удаления, переупорядочивания панелей, а также изменения их положения и размеров вручную (двойной щелчок по соответствующему полю):

Снимок.PNG


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

3.PNG


ВНИМАНИЕ! Порядок размещения панелей в сплиттере зависит от глубины их визуального расположения. Самое верхнее окно будет последним в списке. Если вы активируете мышкой какую-либо панель, она переместится в конец списка. Учитываете это при использовании функции GetPanelByIndex (см. ниже).

Show caption - включает/отключает отображение обрамления (бордюра) окна панели
Locked - заблокировать панель. С установленной галочкой окно не реагирует на попытки переместить/изменить/закрыть окно.
Show coords - отобразить координаты. В заголовке окна будут отображены координаты окна, которые будут обновляться по мере перемещения/изменения размера окна.
Support pseudo transparency - некоторым окнам необходима поддержка "прозрачности". С включенной опцией плагин будет заменять фон окна панели на содержимое корневого окна плагина. Т.е. например все, что нарисовано в скрипте с помощью on_paint(gr) будет скопировано в окно.

В режиме отображения координат можно вводить необходимые координаты вручную кликнув по нужной координате или изменить название панели:

7.PNG


Настройки внешнего вида окон панелей расположены здесь:

8.png


Show tools menu for panels' caption - включает/отключает меню для заголовка окон панелей.
Move panels with middle button - позволяет перемещать панели при помощи средней кнопки мыши. Полезно когда бордюр окна скрыт (меню Show caption).
Align panels to edges of each other when dragging - выравнивать панели по краям друг друга при перетаскивании окошек. Полезно при построении интерфейса сборки, где панели должны быть расположены плотно друг к другу.
Show scrollbars for out-of-view panels - экспериментальная функция показа полос прокрутки, если панели выходят из зоны видимости. Прокручиваются только панели, содержимое отрисованного окна не меняется и не скроллится.
Hide panels on close - скрывать окна вместо их закрытия. Полезно для временного скрытия панели с помощью кнопки закрытия окна. Вернуть обратно окна можно в размещателе Columns UI сняв галочку Hidden с панели:

6.PNG



Программный интерфейс
Так как API WSH Panel Mod 1.5.10 не менялся, то он доступен как обычно. Документация к плагину прилагается. Плюс к этому доступны следующие дополнения для объекта window:

window.GetPanel(caption) - получить объект для доступа к панели по тексту заголовка. Будет возвращена первая панель, совпавшая по тексту с аргументом. Текст панели указывается в заголовке. По умолчанию он имеет значение имени плагина панели, но его можно изменить как напрямую в заголовке окна (Show coords -> Click in caption text), так и в размещателе Columns UI (Use custom title)
window.GetPanelByIndex(index) - получить объект для доступа к панели по индексу. Вообще порядок изначально тот, в котором добавляются панели, но так же порядок можно увидеть в размещателе Columns UI, там же его и изменить.
window.CreateButton(x, y, images, hover_images) - создать кнопку в сплиттере. Кнопка будет создана в корне окна и будет размещена по координатам (x, y). Также функции передаются изображения для задания внешнего вида кнопки. Собственно от количества изображений images, переданных функции, будет зависеть количество состояний, которые может принимать кнопка. hover_images - изображения кнопки, отображающиеся при наведении курсора мыши. Функция достаточно гибкая для создания различного вида кнопок, например:
var path = fb.FoobarPath + "themes\\lur\\black\\bio.png";
var hpath = fb.FoobarPath + "themes\\lur\\black\\bio_on.png";
var a = window.CreateButton(0, 0, path, hpath); - создает обычную кнопку с картинкой bio.png, которая меняется на bio_on.png при наведении курсора мыши
var b = window.CreateButton(0, 0, [path, hpath], null); - создает чекбокс-кнопку. Обычное состояние - bio.png, нажатое (галочка установлена) - bio_on.png. Обратите внимание, что изображения для наведения курсора отсутствуют. Обычно чекбоксам они и не нужны, но можно их установить при желании.
var c = window.CreateButton(0, 0, [path1, path2, path3], [path1_on, path2_on, path3_on]); - можно создать кнопку с тремя (и более) состояниями. Они будут циклически переключаться при нажатии. Текущее состояние кнопки можно будет получить с помощью свойства кнопки State (см. ниже).
Также можно создать группу радио-кнопок (взаимоисключающих) с помощью следующей функции:
window.RadioButtons(buttons) - создает группу радио-кнопок. Принимает в качестве аргумента массив кнопок. Каждая кнопка должна иметь не менее двух состояний, иначе функция свалится. Пример:
var a = window.CreateButton(0, 0, [path, hpath], null);
var b = window.CreateButton(30, 0, [path, hpath], null);
window.RadioButtons([a, b]);
Теперь при нажатии на одну кнопку (состояние 1), другая будет "отключаться" (переходить в состояние 0) и наоборот.
window.GetButton(id) - получить кнопку по значению ее идентификатора (Button.ID)
window.RemoveButton(button) - удаляет кнопку
window.HandOnButtons - переключает курсор мыши для всех кнопок либо на руку, либо на стрелку. Данное свойство также действует на все создаваемые впоследствии кнопки. У каждой кнопки можно это свойство менять индивидуально (см. ниже).

Объекты, получаемые при помощи функций, указанных выше, имеют следующие свойства и методы:

ПАНЕЛИ (GetPanel, GetPanelByIndex)
Свойства:
(readonly) String Name;
(read, write) String Text;
(read, write) boolean Hidden;
(read, write) boolean Locked;
(read, write) boolean ShowCaption;
(read, write) boolean SupportPseudoTransparency;
(read, write) int X;
(read, write) int Y;
(read, write) int Width;
(read, write) int Height;
(read, write) boolean TopMost;
Методы:
void Show(show = true);
void Move(x, y, width, height, repaintParent = false);

КНОПКИ (CreateButton, GetButton)
Свойства:
(readonly) ushort ID;
(read, write) int X;
(read, write) int Y;
(read, write) int Width;
(read, write) int Height;
(read, write) boolean Hidden;
(read, write) boolean HandOnHover;
(writeonly) Function Click;
(read, write) uint State;
Методы:
void Show(show = true);
void Move(x, y);
void Resize(width, height);

Назначение свойств и методов объектов довольно прозрачно. При назначении ширины или высоты кнопки в ноль, ширина и высота автоматически высчитываются (как и просто при создании кнопки) из максимальной ширины и высоты изображений. Отдельного упоминания заслуживает обработка нажатий кнопок. Она осуществляется 2-мя
путями:

1. При помощи задания свойства Click объекта кнопки:
var a = window.CreateButton(0, 0, [path, hpath], null);
a.Click = function() { do_something(); }

2. При помощи специального callback'a, который вызывается при нажатии ВСЕХ кнопок, созданных с помощью window.CreateButton:
function on_button_click(id) - принимает идентификатор кнопки, который можно получить через свойство кнопки ID.
switch(id) {
case a.ID:
do_something();
break;
}


ПРИМЕЧАНИЕ: В отличие от панелей, существующих вне зависимости от скрипта, кнопки создаются только программно с помощью скрипта и всегда уничтожаются при выгрузке скрипта.


Пример конфигурации
Распаковать в папку с чистым портативным фубаром.
СКАЧАТЬ / ЗЕРКАЛО

Пример от zeremy

История версий
Версия 2.1.6.2 [10.08.2018]
● Исправлена работоспособность конфигурации JSplitter в Columns UI Layout (кнопка Configure)
● Мелкие улучшения Panel list
● Убран раздел статистики JScript Panel из свойств трека

Версия 2.1.6.1 [03.08.2018]
● Порядок размещения панелей в сплиттере теперь привязан к глубине их расположения. Самое верхнее окно - последнее в списке.
● Добавлено свойство TopMost для объекта панели. Установка в true переносит панель на самый верх.
● Теперь изображения на кнопках масштабируются при изменении размера кнопок.
● Исправлено падение обработчика Click для кнопок
● Создано окно управления списком панелей для просмотра их размеров и редактирования всех данных на месте. Доступ: правая кнопка мыши на сплиттере -> Изменить скрипт... -> Панели.

Версия 2.1.6.0 [30.07.2018]
● Версия, основанная на JScrpt Panel 2.1.6

Версия 1.5.10.1 [24.05.2018]
● Слегка уменьшено мерцание при перерисовке панелей

Версия 2.1.4.1 [18.05.2018]
● Исправлена ошибка "Load Scintilla failed."

Версия 2.1.4 [17.05.2018]
● Версия, основанная на JScrpt Panel 2.1.4

Версия 1.0.4 [28.03.2018]
● Исправлено: в Windows XP свойства fb.FoobarPath, fb.ProfilePath возвращали пустую строку.
● Изменение API: теперь window.GetPanel принимает в качестве аргумента текст заголовка панели, window.GetPanelByIndex - индекс панели

Версия 1.0.3 [22.03.2018]
● Исправление ошибок функционала выравнивания панелей

Версия 1.0.2 [22.03.2018]
● Исправление ошибок функционала выравнивания панелей

Версия 1.0.1 [21.03.2018]
● Добавлено выравнивание/прилипание панелей по краям друг друга, а также к границам окна самого плагина при перетаскивании (есть опция в настройках)

Версия 1.0 [20.03.2018]
LUR M
Автор темы, Модератор
Аватара
Возраст: 35
Откуда: Минск
Репутация: 226
С нами: 5 лет 8 месяцев


Сообщение #101 duzzy » 18.05.2018, 02:04

LUR, Спасибо Большое ! :beer:
Сейчас быстро погонял вроде все работает как должно, завтра как освобожусь плотно погоняю.
Спойлер
Изображение Изображение Изображение
duzzy
Бывалый
Репутация: 15
С нами: 3 года 1 месяц

Сообщение #102 Aliado_71 » 18.05.2018, 12:40

После установки JSplitter 2.1.4 при запуске фубара выскакивает ошибка.
Получается ошибка вылезает если установлены компоненты JSplitter 2.1.4 и Jscript_panel 2.1.4 вместе и исчезает если удалить один из компонентов
Вложения
2018-05-18_113602.jpg
2018-05-18_113602.jpg (13.65 КБ) Просмотров: 995
Aliado_71 M
Мастер
Аватара
Откуда: DON.UA
Репутация: 107
С нами: 3 года 5 месяцев

Сообщение #103 marc2003 » 18.05.2018, 14:07

The Scintilla class name needs updating so it doesn't conflict. It currently exists in 2 files as "JScriptScintilla"...

scintilla\win32\ScintillaWin.cxx, line 3152
src\foo_jscript_panel.rc, line 62

Change it to something like "JSplitterScintilla" and compile it again.
marc2003
Новичок
Репутация: 1
С нами: 4 месяца 22 дня

Сообщение #104 LUR » 18.05.2018, 14:08

marc2003, thanx, I know about it, forgot to change.

Добавлено спустя 23 минуты 28 секунд:
Версия 2.1.4.1 [18.05.2018]

● Исправлена ошибка "Load Scintilla failed."
LUR M
Автор темы, Модератор
Аватара
Возраст: 35
Откуда: Минск
Репутация: 226
С нами: 5 лет 8 месяцев

Сообщение #105 MC Web » 18.05.2018, 15:27

LUR, приветствую!
Обратил внимание при использовании Примера конфигурации для этого компонента - во время переключения правых панелей иногда происходит моргание.
На Сборке от LUR (25.11.17) такого "дефекта" нет.
Это издержки JSplitter?
MC Web
Мастер
Аватара
Репутация: 135
С нами: 4 года 11 месяцев

Сообщение #106 LUR » 18.05.2018, 15:34

MC Web писал(а):Это издержки JSplitter?
К сожалению, да. Побороть не смог.
LUR M
Автор темы, Модератор
Аватара
Возраст: 35
Откуда: Минск
Репутация: 226
С нами: 5 лет 8 месяцев

Сообщение #107 LUR » 25.05.2018, 01:59

Версия 1.5.10.1 [24.05.2018]

● Слегка уменьшено мерцание при перерисовке панелей
LUR M
Автор темы, Модератор
Аватара
Возраст: 35
Откуда: Минск
Репутация: 226
С нами: 5 лет 8 месяцев

Сообщение #108 zeremy » 29.05.2018, 22:20

LUR,

Is it possible to add button width and button height to
window.CreateButton ?

Now it only uses fixed image pixel size.
zeremy
Новичок
Репутация: 17
С нами: 2 года 8 месяцев

Сообщение #109 LUR » 29.05.2018, 22:33

zeremy писал(а):Is it possible to add button width and button height

var b = window.CreateButton(x, y, images, hover_images)
b.Width = 100;
b.Height = 100;
LUR M
Автор темы, Модератор
Аватара
Возраст: 35
Откуда: Минск
Репутация: 226
С нами: 5 лет 8 месяцев

Сообщение #110 zeremy » 29.05.2018, 23:05

LUR писал(а):
zeremy писал(а):Is it possible to add button width and button height

var b = window.CreateButton(x, y, images, hover_images)
b.Width = 100;
b.Height = 100;

OK, but button image disappears if b.Width < image pixels
e.g image 48x48
if b.width < 48 the button is not visible

Also no image resizing ...
zeremy
Новичок
Репутация: 17
С нами: 2 года 8 месяцев

Сообщение #111 zeremy » 06.06.2018, 23:32

Sharing a configuration example
https://www.dropbox.com/s/m5dh7pqz81bvuus/js_splitter_sample.rar?dl=0
Распаковать в папку с чистым портативным фубаром.
zeremy
Новичок
Репутация: 17
С нами: 2 года 8 месяцев

Сообщение #112 MC Web » 07.06.2018, 12:51

Спасибо zeremy.

Только по наличию версий компонентов в данном примере надо указать требования: foobar2000 1.4+ и Win7+.

У меня вопрос, наверно к LUR, а данный пример конфигурации не сделать без PSS ?
Насколько я понимаю JSplitter создавался для этого.
MC Web
Мастер
Аватара
Репутация: 135
С нами: 4 года 11 месяцев

Сообщение #113 zeremy » 07.06.2018, 17:02

MC Web,
I should have mentioned the requirements 1.4+ thanks for the clarification

PPS not required, you can do without it, I just used it to create custom window captions . You will have normal window captions if you add the panels normally in JSplitter.
zeremy
Новичок
Репутация: 17
С нами: 2 года 8 месяцев

Сообщение #114 MC Web » 07.06.2018, 18:03

zeremy, новая версия компонента Columns UI v.1.0.0 так же требует Win7+

Изображение
MC Web
Мастер
Аватара
Репутация: 135
С нами: 4 года 11 месяцев

Сообщение #115 Uran79 » 04.07.2018, 15:41

ДОброго.

Такой вопрос:

1).Можно ли редактировать с его помощью уже готовую сборку ?
2). Если не сложно - то сделайте пож-та краткую инструкцию по добавлению кнопки на чистый фубар и/или в готовую сборку.
Uran79
Новичок
Репутация: 0
С нами: 1 месяц 16 дней

Сообщение #116 dimon212909 » 07.07.2018, 13:34

Извиняюсь, что не в тему! Подскажите, можно ли менять цвета в "panel stack splitter"? Имеется ввиду не содержимого находящегося в разделителях, а именно самого разделителя, чтоб он не читал тему винды, а имел собственные настройки цвета?
За ранее благодарю!
dimon212909
Новичок
Репутация: 0
С нами: 2 месяца

Сообщение #117 LUR » 07.07.2018, 14:02

dimon212909, именно что не в тему, эта тема не про pss.
LUR M
Автор темы, Модератор
Аватара
Возраст: 35
Откуда: Минск
Репутация: 226
С нами: 5 лет 8 месяцев

Сообщение #118 zeremy » 16.07.2018, 13:16

LUR

Is it possible to define programmatically which JSplitter window is OnTop?
zeremy
Новичок
Репутация: 17
С нами: 2 года 8 месяцев

Сообщение #119 megane68 » 16.07.2018, 16:07

LUR, не удобно то, что нельзя перетаскивать панель при убранном заголовке. Ещё плохо то, что нельзя задать размер при убранном заголовке.
Кнопка Locked есть, но непонятно на что влияет.
Можно ли реализовать мои хотелки?
megane68 M
Мастер
Репутация: -25
С нами: 9 лет 6 месяцев

Сообщение #120 LUR » 16.07.2018, 16:13

megane68 писал(а):не удобно то, что нельзя перетаскивать панель при убранном заголовке
есть опция в настройках
Снимок.PNG


Добавлено спустя 1 минуту 59 секунд:
megane68 писал(а):Кнопка Locked есть, но непонятно на что влияет.
если панель Locked, то ее нельзя перетащить и сделать поверх других нажатием

Добавлено спустя 4 минуты 1 секунду:
zeremy,
zeremy писал(а):Is it possible to define programmatically which JSplitter window is OnTop?
It's possible. Maybe in next version
LUR M
Автор темы, Модератор
Аватара
Возраст: 35
Откуда: Минск
Репутация: 226
С нами: 5 лет 8 месяцев

Пред.След.

Вернуться в Плагины