Руководство программиста в Photon, страница 7

1. Вам необходимо создать папку, в которой Вы будете хранить шаблоны, поэтому щёлкните на "Add Folder...". Отобразится диалог:

1. Наберите My_templates как имя папки, затем щёлкните на "Add". Диалог закроется, и имя папки отобразится в диалоге "Save template".

2. Дайте имя шабону, такое как "Big green button". Это имя, которое PhAB будет использовать в палитре.

3. Можете при желании создать иконку для шаблона на входе палитры. Щёлкните на "Edit Icon" и затем следуйте инструкциям, данным ранее для редактирования попиксельных карт. Вы можете сделать иконку, выглядящей как виджет.

4. Можете при желании выбрать цвет фона для входа в палитре, щёлкнув в блоке "Color". Вы можете использовать различные фоновые цвета в палитре, чтобы различать виджеты, предназначенные для различных целей (напр., кнопки и текстовые виджеты).

5. Выберите метод изменения размеров. Это определяет, будете ли Вы протаскивать мышь или прямо щёлкать при создании экземпляров Вашего шаблона. Для этой кнопки выберите метод протягивания ("User Define Size by Dragging" на подписи к кнопке).

6. Диалог теперь будет выглядеть таким образом:

Щёлкните на "Done".

Вы только что создали шаблон! Теперь давайте посмотрим, как его использовать.

• Щёлкните на меню "View" и затем выберите "Palettes". Появится каскадное меню Ваших палитр. Заметьте, что оно включает "My_templates", и что Ваш шаблон будет автоматически выбран.

• Щёлкните где-нибудь вне меню, чтобы закрыть его.

• Перейдите к панелям управления и щёлкните на верхнем ярлыке. Всплывающее меню теперь включает "My_templates"; выберите его, чтобы отобразить палитру.

• Щёлкните на иконке Вашей настраиваемой кнопке, создайте её экземпляр и отредактируйте. как показано:

Если пожелаете, можете сохранить, сгенерировать, собрать и запустить на выполнение приложение.

Всегда, когда Вы запустите PhAB, он автоматически загрузит палитру "My_templates". Вы можете использовать вход "Palettes" в меню "View", чтобы отменить это.

Желаете узнать побольше?

Вам теперь известны базовые сведения по редактированию любых ресурсов виджета в PhAB. Для получения более полной информации см. следующие разделы в главе "Редактирование ресурсов и ответных реакций".

Чтобы редактировать:	см. раздел:
Побитовые карты и изображения	Попиксельный редактор
Цвета	Редактор цвета
Флаги	Редактор флагов/опций
Шрифты	Редактор шрифтов
Список текстовых параграфов	Редактор списков
Числа	Редактор чисел или редактор флагов/опций
Одно- и многострочные тексты	Текстовые редакторы

Для получения более полной информации по шаблонам см. раздел "Шаблоны" в главе "Создание виджетов".

Урок 3. Создание меню и панелей меню

Этот урок проведёт Вас шаг за шагом по пути создания меню и панелей меню.

О присоединении ответных реакций

На этом уроке Вы научитесь, как устанавливать связь с ответной реакцией, одним из ключевых компонентов PhAB. Для понимания того, что есть связь с ответной реакцией, давайте начнём с небольшой "фоновой" информации об ответных реакциях виджета.

Почти все виджеты поддерживают разнообразные ответные реакции. Эти ответные реакции позволяют интерфейсу Вашего приложения взаимодействовать с кодом Вашего приложения. Например, давайте скажем, что Вы хотите, чтобы Ваше приложение выполняло действие, когда пользователь щёлкает на кнопочку. В этом случае Вы можете прикрепить функцию ответной реакции к ответной реакции "Activate" кнопки.

В некоторых window-образных приложениях Вы можете прикрепить к ответным реакциям виджетов только функции в виде кодов. Но когда Вы используете PhAB для создания ответной реакции, Вы можете сделать на шаг больше и прикрепить целые окна, диалоги, меню и многое другое. Это та расширенная функциональность, которую мы называем присоединением ответной реакции.

