Руководство программиста в Photon (953920), страница 64
Текст из файла (страница 64)
Когда операция, связанная с модальным диалогом, завершена или прервана, Вам надо убрать диалог. Чтобы это сделать:
-
Вызовите функцию PtModalUnblock(), чтобы остановить выполнение модальной петли. Вы можете установить значение, возвращённое функцией PtModalBlock().
-
Уничтожьте (destroy) или удалите (unrealize) сам диалог.
Вызовите функцию PtUnblockWindows(), чтобы разблокировать все оконные виджеты, которые были блокированы при создании диалога. Вам не надо это делать, если вместо функций PtBlockAllWindows() или PtBlockWindow() Вы вызывали функцию PtMakeModal().
Мы можем легко изменить наш предыдущий пример рабочей процедуры, так что её "прогрессный" диалог будет вести себя как модальный диалог. Мы добавим структуру PtModalCtrl_t в ответную реакцию закрытия окна для её использования функциями PtModalBlock() и PtModalUnblock().
Ответная реакция done() вместо освобождения закрытия окна вызывает функцию PtModalUnblock():
int done(PtWidget_t *w, void *client, PtCallbackInfo_t *call) {
CountdownClosure *closure = (CountdownClosure *)client;
call = call;
if (!closure->done) {
PtAppRemoveWorkProc(NULL, closure->work_id);
}
PtDestroyWidget(closure->dialog->widget);
free(closure->dialog);
/* Новое: завершаем модальную петлю, возвращаем значение счётчика в качестве ответа */
PtModalUnblock(&(closure->modal_control), (void *) &(closure->value));
return (Pt_CONTINUE);
}
Всё, что осталось в этом месте сделать – это изменить функцию ответной реакции push_button_cb(), так чтобы она блокировала окно после реализации "прогрессного" диалога, запускала модальную петлю, разблокировала окна и освобождала закрытие после исчезновения диалога.
Вот новая версия функции ответной реакции push_button_cb():
int push_button_cb(PtWidget_t *w, void *client, PtCallbackInfo_t *call) {
PtWidget_t *parent = (PtWidget_t *)client;
WorkDialog *dialog;
PtBlockedList_t * blocked_list;
void * response;
w = w; call = call;
dialog = create_working_dialog(parent);
if (dialog) {
CountdownClosure *closure = (CountdownClosure *) malloc(sizeof(CountdownClosure));
if (closure) {
PtWorkProcId_t *id;
closure->dialog = dialog;
closure->value = 0;
closure->maxvalue = 200000;
closure->done = 0;
closure->work_id = id =
PtAppAddWorkProc(NULL, count_cb, closure);
PtAddCallback(dialog->ok_button, Pt_CB_ACTIVATE, done, closure);
PtRealizeWidget(dialog->widget);
/* Новое: блокируем все окна, кроме диалога, обработываем события вплоть
до закрытия диалога, и затем разблокируем все окна */
locked_list = PtBlockAllWindows (dialog->widget,
Ph_CURSOR_NOINPUT, Pg_TRANSPARENT);
response = PtModalBlock( &(closure->modal_control), 0 );
printf ("Достигнутое значение равно %d\n", *(int *)response );
free (closure);
PtUnblockWindows (blocked_list);
}
}
return (Pt_CONTINUE);
}
А вот новая версия программы в целом:
#include <Pt.h>
typedef struct workDialog {
PtWidget_t *widget;
PtWidget_t *label;
PtWidget_t *ok_button;
} WorkDialog;
typedef struct countdownClosure {
WorkDialog *dialog;
int value;
int maxvalue;
int done;
PtWorkProcId_t *work_id;
/* Новый член: */
PtModalCtrl_t modal_control;
} CountdownClosure;
WorkDialog *create_working_dialog(PtWidget_t *parent) {
PhDim_t dim;
PtArg_t args[3];
int nargs;
PtWidget_t *window, *group;
WorkDialog *dialog = (WorkDialog *)malloc(sizeof(WorkDialog));
if (dialog) {
nargs = 0;
PtSetArg(&args[nargs], Pt_ARG_WIN_PARENT, parent, 0);
nargs++;
PtSetParentWidget(NULL);
dialog->widget = window = PtCreateWidget(PtWindow, parent, nargs, args);
nargs = 0;
PtSetArg(&args[nargs], Pt_ARG_GROUP_ORIENTATION, Pt_GROUP_VERTICAL, 0);
nargs++;
PtSetArg(&args[nargs], Pt_ARG_GROUP_VERT_ALIGN, Pt_GROUP_VERT_CENTER, 0);
nargs++;
group = PtCreateWidget(PtGroup, window, nargs, args);
nargs = 0;
dim.w = 200;
dim.h = 100;
PtSetArg(&args[nargs], Pt_ARG_DIM, &dim, 0);
nargs++;
PtSetArg(&args[nargs], Pt_ARG_TEXT_STRING, "Counter: ", 0);
nargs++;
dialog->label = PtCreateWidget(PtLabel, group, nargs, args);
PtCreateWidget(PtSeparator, group, 0, NULL);
nargs = 0;
PtSetArg(&args[nargs], Pt_ARG_TEXT_STRING, "Stop", 0);
nargs++;
dialog->ok_button = PtCreateWidget(PtButton, group, 1, args);
}
return dialog;
} // create_working_dialog()
int done(PtWidget_t *w, void *client, PtCallbackInfo_t *call) {
CountdownClosure *closure = (CountdownClosure *)client;
call = call;
if (!closure->done) {
PtAppRemoveWorkProc(NULL, closure->work_id);
}
PtDestroyWidget(closure->dialog->widget);
free(closure->dialog);
/* Новое: завершаем модальную петлю, возвращаем значение счётчика в качестве ответа */
PtModalUnblock(&(closure->modal_control), (void *) &(closure->value));
return (Pt_CONTINUE);
} // done()
int count_cb(void *data) {
CountdownClosure *closure = (CountdownClosure *)data;
char buf[64];
int finished = 0;
if ( closure->value++ == 0 || closure->value % 1000 == 0 ) {
sprintf(buf, "Счётчик: %d", closure->value);
PtSetResource( closure->dialog->label, Pt_ARG_TEXT_STRING, buf, 0);
}
if ( closure->value == closure->maxvalue ) {
closure->done = finished = 1;
PtSetResource( closure->dialog->ok_button, Pt_ARG_TEXT_STRING, "Done", 0);
}
return finished ? Pt_END : Pt_CONTINUE;
} // count_cb()
int push_button_cb(PtWidget_t *w, void *client, PtCallbackInfo_t *call) {
PtWidget_t *parent = (PtWidget_t *)client;
WorkDialog *dialog;
PtBlockedList_t * blocked_list;
void * response;
w = w; call = call;
dialog = create_working_dialog(parent);
if (dialog) {
CountdownClosure *closure = (CountdownClosure *) malloc(sizeof(CountdownClosure));
if (closure) {
PtWorkProcId_t *id;
closure->dialog = dialog;
closure->value = 0;
closure->maxvalue = 200000;
closure->done = 0;
closure->work_id = id = PtAppAddWorkProc(NULL, count_cb, closure);
PtAddCallback(dialog->ok_button, Pt_CB_ACTIVATE, done, closure);
PtRealizeWidget(dialog->widget);
/* Новое: блокируем все окна, кроме диалога, обрабатываем события вплоть до его закрытия,
и затем разблокируем все окна */
blocked_list = PtBlockAllWindows (dialog->widget,
Ph_CURSOR_NOINPUT, Pg_TRANSPARENT);
response = PtModalBlock( &(closure->modal_control), 0 );
printf ("Достигнутое значение равно %d\n", *(int *)response );
free (closure);
PtUnblockWindows (blocked_list);
}
}
return (Pt_CONTINUE);
} // push_button_cb()
int main(int argc, char *argv[]) {
PhDim_t dim;
PtArg_t args[3];
int n;
PtWidget_t *window;
PtCallback_t callbacks[] = {{push_button_cb, NULL}};
char Helvetica14b[MAX_FONT_TAG];
if (PtInit(NULL) = = -1) PtExit(EXIT_FAILURE);
dim.w = 200;
dim.h = 100;
PtSetArg(&args[0], Pt_ARG_DIM, &dim, 0);
if ((window = PtCreateWidget(PtWindow, Pt_NO_PARENT, 1, args)) = = NULL) PtExit(EXIT_FAILURE);
callbacks[0].data = window;
n = 0;
PtSetArg(&args[n++], Pt_ARG_TEXT_STRING, "Count Down...", 0);
/* Используется 14-пунктовый жирный шрифт Helvetica, если он доступен */
if(PfGenerateFontName("Helvetica", PF_STYLE_BOLD, 14, Helvetica14b) = = NULL) {
perror("Невозможно сгенерировать имя шрифта");
}
else {
PtSetArg(&args[n++], Pt_ARG_TEXT_FONT, Helvetica14b, 0);
}
PtSetArg(&args[n++], Pt_CB_ACTIVATE, callbacks, sizeof(callbacks)/sizeof(PtCallback_t));
PtCreateWidget(PtButton, window, n, args);
PtRealizeWidget(window);
PtMainLoop();
return (EXIT_SUCCESS);
} // main()
Если Ваш диалог является автономным и Вам просто надо подождать его завершения, Вам может пригодиться такая функция:
ApModalWait() Обрабатывать события Photon'а, пока заданный виджет не будет уничтожен.
Глава 25. Программирование в Photon'е без PhAB'а
Мы настоятельно рекомендуем при разработке приложений Photon'а пользоваться PhAB'ом – а эта глава для тех чудаков, которые упорно не используют PhAB.
В этой главе обсуждается следующее:
-
Основные шаги
-
Компилирование и линковка не PhAB'овского приложения
-
Образец приложения
-
Увязывание кода приложения с виджетами
-
Полный пример приложения
Основные шаги
Все приложения, использующие библиотеку виджетов Photon'а, выполняют одну и ту же базовую последовательность действий:
-
Включить файл <Pt.h> – стандартный заголовочный файл для библиотеки виджета.
-
Инициализировать инструментальные средства виджетов Photon'а, вызвав функцию PtInit() (или PtAppInit(), которае также создаёт основное окно).
-
Создать виджеты, поддерживающие интерфейс с пользователем, вызвав функцию PtCreateWidget. Эта функция может создавать новые виджеты в потомках заданного виджета или текущего контейнера, или виджеты, не имеющиее родителя.
-
Зарегистрировать какие-либо ответные ракции в приложении с соответствующими виджетами, используя функции PtAddCallback() или PtAddCallbacks().
-
Реализовать виджеты, вызвав функцию PtRealizeWidget(). Эту функцию необходимо вызывать в приложении только один раз. Шаг реализации в действительности создаёт некие регионы Photon'а, которые затем назначаются и отображаются на экран. Пока этот шаг не отработан, никаких регионов не существует, и на экране ничего не отображается.
-
Обрабатывать события Photon'а, вызвав функцию PtMainLoop(). На этом шаге инструментальные средства виджетов Photon'а берут на себя управление приложением и виджетами. Если какие-либо виджеты вызывают функции Вашего приложения, они должны быть предварительно зарегистрированы как ответные реакции.
Компилирование и линковка не PhAB'овского приложения
Чтобы скомпилировать и запустить на исполнение приложение, которое использует библиотеку виджетов Photon'а, Вы должны подлинковаться к главной библиотеке Photon'а ph и к библиотеке отображения phrender. Существует статическая и совместно используемая версии этих библиотек.
| Библиотека photon предназначена только для приложений, созданных в версии 1.14 микроGUI Photon'а. Не комбинируйте эту библиотеку с текущими библиотеками или заголовочными файлами, в противном случае Ваше приложение будет исполняться неверно. |
Мы рекомендуем, чтобы Вы всегда подлинковывались к библиотеке совместного доступа. Это позволит Вам иметь приложение меньшим по размеру и позволит ему наследовать новые возможности, добавляемые к библиотеке виджетов при инсталяции новых реализаций библиотеки совместного доступа.
Библиотека Photon'а включает часть функций и определений виджетов. Если Ваше приложение использует функции Al (переводные) или Px (расширенные), Вам также понадобится подлинковаться к библиотеке phexlib. Если ваше приложение использует функции Ap (PhAB'овские), Вам также надо подлинковаться к библитеке Ар. Имена статических и совместно используемых библиотек одни и те же. По умолчанию qcc линкуется с библиотеками совместного доступа; чтобы линковаться со статическими библиотеками, задайте для qcc опцию – Bstatic.