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

Большинство модулей включают такие элементы:

• Кнопка рабочего меню

Вызывает рабочее меню модуля

Рабочее меню модуля

Рабочее меню включает

• Minimize – свернуть модуль в иконку

• Print – печатать модуль

• Write Code – генерировать код для модуля

• To Back – перевести этот модуль за другие модули в рабочей области PhAB

• Close – закрыть модуль

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

Test	Переключает в режим тестирования, так что Вы можете провзаимодействовать с виджетами, как будто-бы запущено приложение. Вы можете переключиться в и из режима тестирования с помощью кнопки "Test" на инструментальной панели PhAB (см. раздел "Инструментальные панели" в главе об окружении PhAB) или кнопки "Test" на заголовочной панели модуля.
Title bar (заголовочная панель)	Отображает имя экземпляра модуля. Чтобы перемещать модуль, укажите на эту панель и перетаскивайте курсор.
Collapse buton	Сворачивает модуль просто в заголовочную панель.
Minimize button	Сворачивает модуль в иконку.
Test button (только для определённых модулей)	Аналогична пункту "Test" в рабочем меню, она позволяет Вам переключать модуль в режим тестирования.
Close button	Закрывает модуль

Выбор модуля

Чтобы выбрать модуль, находящийся на рабочей области PhAB:

• Щёлкните на заголовочной панели модуля

или

• если модуль свёрнут в иконку, дважды щёлкните по его иконке

или

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

Какой бы метод Вы ни избрали, Вы увидите элементы управления размером – признак того, что модуль выбран.

Чтобы узнать, как открывается модуль, который не находится в рабочей области PhAB, см. раздел "Открытие модуля" в этой главе.

Как сохраняются модули

Когда Вы сохраняете Ваше приложение, PhAB сохраняет все модули приложения как файлы в директории приложения wgt. Каждый модуль сохраняется в своём собственном файле с расширением файла, основанном на типе модуля. Позже, когда Вы делаете "make" для своего приложения, PhAB связывает все модули в исполняемый бинарный файл. Это делает приложение одной автономной программой, которую Вы можете легко распространять.

Для получения более полной информации см. раздел "Как организованы файлы приложения" в главе "Генерирование, компилирование и запуск программы на исполнение".

Изменение ресурсов модуля

Когда Вы выбираете модуль в PhAB, панель управления ресурсами изменяется, отображая список ресурсов виджета, доступных для этого класса модулей. В зависимости от того, какой ресурс Вы изменяете, Вы можете не увидеть немедленного эффекта. Все сделанные изменения возымеют, однако, эффект при запуске приложения.

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

Использование селектора модулей

Когда Вы используете меню "Application" для создания или просмотра модуля PhAB любого типа (окна, диалога, меню, прочая), PhAB отображает диалог селектора модулей:

Рис. 4-1. Диалог селектора модулей

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

Создание нового модуля

Чтобы создать любой новый модуль, следуйте этим простым шагам:

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

2. В области "Name" наберите имя экземпляра объекта для нового модуля, затем нажмите <Enter> или щёлкните на "Open".

 Имя модуля не должно быть более чем в 48 символов и должно быть применимо к идентификаторам языка С. Если Вы создаёте модуль иконки к основному окну Вашего приложения, Вы должны присвоить модулю иконки имя. Это то имя, которое приложение может использовать для получения иконки.

1. Для модулей окна и диалога PhAB предлагает Вам выбрать стиль из диалога, отображающего возможные варианты выбора.

Для других типов модулей PhAB просто спрашивает, создавать или нет новый модуль. Нажмите <Enter> или щёлкните "Yes". Вы увидите новый модуль в рабочей области PhAB.

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

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

Просмотр модулей

Чтобы просто просмотреть любой модуль:

1. В меню "Application" выберите тип модуля, который Вы хотите увидеть. Вы увидите селекор модуля.

2. Щёлкните на имени модуля в скроллируемом списке модулей.

Открытие модулей

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

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

2. Выполните следующее:

• дважды щёлкните на имени модуля

или

• щёлкните на имени модуля, затем нажмите <Enter> или щёлкните на "Open"

или

• наберите имя модуля, затем нажмите <Enter> или щёлкните на "Open".

Удаление модуля

Чтобы удалить модуль:

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

2. Щёлкните на имени модуля.

