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

#include <gtk/gtk.h>

            gtkruler;
            gtkrulermetric;
void        gtk_ruler_set_metric            (gtkruler *ruler,
                                             gtkmetrictype metric);
void        gtk_ruler_set_range             (gtkruler *ruler,
                                             gdouble lower,
                                             gdouble upper,
                                             gdouble position,
                                             gdouble max_size);

gtkmetrictype gtk_ruler_get_metric          (gtkruler *ruler);
void        gtk_ruler_get_range             (gtkruler *ruler,
                                             gdouble *lower,
                                             gdouble *upper,
                                             gdouble *position,
                                             gdouble *max_size);

object hierarchy

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

               +----gtkwidget
                     +----gtkruler
                           +----gtkhruler
                           +----gtkvruler

implemented interfaces

gtkruler implements atkimplementoriface.

properties

  "lower"                gdouble               : read / write
  "max-size"             gdouble               : read / write
  "metric"               gtkmetrictype         : read / write
  "position"             gdouble               : read / write
  "upper"                gdouble               : read / write

описание

помните

этот виджет рассматривается как специализированный/мало-используемый для gtk+, и в будущем будет перемещен в другой пакет. если ваше приложение нуждается в этом виджете, спокойно используйте его, поскольку он действительно работает и полезен для некоторых приложений. однако, мы не принимает новые свойства для виджета и он в конце концов будет перемещен из дистрибутива gtk+.

виджет gtkruler это базовый класс для горизонтальных и вертикальных линеек. линейки используются для отображения позиции указателя в окне. линейки могут быть и горизонтальными и вертикальными в окне. внутри линеек небольшой треугольный индикатор указывает расположение указателя мышки относительно горизонтальной и вертикальной линейки. смотрите gtkhruler чтобы узнать как создаётся горизонтальная линейка. смотрите gtkvruler чтобы узнать как создаётся вертикальная линейка.

детали

gtkruler

typedef struct _gtkruler gtkruler;

все расстояния находятся в 1/72ой дюйма. (согласно adobe это точка, но точка в действительности 1/72.27.)

gtkrulermetric

typedef struct {
  gchar *metric_name;
  gchar *abbrev;
  /* это должен быть points_per_unit. размер единицы
   * в  1/72ую дюйма и не имеет никакого отношения к пикселам экрана */
  gdouble pixels_per_unit;
  gdouble ruler_scale[10];
  gint subdivide[5];        /* пять возможных режимов подразделения */
} gtkrulermetric;

это должен быть points_per_unit. размер единицы в 1/72ую дюйма и не имеет никакого отношения к пикселам экрана.

gtk_ruler_set_metric ()

void        gtk_ruler_set_metric            (gtkruler *ruler,
                                             gtkmetrictype metric);

это вызов gtkmetrictype для установки линейки в определенные единицы. доступные единицы это gtk_pixels, gtk_inches, или gtk_centimeters. по умолчанию единицы установлены в gtk_pixels.

gtk_ruler_set_range ()

void        gtk_ruler_set_range             (gtkruler *ruler,
                                             gdouble lower,
                                             gdouble upper,
                                             gdouble position,
                                             gdouble max_size);

устанавливает диапазон линейки используя gfloat нижний, gfloat верхний, gfloat позиция и gfloat max_size.

gtk_ruler_get_metric ()

gtkmetrictype gtk_ruler_get_metric          (gtkruler *ruler);

получает единицы используемые для gtkruler. смотрите gtk_ruler_set_metric().

gtk_ruler_get_range ()

void        gtk_ruler_get_range             (gtkruler *ruler,
                                             gdouble *lower,
                                             gdouble *upper,
                                             gdouble *position,
                                             gdouble *max_size);

определяет значения указывающие диапазон и текущую позицию gtkruler. смотрите gtk_ruler_set_range().

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

свойство "lower"

  "lower"                gdouble               : read / write

нижний лимит линейки.

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

свойство "max-size"

  "max-size"             gdouble               : read / write

максимальный размер линейки.

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

свойство "metric"

  "metric"               gtkmetrictype         : read / write

метрика используемая для линейки.

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

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

свойство "position"

  "position"             gdouble               : read / write

позиция маркера на линейке.

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

свойство "upper"

  "upper"                gdouble               : read / write

верхний лимит линейки.

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

смотрите также

gtkhruler, gtkvruler