PhAB предоставляет два основных типа присоединения ответной реакции:

• Модульный тип присоединения ответной реакции

Прикрепление модуля приложения (такого, как окно, диалог или меню) к любой ответной реакции виджета. Модуль открывается каждый раз, когда встречается состояние ответной реакции. На этом уроке Вы присоедините модуль меню к ответной реакции кнопки "Arm".

• Кодовый тип присоединения ответной реакции.

Присоединение функции в виде кода к любой ответной реакции виджета. Виджет вызывает функцию всякий раз, когда встречается состояние ответной реакции. Заметьте, что некоторые присоединения ответной реакции кодового типа позволяют Вам автоматически закрыть родительский модуль. На этом уроке Вы присоедините кодовую функцию к ответной реакции пунктов меню.

Об именах экземпляров

Для доступа к виджету из кода Вашего приложения Вы должны прежде всего присвоить виджету имя экземпляра. Поскольку все имена экземпляров виджета находятся в одном глобальном пространстве имён, внутри приложения не может быть двух виджетов, имеющих одно и то же имя экземпляра.

Мы рекомендуем Вам начинать каждое имя экземпляра с префикса модуля. Например, Ваше базовое окно имеет виджет PtButton, который содержит текст "Blue" в качестве метки, Вы можете дать этому виджету имя экземпляра base_blue (а лично я – так и вообще бы Base_Button_Blue. Прим. пер., любящего длинные названия).

 Принятие соглашения по именам для Ваших виджетов сделает проще Вашу работу с большими приложениями.

Создание панели меню

Чтобы научиться привязывать ответные реакции, давайте создадим два функционирующих меню – "File" и "Help" – которые Вы сможете потом включить в ваши собственные приложения.

В PhAB'е меню делаются из двух кусков:

1. кнопки меню, которой Вы щёлкните, чтобы отобразить меню;

2. модуля меню, который содержит пункты меню.

Используя привязывание ответных реакций, Вы свяжете модули меню с кнопками "File" и "Help" на панели меню. Вы также свяжете ответную реакцию кодового типа с пунктом меню "Quit" в модуле меню "File". Эта ответная реакция позволяет пункту "Quit" закрывать приложение.

1. Из меню "File" PhAB выберите пункт "New" для запуска нового приложения. Выберите стиль "Plain Window".

2. Сохраните приложение как tut3 (По информации о сохранении Вашего приложения см. предыдущий урок или раздел "Сохранение приложения" в главе "Работа с приложениями").

3. Выберите из палитры виджетов виджет PtMenuBar, укажите на верхний левый угол панели основного окна, и протащите мышку, чтобы панель меню стала в ширину окна. Панель меню увеличивается и уменьшается при изменении ширины окна и всегда располагается вверху окна. Вы можете видеть это, щёлкнув на панели заголовка окна и изменяя его размеры при перетаскивании одной из его меток-манипуляторов изменения размеров.

 Если Вы случайно щёлкнули на кнопке "Test" на правом конце панели заголовка модуля, окно не будет изменять размеры или принимать новые виджеты. Если это случилось, просто щёлкните ещё раз на кнопку "Test".

После того, как Вы завершите следующее действие, панель меню будет выглядеть таким образом:

1. Разместите виджет PtMenButton на только что созданной Вами панели меню. Кнопка меню автоматически центрируется по вертикали на панели меню.

2. Перейдите на панель управления ресурсами и щёлкните на имени экземпляра виджета сразу после имени класса. Измените имя экземпляра кнопки на base_file:

1. Измените ресурс "Label Text" кнопки на "File".

2. Разместите другой виджет PtMenuButton следом за первым. Измените имя экземпляра на base_help и текст на "Help".

Создание модуля меню "File"

Теперь, когда Вы имеете кнопки меню, Вам необходимо создать модули меню. Давайте начнём с меню "File".

