GTK+ 2.0 Tutorial

<<< Previous

Разные виджеты (Miscellaneous Widgets)

Next >>>


Шкала степени выполнения

Шкала выполнения используется для индикации статуса операции. Они довольно удобны в использовании, вы увидите это в коде  приведенном ниже. Но сначала создадим новую шкалу статуса выполнения:

GtkWidget *gtk_progress_bar_new( void );

Теперь созданную шкалу можно использовать:

void gtk_progress_bar_set_fraction ( GtkProgressBar *pbar, gdouble fraction );

Первый аргумент - шкала выполнения, второй - выполнение "completed" означает, что шкала была заполнена от 0 до 100%. Это передаётся в функцию как реальное число от 0 до 1.

С версии GTK v1.2 к шкале выполнения были добавлены некоторые функциональные возможности, позволяющие по разному отображать состояние выполнения операции и сообщать пользователю значение диапазона.

Шкала прогресса выполнения может принимать разную ориентацию используя функцию:

void gtk_progress_bar_set_orientation( GtkProgressBar *pbar, GtkProgressBarOrientation orientation );

Аргумент orientation может принимать одно из возможных значений для отображения перемещения шкалы выполнения:

GTK_PROGRESS_LEFT_TO_RIGHT GTK_PROGRESS_RIGHT_TO_LEFT GTK_PROGRESS_BOTTOM_TO_TOP GTK_PROGRESS_TOP_TO_BOTTOM

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

void gtk_progress_bar_pulse ( GtkProgressBar *progress );

Размер индикации шага активности устанавливается с помощью функции:

void gtk_progress_bar_set_pulse_step( GtkProgressBar *pbar, gdouble fraction );

В неактивном состоянии, конфигурационная строка текста может отображаться в колее шкалы.

void gtk_progress_bar_set_text( GtkProgressBar *progress, const gchar *text );

Note

Обратите внимание, что gtk_progress_set_text() не поддерживает printf(), как в подобном форматировании GTK + 1.2 Progressbar.

Вы можете выключить отображение строки, вызвав повторно calling gtk_progess_bar_set_text() с NULL в качестве второго параметра.

Текущие установки текста в шкале могут быть выполнены с помощью следующей функции. Не возвращайте пустую строку.

const gchar *gtk_progress_bar_get_text( GtkProgressBar *pbar );

Шкала выполнения обычно используется совместно с функциями перерыва (timeouts) или им подобными (смотрите секцию Timeouts, I/O and Idle Functions), для создания иллюзии многопоточности управления (multitasking). Используйте gtk_progress_bar_set_fraction() или gtk_progress_bar_pulse() функции всё в той же самой манере.

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

#include <gtk/gtk.h> typedef struct _ProgressData { GtkWidget *window; GtkWidget *pbar; int timer; gboolean activity_mode; } ProgressData; /* Обновляем значение шкалы выполнения * для отображения некоторых действий */ gint progress_timeout( gpointer data ) { ProgressData *pdata = (ProgressData *)data; gdouble new_val; if (pdata->activity_mode) gtk_progress_bar_pulse (GTK_PROGRESS_BAR (pdata->pbar)); else { /* Вычисляем значение шкалы выполнения используя * установленные значения диапазона в объекте регулирования (adjustment object) */ new_val = gtk_progress_bar_get_fraction (GTK_PROGRESS_BAR (pdata->pbar)) + 0.01; if (new_val > 1.0) new_val = 0.0; /* Устанавливаем новые значения */ gtk_progress_bar_set_fraction (GTK_PROGRESS_BAR (pdata->pbar), new_val); } /* Для продолжения вызова функции перерыва * (timeout function) необходимо вернуть значение TRUE */ return TRUE; } /* Обратный вызов переключателя для отображения текста в колее шкалы выполнения */ void toggle_show_text( GtkWidget *widget, ProgressData *pdata ) { const gchar *text; text = gtk_progress_bar_get_text (GTK_PROGRESS_BAR (pdata->pbar)); if (text && *text) gtk_progress_bar_set_text (GTK_PROGRESS_BAR (pdata->pbar), ""); else gtk_progress_bar_set_text (GTK_PROGRESS_BAR (pdata->pbar), "любой текст"); } /* Переключатель активного состояния шкалы выполнения */ void toggle_activity_mode( GtkWidget *widget, ProgressData *pdata ) { pdata->activity_mode = !pdata->activity_mode; if (pdata->activity_mode) gtk_progress_bar_pulse (GTK_PROGRESS_BAR (pdata->pbar)); else gtk_progress_bar_set_fraction (GTK_PROGRESS_BAR (pdata->pbar), 0.0); } /* Переключатель ориентации шкалы выполнения */ void toggle_orientation( GtkWidget *widget, ProgressData *pdata ) { switch (gtk_progress_bar_get_orientation (GTK_PROGRESS_BAR (pdata->pbar))) { case GTK_PROGRESS_LEFT_TO_RIGHT: gtk_progress_bar_set_orientation (GTK_PROGRESS_BAR (pdata->pbar), GTK_PROGRESS_RIGHT_TO_LEFT); break; case GTK_PROGRESS_RIGHT_TO_LEFT: gtk_progress_bar_set_orientation (GTK_PROGRESS_BAR (pdata->pbar), GTK_PROGRESS_LEFT_TO_RIGHT); break; } } /* Очистка выделенной памяти и удаление таймера */ void destroy_progress( GtkWidget *widget, ProgressData *pdata) { gtk_timeout_remove (pdata->timer); pdata->timer = 0; pdata->window = NULL; g_free (pdata); gtk_main_quit (); } int main( int argc, char *argv[]) { ProgressData *pdata; GtkWidget *align; GtkWidget *separator; GtkWidget *table; GtkWidget *button; GtkWidget *check; GtkWidget *vbox; gtk_init (&argc, &argv); /* Выделение памяти для данных размещенных в обратных вызовах */ pdata = g_malloc (sizeof (ProgressData)); pdata->window = gtk_window_new (GTK_WINDOW_TOPLEVEL); gtk_window_set_resizable (GTK_WINDOW (pdata->window), TRUE); g_signal_connect (G_OBJECT (pdata->window), "destroy", G_CALLBACK (destroy_progress), (gpointer) pdata); gtk_window_set_title (GTK_WINDOW (pdata->window), "GtkProgressBar"); gtk_container_set_border_width (GTK_CONTAINER (pdata->window), 0); vbox = gtk_vbox_new (FALSE, 5); gtk_container_set_border_width (GTK_CONTAINER (vbox), 10); gtk_container_add (GTK_CONTAINER (pdata->window), vbox); gtk_widget_show (vbox); /* Создаём объект выравнивания */ align = gtk_alignment_new (0.5, 0.5, 0, 0); gtk_box_pack_start (GTK_BOX (vbox), align, FALSE, FALSE, 5); gtk_widget_show (align); /* Создаём GtkProgressBar */ pdata->pbar = gtk_progress_bar_new (); gtk_container_add (GTK_CONTAINER (align), pdata->pbar); gtk_widget_show (pdata->pbar); /* Добавляем обратный вызов таймера для обновления значения шкалы выполнения */ pdata->timer = gtk_timeout_add (100, progress_timeout, pdata); separator = gtk_hseparator_new (); gtk_box_pack_start (GTK_BOX (vbox), separator, FALSE, FALSE, 0); gtk_widget_show (separator); /* ряды, колонки, homogeneous */ table = gtk_table_new (2, 3, FALSE); gtk_box_pack_start (GTK_BOX (vbox), table, FALSE, TRUE, 0); gtk_widget_show (table); /* Добавляем кнопку контроля для отображения текста в колее */ check = gtk_check_button_new_with_label ("Показать текст"); gtk_table_attach (GTK_TABLE (table), check, 0, 1, 0, 1, GTK_EXPAND | GTK_FILL, GTK_EXPAND | GTK_FILL, 5, 5); g_signal_connect (G_OBJECT (check), "clicked", G_CALLBACK (toggle_show_text), (gpointer) pdata); gtk_widget_show (check); /* Добавляем контроль-кнопку активного режима */ check = gtk_check_button_new_with_label ("Активный режим"); gtk_table_attach (GTK_TABLE (table), check, 0, 1, 1, 2, GTK_EXPAND | GTK_FILL, GTK_EXPAND | GTK_FILL, 5, 5); g_signal_connect (G_OBJECT (check), "clicked", G_CALLBACK (toggle_activity_mode), (gpointer) pdata); gtk_widget_show (check); /* Добавляем контроль-кнопку переключателя активного режима */ check = gtk_check_button_new_with_label ("Справа на лево"); gtk_table_attach (GTK_TABLE (table), check, 0, 1, 2, 3, GTK_EXPAND | GTK_FILL, GTK_EXPAND | GTK_FILL, 5, 5); g_signal_connect (G_OBJECT (check), "clicked", G_CALLBACK (toggle_orientation), (gpointer) pdata); gtk_widget_show (check); /* Добавляем кнопку выхода из программы */ button = gtk_button_new_with_label ("закрыть"); g_signal_connect_swapped (G_OBJECT (button), "clicked", G_CALLBACK (gtk_widget_destroy), G_OBJECT (pdata->window)); gtk_box_pack_start (GTK_BOX (vbox), button, FALSE, FALSE, 0); /* Создаем активную кнопку по умолчанию. */ GTK_WIDGET_SET_FLAGS (button, GTK_CAN_DEFAULT); /* Устанавливаем перехват для кнопки по умолчанию. * Простое нажатие клавиши "Enter" активизирует кнопку. */ gtk_widget_grab_default (button); gtk_widget_show (button); gtk_widget_show (pdata->window); gtk_main (); return 0; }

<<< Previous

Home

Next >>>

The Tooltips Object

Up

Dialogs