Руководство программиста в Photon (1037671), страница 29
Текст из файла (страница 29)
где:
| link_instance | Указатель на экземпляр созданного модуля PhAB. Вам понадобится сохранить этот указатель, если он указывает на модуль окна, поддерживающего множественность экземпляров. | |
| apinfo | Указатель на структуру ApInfo_t, которая обеспечивает:
Обсуждавшиеся коды, связанные с типом вызванной установочной функции: | |
| ABR_PRE_REALIZE – | эта установочная функция была вызвана перед реализацией модуля | |
| ABR_POST_REALIZE – | эта установочная функция была вызвана после того, как модуль отобразился на экране. | |
| cbinfo | Указатель на общую структуру ответной реакции Photon. Эта структура обеспечивает информацией, связанной с виджетом, вызвавшим ответную реакцию, с событием Photon'а и некоторыми данными по ответной реакции, специфическими для виджета. Формат данных варьируется в соответствии с классом виджета и типом ответной реакции. Для получения более полной информации см. описание PtCallbackInfo_t в "Справочнике виджетов". | |
Обычно установочная функция возвращает значение Pt_CONTINUE. Это указывает PhAB API продолжать исполнение и отобразить связанный с этой функцией модуль. Для модулей окна и диалога Вы можете возвращать Pt_END, чтобы завершить привязанную ответную реакцию и разрушить модуль, не отображая его. Для модулей окна Вы можете возвращать Pt_HALT, чтобы не реализовать, но и не разрушать окно. Это является полезным, если Вы хотите реализовать окно позже.
Функции ответных реакций кодового типа
Функция ответной реакции кодового типа генерируется, если Вы задаёте связанную ответную реакцию кодового типа, как описано в разделе "Кодовые ответные реакции" главы "Редактирование ресурсов и ответных реакций в PhAB".
Все ответные реакции кодового типа имеют три главных аргумента:
int mycallback( PtWidget_t *widget,
ApInfo_t *apinfo,
PtCallbackInfo_t *cbinfo )
{
/* предотвращает предупреждения (варнинги) об отсутствии ссылок */
widget = widget,
apinfo = apinfo,
cbinfo = cbinfo;
/* Вот здесь Ваш код */
return( Pt_CONTINUE );
}
где
| widget | Указатель на экземпляр виджета, вызвавшего ответную реакцию. Это указатель на структуру PtWidget_t, но Вы можете интерпретировать его как идентификатор виджета; не пытайтесь манипулировать членами структуры. | |
| apinfo | Указатель на структуру ApInfo_t, которая включает коды, связанные с типом функции ответной реакции, которая была вызвана: | |
| ABR_CANCEL – | эта функция ответной реакции вызывается связью "Cancel" | |
| ABR_CODE – | эта функция ответной реакции вызывается связью "Code" | |
| ABR_DONE – | эта функция ответной реакции вызывается связью "Done". | |
| cbinfo | Указатель на общую структуру ответной реакции Photon'а. Структура обеспечивает информацией, связанной с виджетом, вызвавшим ответную реакцию, с событием Photon'а и некоторыми данными по ответной реакции, специфическими для виджета. Формат данных варьируется в соответствии с классом виджета и типом ответной реакции. Для получения более полной информации см. описание PtCallbackInfo_t в "Справочнике виджетов". | |
Ваша ответная реакция должна возвращать Pt_CONTINUE, если описание ответной реакции не даст Вам повода вернуть что-то другое. Ответные реакции ABR_CANCEL и ABR_DONE могут возвращать Pt_HALT, чтобы не допустить закрытия модуля.
Типы данных геометрии
Вот структура данных, которую Вы будете использовать при задании позиции, размеров или областей:
| PhPoint_t | Координаты x и y одиночной точки. Вы будете использовать это при задании расположения на экране, на холсте виджета, и прочем. |
| PhDim_t | Ширина (w) и высота (h), обычно в координатах Photon'а. Вы будете это использовать при задании размеров. |
| PhArea_t | Прямоугольная область, выраженная как PhPoint_t для левого верхнего угла области и PhDim_t, определяющего размеры области. |
| PhRect_t | Прямоугольник, выраженный двумя структурами PhPoint_t, одна для верхнего левого, вторая – для нижнего правого углов. |
| PhTile_t | Список прямоугольников. Эта структура используется в основном в "списке повреждений", который определяет области на экране или виджет, которые долны быть обновлены. |
Photon поддерживает внутренний пул "черепиц", поскольку они часто используются, и использование пула уменьшает время, затрачиваемое на удаление "черепиц" и освобождение ресурсов. Используйте PhGetTile(), чтобы получить "черепицу" из пула, и PhFreeTiles(), чтобы вернуть список "черепиц" в пул.
Вы, вероятно, не будете использовать структуру PhTile_t, если не будете использовать виджет PtRaw или создавать свой собственный виджет. Для получения более полной информации см. раздел "Виджет PtRaw" в главе "Необработанная прорисовка и анимация", и "Построение своих виджетов".
Библиотеки Photon'а предоставляют различные функции работы с этими типами данных:
| PhAreaToRect() | Преобразование области в прямоугольник |
| PhDeTranslateRect() | Детрансляция прямоугольника (вычитание смещения) |
| PhRectIntersect() | Нахождение перекрытия двух прямоугольников |
| PhRectToArea() | Преобразование прямоугольника в область |
| PhRectUnion() | Определение охватывающего прямоугольника для двух прямоугольников |
| PhTranslateRect() | Трансляция прямоугольника (добавление смещений) |
Таймеры
Если Вы желаете диспетчировать Ваши собственные операции в конкретные интервалы времени, или если Вы желаете выполнять тайм-аут или запускать событие именно в конкретный момент времени, Вам могут понадобиться основанные на таймере функции ответных реакций. Есть несколько способов это осуществить, с различным объёмом сложности и точности:
-
виджет PtTimer – прост, но не слишком точен;
-
функция RtTimer* – несколько больше работы, несколько более точная;
-
таймеры в процессе, отдельном от GUI (графический интерфейс пользователя, кто забыл) – необходим для жёсткого реального времени. Для получения более полной информации см. раздел "Нити" в главе "Переменные операции".
Библиотеки Photon'а также включают несколько функций работы с таймером низкого уровня, но Вам надо пользоваться ими с осторожностью:
| PhTimerArm() | Взводит событие таймера. Не используйте эту функцию в приложении, которое использует виджеты. |
| PtTimerArm() | Взводит событие таймера в виджете. Эта функция обычно используется при создании своего собственного виджета. Некоторые виджеты (такие как PtTerminal) уже используют этот тип таймера, так что вызов функции PtTimerArm() может иметь непредсказуемые результаты. |
Использование PtTimer
Простейшим способом обеспечить работу таймера является использование виджета PtTimer. Он определяет такие ресурсы:
| Pt_ARG_TIMER_INITIAL | – начальный интервал истечения времени |
| Pt_ARG_TIMER_REPEAT | – необязательный интервал времени повтора |
| Pt_CB_TIMER_ACTIVATE | – время окончания ответной реакции |
Для получения более полной информации см. "Справочник виджетов".
Когда Вы создаёте виджет PtTimer в PhAB, он возникает как чёрный прямоугольник. Этот прямоугольник не появится, когда Вы запустите приложение – это просто заполнитель места [Малевичи… Прим.пер.].
PtTimer прост в использовании, но не даёт точности событий таймера. В частности, он не гарантирует постоянной частоты повторения; поскольку повторение осуществляется путём взведения таймера вновь для каждого события, какие-либо задержки в обработке событий аккумулируются. Таймеры ядра гарантируют точность частоты повторения, даже если Ваше приложение не может её выдерживать.
Функции RtTimer*
Функции RtTimer* (описанные в "Справочнике библиотеки Photon") дают более точный отсчёт времени, нежели PtTimer, но ещё не соответствуют требованиям жёсткого реального времени. Они охватывают функции POSIX, манипулирующие таймерами ядра:
| RtTimerCreate() | Создать таймера реального времени |
| RtTimerDelete() | Удалить таймера реального времени |
| RtTimerGetTime() | Получить у таймера реального времени оставшееся время |
| RtTimerSetTime() | Установить время срабатывания для таймера реального времени |
Эти функции более точные, чем PtTimer, поскольку таймер взводится по-новому не Photon'ом, а ядром. Однако, если Photon занят обработкой событий, это по-прежнему может привести к задержке в обработке произошедших событий.
Меню инициализации
Вам может понадобиться сделать с меню различные вещи до того, как оно будет отображено. Вы можете использовать установочную функцию меню, чтобы:
-
включить, отключить или переключить пункты меню
-
изменить текст для какого-то пункта
Вы можете также использовать функциональный пункт меню, чтобы сгенерировать новые пункты во время исполнения.
Методы, выполняющие это, обсуждаются в нижеследующих разделах.
Включение, отключение или переключение пунктов меню
Если в текущем состоянии пункт меню не является допустимым выбором, хорошей идеей является отключить его, так чтобы пользователь и не пытался его выбрать. Конечно, Вам также понадобится сделать его доступным, когда настанет время. Если Ваше меню имеет какие-либо переключающиеся пункты, Вам также понадобится установить их перед тем, как меню будет отображено. Чтобы выполнить это, используйте функцию ApModifyItemState(). Функция ApModifyItemState() принимает переменное число аргументов:
-
Первым аргументом является указатель на модуль меню. Например, если именем экземпляра модуля меню является draw-menu, передайте &draw-menu как первый параметр.
-
Вторым параметром является желаемое состояние:
| AB_ITEM_DIM | для отключения пункта |
| AB_ITEM_NORMAL | для включения и возвращения пункта в исходное состояние |
| AB_ITEM_SET | для установки переключающегося пункта |
-
Остальные аргументы формируют завершающийся NULL'ом список пунктов меню, которые будут установлены в задаваемое состояние. Этот список состоит из глобальных переменных ABN_..., относящимся к пунктам меню.
Например, пердположим, что Ваше приложение имеет модуль меню по имени draw_menu, включающее пункты с именами экземпляров draw_group и draw_align. Мы можем отключить эти пункты следующим вызовом:
ApModifyItemState( &draw_menu, AB_ITEM_DIM,
ABN_draw_group, ABN_draw_align, NULL);
Изменение текста пунктов меню
Для изменения текста пункта меню, например, замены команды на её противоположную, Вы можете использовать функцию ApModifyItemText(). Её аргументы следующие:
-
указатель на модуль меню. Например, если имя экземпляра объекта модуля меню – draw_menu , передайте в качестве первого параметра &draw_menu.
-
глобальная переменная ABN_... для пункта меню
-
новый текст
Например, наше меню "Draw" может иметь пункт, который должен быть либо "Group" (сгруппировать), либо "Split" (разгруппировать), в зависимости от того, какой объект выбрал пользователь. Мы можем изменить текст пункта draw_group в меню draw_menu с помощью следующего кода:
ApModifyItemText()(&draw_menu, ABN_draw_group, "Split");
Чтобы получить текущий текст пункта, вызовите функцию ApGetItemText().
Генерирование пунктов меню
Иногда Вам может потребоваться генерировать пункты меню в ходе выполнения задачи. Например, меню "Window" PhAB'а включает список модулей в Вашем приложении. Чтобы сгенерировать пункты меню, добавьте пункт-функцию в Ваш модуль меню (как описано в разделе "Создание пунктов-функций" в главе "Работа с модулями") и отредактируйте сгенерированную PhAB'ом заготовку функции.
Например, если Ваш модуль draw_menu включает пункт-функцию, который вызывает функцию add_shapes(), PhAB сгенерирует следующий код:
int add_shapes (PtWidget_t *widget, ApInfo_t *apinfo, PtCallbackInfo_t *cbinfo)
{
/* предотвращает предупреждения (варнинги) об отсутствии ссылок */
widget=widget, apinfo=apinfo, cbinfo=cbinfo;
![](https://s.studizba.com/z.php?f=/templates/si/i/noavatar.png&w=100&h=100&t=1"){kind=avatar}
