конфигурация окон

Music Way (player) » пользовательская документация » конфигурация окон

Как уже было сказано, вид и количество окон плеера задается в файле(ах) конфигурации окон.

Эти файлы должны находится в директории на которую указывает переменная path секции [WINDOWS] основного конфигурационного файла.

Имя конфигурационного файла определяется как имя окна с расширением .cfg

К сожалению, я не очень знаком с программированием пользовательских интерфейсов (кнопочек и шилдиков) поэтому (пока) никаких украшательств и скинов на окна нацепить нельзя - все описано стандартными кнопками.

любое окно программы имеет свои размеры и положение и, как обещает документация по win api - должно находится поверх всех остальных окон - причем на не занимаемой площади экрана отображается программа которая должна отображаться навигаторе (у меня это всегда программа навигации)

в определенное время может отображаться только одно окно плеера.

Ну что ж, начнем описание.

Первая секция - описывает само окно

[WINDOW]
 x=< x координата верхнего левого угла окна на экране навигатора>
 y=< у координата верхнего левого угла окна на экране навигатора>
 width=<ширина окна>
 height=<высота окна>
 noborder=<no|yes>
 clickandopen=<имя окна, которое будет открыто>

Значение параметров x, y, width и height , я думаю, обяснять не надо.

noborder - если этот параметр установлен в значение no - то при показе окна будут показан, также, стандартная шапка (за которую можно тягать окно по экрану) и рамка окна, yes - окно отобразится без рамки.

clickandopen - если данный параметр установлен то после нажатия любой кнопки - текущее окно закроется, а откроется окно, имя которого указано в данном параметре.

остальные секции управляют отображением различных элементов управления в окне (если какой то секции не будет - то и данный элемент управления не будет отображаться)

Секции разных кнопок

существует довольно большой перечень кнопок параметры которых идентичны

[ИМЯ_УРАВЛЯЮЩЕЙ_КНОПКИ]
    x=< x координата верхнего левого угла кнопки в окне> 
    y=< y координата верхнего левого угла кнопки в окне> 
    width=<ширина>
    height=<высота>
    text=<текст на кнопке>

Предназначения параметров не отличается оригинальностью.

Теперь перечислим все управляющие кнопки, которые можно отобразить таким способом

[PLAY] - проигрывать композицию/остановить проигрывание
[NEXT] - проигрывать следующую композицию
[PREV] - проигрывать предыдущую композицию
[ABNEXT] - проигрывать следующий альбом
[ABPREV] - проигрывать предыдущий альбом
[PLAYRAND] - проигрывать случайную композицию
[EXIT] - завершить работу плеера

Кнопка открытия окна

Чтобы переключится между окнами программы существует кнопка открытия окна. Таких кнопоп в каждом окне может быть не более трех.

[OPENx]
    x=< x координата верхнего левого угла кнопки в окне> 
    y=< y координата верхнего левого угла кнопки в окне> 
    width=<ширина>
    height=<высота>
    text=<текст на кнопке>
    name=<имя окна, которое будет открыто>

В названии секции, вместо мальенькой буквы "x" должна стоять цифра: 0, 1 или 2

Отображение плейлиста

И последний, но самый сложный елемент - это плейлист. Для его описания мне даже придется разместить рисунок.

Плейлист, по сути является файловым навигатором и представляет собой ряд кнопок.

В низу и вверху находятся следующие две кнопки

1 - подняться на директорию выше

2 - показать самую верхнюю директорию коллекции

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

3 - кнопка на которой написано - это файл или директория. Если это директория то нажатие на эту кнопку развернет в плейлисте эту директорию, если это файл - то нажатие на эту кнопку - проигрывание указанного файла

4 - кнопка на которой отображено название директории или файла. Нажатие на эту кнопку будет проигрывать указанную композицию если это файл, и проигрывать директория (как альбом) - если это директория.

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

ну и последние две кнопки - это кнопки прокрутки текущей директории

5 - прокрутка вверх

6 - прокрутка вниз

 

А теперь опишу секцию, которая отвечает за рисование плейлиста

[PLAYLIST]
    x=< x координата верхнего левого угла кнопки в окне> 
    y=< y координата верхнего левого угла кнопки в окне> 
    width=<ширина>
    height=<высота>
    scrollwidth=< ширина кнопок навигации (5 и 6) >
    columns=< количество колонок элементов плейлиста (файлы и директории) >
    rows=< количество рядов элементов плейлиста >

Предназначение параметров ....

Единственное что хочу указать, тот плейлист, что показан на картинке имеет 3 колонки и 5 рядов

Ну собственно, это все. Больше никаких элементов (пока) в плеере не предусмотрено