краткое описание

#include <gtk/gtk.h>


            gtkscale;
void        gtk_scale_set_digits            (gtkscale *scale,
                                             gint digits);
void        gtk_scale_set_draw_value        (gtkscale *scale,
                                             gboolean draw_value);
void        gtk_scale_set_value_pos         (gtkscale *scale,
                                             gtkpositiontype pos);

gint        gtk_scale_get_digits            (gtkscale *scale);
gboolean    gtk_scale_get_draw_value        (gtkscale *scale);
gtkpositiontype gtk_scale_get_value_pos     (gtkscale *scale);

pangolayout* gtk_scale_get_layout           (gtkscale *scale);
void        gtk_scale_get_layout_offsets    (gtkscale *scale,
                                             gint *x,
                                             gint *y);

иерархия объектов

  gobject
   +----ginitiallyunowned
         +----gtkobject

               +----gtkwidget
                     +----gtkrange
                           +----gtkscale
                                 +----gtkhscale
                                 +----gtkvscale

реализуемые интерфейсы

gtkscale реализует atkimplementoriface.

свойства

  "digits"               gint                  : read / write
  "draw-value"           gboolean              : read / write
  "value-pos"            gtkpositiontype       : read / write

свойства стиля

  "slider-length"        gint                  : read
  "value-spacing"        gint                  : read

сигналы

"format-value"
            gchar*      user_function      (gtkscale *scale,
                                            gdouble   arg1,
                                            gpointer  user_data)      : run last

описание

gtkscale это слайдер управления используемый для выбора цифровых значений. для его использования, вам вероятно понадобится изучить методы его базового класса gtkrange, в дополнение к непосредственно методам gtkscale. для выбора значений диапазона, обычно используется gtk_range_set_value(). для определения изменения значения, используется сигнал "value_changed".

gtkscale виджет – это абстрактный класс, используемый только для порождения подклассов gtkhscale и gtkvscale. для создания виджета масштаба, вызовите gtk_hscale_new_with_range() или gtk_vscale_new_with_range().

детали

gtkscale

typedef struct _gtkscale gtkscale;

gtkscale структура содержит следующие поля. (эти поля должны рассматриваться только для чтения. они никогда не устанавливаются приложением.)

gtk_scale_set_digits ()

void        gtk_scale_set_digits            (gtkscale *scale,
                                             gint digits);

устанавливает количество десятичных отображаемых в значении. а также соответственно округляет значение регулятора, таким образом полученное значение означает значение видимое пользователем.

gtk_scale_set_draw_value ()

void        gtk_scale_set_draw_value        (gtkscale *scale,
                                             gboolean draw_value);

определяет отображается ли текущеме значение как строка рядом со слайдером.

gtk_scale_set_value_pos ()

void        gtk_scale_set_value_pos         (gtkscale *scale,
                                             gtkpositiontype pos);

устанавливает позицию в которой отображается текущеме значение.

gtk_scale_get_digits ()

gint        gtk_scale_get_digits            (gtkscale *scale);

определяет количество десятичных отображаемых в значении.

gtk_scale_get_draw_value ()

gboolean    gtk_scale_get_draw_value        (gtkscale *scale);

определяет отображается ли значение в виде строки рядом со слайдером.

gtk_scale_get_value_pos ()

gtkpositiontype gtk_scale_get_value_pos     (gtkscale *scale);

определяет позицию в которой отображается текущеме значение.

gtk_scale_get_layout ()

pangolayout* gtk_scale_get_layout           (gtkscale *scale);

определяет pangolayout используемый для отображения масштаба. возвращаемым объектом владеет виджет масштаба поэтому он не должен освобождаться вызывающим.

начиная с версии 2.4

gtk_scale_get_layout_offsets ()

void        gtk_scale_get_layout_offsets    (gtkscale *scale,
                                             gint *x,
                                             gint *y);

определяет координаты где будет отображен pangolayout представляющий текст в виджете масштаба. помните, при использовании pangolayout функции вы должны конвертировать в и из пикселей используя pango_pixels() или pango_scale.

если свойство draw_value равно false, возвращаемые значения не определены.

начиная с версии 2.4

детали свойств

свойство "digits"

  "digits"               gint                  : read / write

количество десятичных отображаемых в значении.

допустимые значения: [-1,64]

значение по умолчанию: 1

свойство "draw-value"

  "draw-value"           gboolean              : read / write

должно ли значение отображаться как строка рядом со слайдером.

значение по умолчанию: true

свойство "value-pos"

  "value-pos"            gtkpositiontype       : read / write

позиция в которой отображается текущеме значение.

значение по умолчанию: gtk_pos_top

детали свойств стиля

свойство стиля "slider-length"

  "slider-length"        gint                  : read

длина слайдера.

допустимые значения: >= 0

значение по умолчанию: 31

свойство стиля "value-spacing"

  "value-spacing"        gint                  : read

интервал между текстовым значением и полосой слайдера.

допустимые значения: >= 0

значение по умолчанию: 2

детали сигналов

сигнал "format-value"

gchar*      user_function                  (gtkscale *scale,
                                            gdouble   arg1,
                                            gpointer  user_data)      : run last

сигнал который позволяет вам изменять отображаемое значение масштаба. подключите обработчик сигнала который возвращает строку представляющую value. эта строка будет использоваться для отображения значения масштаба. вот пример обработчика сигнала который отображает значение 1.0 как "-->1.0<--".

static gchar*
format_value_callback (gtkscale *scale,
                       gdouble   value)
{
  return g_strdup_printf ("-->%0.*g<--",
                          gtk_scale_get_digits (scale), value);
}