Руководство программиста в Photon (Раздаточные материалы), страница 11

Рис. 2-3. Компоненты инструмента корректировки положения

Каждый щелчок на рамочных кнопках сдвинет, растянет или сожмёт выбранный виджет на один пиксель. Для сдвижки на несколько пикселей удерживайте кнопку мыши нажатой.

 Вы можете также использовать клавишу <Ctrl> и цифровую (вспомогательную) клавиатуру для пододвигания, растягивания или сжатия виджета. Каждая клавиша соответствует одной из кнопок инструмента корректировки. Нажатие <Ctrl>+<5> переключает режимы, и <Ctrl>+<> работает как верхняя рамочная кнопка.

Панели управления

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

Панели управления включают:

• Палитру виджетов

• Панель ресурсов

• Панель ответных реакций

• Панель дерева модулей

• Панель связей модулей

• Панель поиска

Они описаны в нижеследующих разделах.

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

Вы можете вытащить панели из группы, чтобы настроить рабочее место. Если Вы бросите её на фон рабочей области PhAB, она станет новой группой панелей. Если Вы перебросите её в другую группу панелей, панель присоединится к этой группе. Затем Вы вольны изменить размеры групп панелей, как Вы найдёте нужным. В зависимости от Вашего выбора в диалоге "AppBuilder Preferences Settings" ("Установка предопределений построителя приложений"), размещение панелей будет сохранено с Вашим приложением или для всех Ваших сеансов работы в PhAB.

Палитра виджетов

Палитра виджетов позволяет Вам добавлять виджеты в Ваше приложение.

Рис. 2-4. Палитра виджетов PhAB

Если Вы закроете эту панель, Вы сможете вновь открыть её, выбрав пункт "Palettes" из меню "View" и затем "Widgets" из всплывшего меню.

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

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

• Задержите указатель мыши на ней, пока не всплывёт подсказка

или

• См. приложение "Обзор виджетов".

Для получения информации об использовании определённых классов виджетов см. "Справочник виджетов Photon".

Режимы (создание или выбор)

Палитра виджетов имеет два режима:

Режим выбора	Позволяет Вам выбрать существующие виджеты и модули на рабочей области.
Режим создания	Позволяет Вам создавать новые виджеты.

Определение режима

Чтобы определить, в каком Вы режиме:

• Посмотрите на палитру виджетов – если кнопка иконки вдавлена, Вы в режиме создания.

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

Переключение в режим создания

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

Переключение в режим выбора

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

• Щёлкните на фоне рабочей области PhAB

или

• щёлкните правой клавишей мыши на модуле

или

• щёлкните на выбранном виджете на палитре виджетов.

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

Панель ресурсов

Панель ресурсов отображает список ресурсов для выбранного виджета или виджетов. (Если выбрано более одного виджета, эта панель отображает только ресурсы, которые они имеют сообща). Вот пример:

Рис. 2-5. Панель ресурсов

Если Вы закрыли эту панель, Вы можете вновь открыть её, выбрав пункт "Resources" из меню "View".

Она включает следующее:

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

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

По умолчанию панели управления "Resources" и "Callback" отображают названия ресурсов описательно. Если Вы задержите указатель на ресурсе, на всплывающей подсказке отобразится заголовочная декларация (header manifest).

Чтобы получить надписи, отображающие текущие заголовочные декларации (что удобно при написании кода), откройте диалог "Preferences" и измените установку в области "Resource Names". Чтобы открыть этот диалог, выберите пункт "Preferences" из меню "Options". Теперь, если Вы задержите указатель мыши на ресурсе, всплывающая надпись отобразит описание.

 Панель управления не отображает все ресурсы виджета. PhAB автоматически устанавливает Pt_ARG_AREA, Pt_ARG_DIM, Pt_ARG_EXTENT и Pt_ARG_POS при перемещении или изменении размеров виджета. Некоторые другие ресурсы слишком сложны, чтобы редактировать их в PhAB.

Панель ответных реакций

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

Рис. 2-6. Панель ответных реакций

Если Вы закрыли эту панель, Вы можете вновь открыть её, выбрав "Callback" из меню "View".

Эта панель, подобно панели ресурсов, отображает класс виджета и имя экземпляра, и кнопки перехода на следующий и предыдущий виджеты.

На левой стороне списка указывается тип ответной реакции. На правой отображается:

• "None" если нет ответных реакций

• Тип ответной реакции и имя, если имеется одна ответная реакция