1. Из меню "Application" выберите "Menus", чтобы открыть переключатель модулей. Этот переключатель позволит Вам создать или просмотреть любой тип модуля PhAB.

2. В блоке "Name" наберите filemenu, нажмите <Enter>. Поскольку модуля меню ещё не существует, PhAB спросит Вас, создавать ли модуль. Щёлкните на "Yes".

Вы увидите, что модуль меню появится в Вашей рабочей области и имя модуля в прокручиваемом списке переключателя модулей.

1. Переключатель модулей остаётся на экране, позволяя вам создавать модули дальше. Однако, Вам надо создать пока только одно меню, поэтому щёлкните "Done", чтобы закрыть переключатель.

Добавление пунктов меню

Давайте теперь добавим несколько пунктов меню в меню "File".

 Если Вы щёлкните на другом модуле, модуль меню станет невыбранным, что означает, что Вы не можете с ним работать. Чтобы вновь выбрать модуль меню, щёлкните на его панели заголовка.

1. Щёлкните на ресурсе "Menu Items" на панели управления ресурсами. Вы увидите редактор меню:

Если Вы посмотрите на список пунктов меню, то увидите, что выбран пункт "New". Этот специальный пункт позволяет Вам добавлять пункты в меню.

1. Чтобы добавить Ваш первый пункт меню – который, так уж случилось, тоже будет называться "New" – щёлкните на область "Item Text", затем наберите "New".

2. Теперь присвойте пункту имя экземпляра. В области "Inst Name" наберите file_new.

3. Щёлкните на "Apply", чтобы добавить пункт в меню. Вы увидите имя пункта в списке "Menu Items", предварённое префиксом CMD. Префикс CMD означает, что это командный пункт; то есть пункт, вызывающий ответную реакцию PhAB'а.

4. Повторите вышеприведенные шаги для создания пунктов меню, помеченных "Save" и "Save As". Присвойте этим пунктам имена экземпляров file_save и file_as.

5. До сих пор Вы добавляли пункты меню командного типа. Теперь добавьте пункт типа разделитель. Просто щёлкните на кнопке "Separator" возле верхнего правого угла. Вы увидите список стилей разделителя:

1. Выберите стиль или просто щёлкните на "Apply", чтобы получить принимаемый по умолчанию стиль, каковой является "Etched – In".

2. Теперь давайте добавим пункт "Quit". Щёлкните на кнопке "Command", затем зададим "Quit" в тексте пункта и file_quit как имя экземпляра.

3. Вы завершили работу с модулем меню, так что щёлкните "Done". Модуль отобразит созданные Вами пункты:

1. Вам понадобится аккуратно попридержать этот модуль в сторонке, пока Вы будете работать над своей следующей задачей. Поэтому щёлкните на кнопке минимизации приложения (левая кнопка на правой стороне панели заголовка) или выберите кнопку меню "Work" (верхний левый угол) и выберите "Minimize".

Создание модуля меню "Help"

Используйте то, чему Вы научились при создании модуля меню, выполнив следующее:

1. Создайте Ваш модуль меню "Help" и дайте ему имя helpmenu.

2. В этом модуле разместите один командный пункт, названный "About Demo" и присвойте пункту имя экземпляра help_about. Когда закончите, минимизируйте модуль.

 Если один из модулей Вашего меню кажется "пропавшим" (Вы можете нечаянно закрыть его или поместить его позади другого модуля), его легко вновь сделать видимыми. См. раздел "Нахождение пропавших модулей и иконок" в главе "Работа с модулями".

Присоединение ответных реакций

Давайте вернёмся к кнопкам меню, которые Вы создали раньше, и прикрепим ответные реакции, так что кнопки смогут вызывать всплытие Ваших модулей меню.

Присоединение ответной реакции модульного типа

• Выберите кнопку меню "File", затем переключитесь на панель управления ответными реакциями ("Callbacks). Вы увидите список ответных реакций кнопки "File".