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

Рис. 2-2. Панели инструментов PhAB

"Open"	Открыть существующее приложение; см. "Открытие приложения" в главе "Работа с приложениями". Эта команда также доступна из меню "File".
"Save"	Сохранить текущее приложение, см. "Сохранение приложения" в главе " "Работа с приложениями". Команда также доступна из меню "File".
"Print"	Не обеспечена
"Cut", "Copy", "Paste"	Удалить и скопировать виджеты в буфер обмена, и вклеить затем из него; см. "Буфер обмена" в главе "Создание виджетов в PhAB". Эти команды также доступны из меню "Edit".
"Group", "Split"	Объединить выбранные виджеты в группу или разбить выбранную группу, см. "Выравнивание виджетов с использованием группирования" в главе "Управление геометрией". Эти команды также доступны через меню "Edit".
"Move Into"	Переместить виджет из одного контейнера в другой; см. "Перемещение виджетов между контейнерами" в главе "Создание виджетов в PhAB". Эта команда соответствует команде "Transfer" из меню "Edit".
"Test"	Переключает в режим тестирования, так что Вы можете взаимодействовать с виджетом таким образом, как будто Ваше приложение запущено на выполнение.
"Raise", "Lower", "To front", "To back"	Переместить выбранные виджеты на передний или задний план; или вперёд, или назад в контейнере, см. "Выстраивание виджетов" в главе "Создание виджетов в PhAB". Команды "To front" и "To back" также доступны через меню "Edit".
"Align"	Наиболее часто используемые команды выравнивания выбранных виджетов; см. "Выравнивание виджетов" в главе "Создание виджетов в PhAB". Для более полного выбора возможностей выравнивания см. пункт "Alignment" в меню "Edit".
"X", "Y", "W", "H"	Координаты и размер выбранного в текущий момент виджета. Чтобы изменить их, наберите новое значение и нажмите <Enter>. Чтобы сделать невозможным изменение координат или размеров текущего виджета, заприте их, щёлкнув на изображении замочка, так чтобы он закрылся. Вы не сможете изменить область (ни вводом значения, ни перетаскиванием), пока не отопрёте его. Замочки сохраняются вместе с Вашими приложением.

Инструмент корректировки положения

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

Рис. 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. Панель поиска