• Число ответных реакций, если их более одной.

Чтобы создать ответную реакцию или отредактировать существующую, щёлкните на соответствующем ресурсе (напр., Pt_CB_ACTIVATE).

Панель дерева модулей

Панель дерева модулей отображает иерархическое дерево виджетов в текущем модуле. Вот пример:

Рис. 2-7. Панель дерева модулей

Если Вы закрыли эту панель, вы можете вновь открыть её, выбрав "Module Tree" из меню "View".

Эта панель позволяет легко:

• просмотреть родительские/потомков связи виджетов модуля;

• выбрать виджет внутри группы;

• найти виджет по имени;

• выбрать виджет, скрытый под другим виджетом.

Чтобы выбрать виджет на дереве, щёлкните на имени виджета. Если Вы щёлкните на этой панели правой кнопкой мыши, появится меню:

Рис. 2-8. Меню панели дерева модулей

Панель связей модуля

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

Рис. 2-9. Панель связей модуля

Чтобы:	Щёлкните на:
выбрать виджет	имени экземпляра (напр., base_file) в строке 1
редактировать ответную реакцию виджета	соответствующем типе ответной реакции (напр., Arm) в строке 2

Если Вы закрыли эту панель, Вы можете открыть её, выбрав пункт "Module Links" в меню "View".

Панель поиска

Панель поиска позволяет Вам найти виджет в Вашем приложении по заданному типу, имени, текстовому ресурсу и прочая.

Рис. 2-10. Панель поиска

Если Вы закрыли эту панель, Вы можете вновь её открыть, выбрав "Search Panel" из меню "View".

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

Widget Name	В текстовой области наберите точное имя виджета или регулярное выражение. Например, значение my_button* совпадает со всеми виджетами, имя которых начинается с my_button.
Widget Type	Наберите имя класса или регулярное выражение (напр., PtScroll*), или используйте комбинированное окно для выбора класса виджет.
Widget Text	Наберите определённый текст или регулярное выражение для просмотра текстовых ресурсов виджетов.
Callback Type	Поиск виджетов, имеющих прикреплённые ответные реакции типа (Code, Done и прочая), выбранного из комбинированного окна шаблона.
Callback Function Name	Наберите имя функции или регулярное выражение.
Callback Module Name	Наберите имя модуля или регулярное выражение. Будут выбраны все виджеты, имеющие ответные реакции, указывающие на модуль, чьё имя совпадает с шаблоном.

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

Подгонка Вашего окружения PhAB

Чтобы подогнать PhAB под свои предпочтения:

1. Выберите пункт "Preferences" из меню "Options". Вы увидите диалог установки предпочтений ("Preference Settings").

Рис. 2-11. Установка предпочтений PhAB

1. Щёлкнте на кнопке, представляющей вид установок, которые Вы хотите изменить: "General, "Colors" или "Draging".

2. Когда Вы завершите установку, щёлкните по "Done".

Общие предпочтения ("General preferences")

Вы можете установить следующие общие предпочтения:

Workspace	Позволяет Вам выбрать, сохранять ли Ваши предпочтения отдельно для каждого приложения, или для каждого пользователя, или не сохранять.
Resourse Names	По умолчанию, панели ресурсов и ответных реаукций отображают надписи ресурсов описательно. Эта область позволяет Вам отображать надписи как текущие заголовочные декларации, что Вы можете найти полезным при написании кода. Заметьте, однако, что декларации длинные и занимают на экране больше места. Если Вы задержите указатель на ресурсе, надпись, не отображённая в панели управления, будет отображаться во всплывающем тексте.
Icon Descriptions	По умолчанию, когда Вы задержите указатель мыши на любой иконке, всплывёт описывающий текст. Чтобы отключить эту возможность, щёлкните на "None".
Edit Command	Позволяет Вам задать редактор для использования с диалогом "Build+Run".
View Command	Позволяет Вам задать просмотровщик файлов для использования с диалогом "Build+Run".
Print Command	Позволяет Вам задать команду печати, используемую для печати выбранного файла (напр., в диалоге "Build+Run").
Automatically save	Определяет, сохранять или не сохранять приложение автоматически, и если сохранять, то как часто.
Warnings on exiting	Предупреждать или нет Вас, когда Вы выходите из PhAB без генерирования кода или сохранения Вашего приложения.

Предпочтение цвета ("Color preferences")

Вы можете установить следующие предпочтения цвета: