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 );

Обратите внимание, что 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