3. Щёлкните на кнопке "Delete".

 Удаление модуля не приводит к удалению файла модуля; при этом просто удаляется имя из списка. Все ответные реакции, принадлежащие модулю или его потомкам, удаляются.

Сворачивание модулей в иконки

Рабочая область PhAB позволяет Вам работать одновременно с несколькими модулями приложения. Вы можете свернуть модули в иконки для формирования Вашей рабочей области. Чтобы свернуть любой модуль на рабочей области в иконку:

• Дважды щёлкните на кнопке рабочего меню модуля (верхний левый угол модуля)

или

• щёлкните на кнопке рабочего меню и выберите "Minimize"

или

• щёлкните на кнопке минимизации на заголовочной панели модуля.

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

Закрытие модуля

Если Вы желаете остановить работу модуля или удалить его из рабочей области:

1. Щёлкните на кнопке рабочего меню модуля (верхний левый угол модуля).

2. Выберите пункт "Close".

Если Вы хотите просто свернуть модуль в иконку, выберите пункт Minimize".

Чтобы вновь открыть какой-либо закрытый модуль, см. раздел "Селектор модулей" в этой главе.

Отображение модулей в реальном времени

Для Вашего приложения может понадобится отобразить модуль во время его работы. Вы можете:

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

• Использовать внутренний линк (internal link) для создания модуля в тексте программы Вашего приложения. См. главу "Доступ к модулям PhAB из программы".

Позиционирование модуля

Вы можете задать, где отображать модуль, когда Вы создаёте связывающую ответную реакцию от виджета к этому модулю. Чтобы выполнить это, используйте диалог расположения – "Location dialog".

Чтобы открыть диалог расположения и выбрать расположение модуля:

1. При создании или редактировании ответной реакции, связанной с модулем, щёлкните на области "Location" или на иконке справа от области. Вы увидите список расположений:

Рис. 4-2. Диалог расположения

Для окон и диалогов принимаемым по умолчанию расположением является (0, 0), при котором окно располагается на следующей доступной позиции, определяемой менеджером окон. Для модулей меню принимаемым по умолчанию расположением является "Below Widget" – под виджетом.

1. Щёлкните на желаемом расположении.

2. Вы можете также задать смещение x и y. Например, если Вы устанавливаете расположение в нижнем правом углу и устанавливаете смещение по х на –100, окно будет отображаться так, что его нижний правый угол будет на 100 пикселей левее нижнего правого угла экрана.

 Если Вы выберете расположение по умолчанию, смещения игнорируются.

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

Нахождение потерянных модулей и иконок

Чтобы найти потерянный модуль или иконку:

• Выберите из меню "Window" пункт "Arrange Modules". PhAB расположит все открытые модули каскадом в рабочей области PhAB.

• Выберите из меню "Window" пункт "Arrange Icons". PhAB расставит все существующие иконки вдоль нижней кромки рабочей области.

Если вышеприведенные приёмы не сработали, Вы можете "закрыть" модуль. (PhAB позволяет Вам закрывать модуль, удаляя его из рабочей области и уменьшая толкучку). Чтобы узнать, как вновь открыть закрытый модулsь, см. раздел "Открытие модуля" в этой главе.

Модули окон

Класс виджета	Расширение файла	Создание виджета
PtWindow	.wgtw	Непосредственно из палитры виджетов

Обычно Вы используете модули окон как основные активные сущности Вашего приложения. Так как большинство приложений использует модуль окна для своего основного окна, PhAB автоматически генерирует модуль окна с именем "base", когда Вы впервые создаёте какое-либо приложение. Он также предустанавливает информацию запуска приложения, делая базовое окно открывающимся при запуске приложения. (См. раздел "Задание информации запуска приложения" в главе "Работа с приложениями").

Иконка модуля окна

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

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

Как пример кода обработки множества экземпляров модулей окна см. раздел "Создание окон" в главе "Уроки".

Изменение размера модуля окна

Когда Вы устанавливаете в PhAB размеры модуля окна, это и будут его размеры при запуске приложения.

Модули диалога

класс виджета	расширение файла	создание виджета
PtWindow	.wgtd	Непосредственно из палитры виджета

Модули диалога позволяют Вам получать дополнительную информацию от пользователей. Обычно Вы используете эту информацию для осуществления конкретной команды или задачи.