/usr/share/ada/adainclude/gtkada/gtk-scale.ads is in libgtkada2.24.1-dev 2.24.1-14.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 | -----------------------------------------------------------------------
-- GtkAda - Ada95 binding for Gtk+/Gnome --
-- --
-- Copyright (C) 1998-2000 E. Briot, J. Brobecker and A. Charlet --
-- Copyright (C) 2000-2011, AdaCore --
-- --
-- This library is free software; you can redistribute it and/or --
-- modify it under the terms of the GNU General Public --
-- License as published by the Free Software Foundation; either --
-- version 2 of the License, or (at your option) any later version. --
-- --
-- This library is distributed in the hope that it will be useful, --
-- but WITHOUT ANY WARRANTY; without even the implied warranty of --
-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU --
-- General Public License for more details. --
-- --
-- You should have received a copy of the GNU General Public --
-- License along with this library; if not, write to the --
-- Free Software Foundation, Inc., 59 Temple Place - Suite 330, --
-- Boston, MA 02111-1307, USA. --
-- --
-----------------------------------------------------------------------
-- <description>
-- A scale is a horizontal or vertical widget that a user can slide to choose
-- a value in a given range. This is a kind of cursor, similar to what one
-- finds on audio systems to select the volume for instance.
--
-- </description>
-- <screenshot>gtk-scale.png</screenshot>
-- <group>Numeric/Text Data Entry</group>
pragma Warnings (Off, "*is already use-visible*");
with Glib; use Glib;
with Glib.Properties; use Glib.Properties;
with Glib.Types; use Glib.Types;
with Gtk.Adjustment; use Gtk.Adjustment;
with Gtk.Buildable; use Gtk.Buildable;
with Gtk.Enums; use Gtk.Enums;
with Gtk.GRange; use Gtk.GRange;
with Gtk.Orientable; use Gtk.Orientable;
with Gtk.Widget; use Gtk.Widget;
with Pango.Layout; use Pango.Layout;
package Gtk.Scale is
type Gtk_Scale_Record is new Gtk_Range_Record with null record;
type Gtk_Scale is access all Gtk_Scale_Record'Class;
subtype Gtk_Hscale_Record is Gtk_Scale_Record;
subtype Gtk_Hscale is Gtk_Scale;
subtype Gtk_Vscale_Record is Gtk_Scale_Record;
subtype Gtk_Vscale is Gtk_Scale;
------------------
-- Constructors --
------------------
function Get_Type return Glib.GType;
pragma Import (C, Get_Type, "gtk_scale_get_type");
procedure Gtk_New_Hscale
(Scale : out Gtk_Hscale;
Adjustment : Gtk.Adjustment.Gtk_Adjustment := null);
procedure Initialize_Hscale
(Scale : access Gtk_Hscale_Record'Class;
Adjustment : Gtk.Adjustment.Gtk_Adjustment := null);
procedure Gtk_New_Hscale
(Scale : out Gtk_Hscale;
Min : Gdouble;
Max : Gdouble;
Step : Gdouble);
procedure Initialize_Hscale
(Scale : access Gtk_Hscale_Record'Class;
Min : Gdouble;
Max : Gdouble;
Step : Gdouble);
-- Creates a new horizontal scale widget that lets the user input a number
-- between Min and Max (including Min and Max) with the increment Step.
-- Step must be nonzero; it's the distance the slider moves when using the
-- arrow keys to adjust the scale value. Note that the way in which the
-- precision is derived works best if Step is a power of ten. If the
-- resulting precision is not suitable for your needs, use
-- Gtk.Scale.Set_Digits to correct it.
-- "min": minimum value
-- "max": maximum value
-- "step": step increment (tick size) used with keyboard shortcuts
function Hscale_Get_Type return Glib.GType;
pragma Import (C, Hscale_Get_Type, "gtk_hscale_get_type");
procedure Gtk_New_Vscale
(Scale : out Gtk_Vscale;
Adjustment : Gtk.Adjustment.Gtk_Adjustment := null);
procedure Initialize_Vscale
(Scale : access Gtk_Vscale_Record'Class;
Adjustment : Gtk.Adjustment.Gtk_Adjustment := null);
procedure Gtk_New_Vscale
(Scale : out Gtk_Vscale;
Min : Gdouble;
Max : Gdouble;
Step : Gdouble);
procedure Initialize_Vscale
(Scale : access Gtk_Vscale_Record'Class;
Min : Gdouble;
Max : Gdouble;
Step : Gdouble);
-- Creates a new vertical scale widget that lets the user input a number
-- between Min and Max (including Min and Max) with the increment Step.
-- Step must be nonzero; it's the distance the slider moves when using the
-- arrow keys to adjust the scale value. Note that the way in which the
-- precision is derived works best if Step is a power of ten. If the
-- resulting precision is not suitable for your needs, use
-- Gtk.Scale.Set_Digits to correct it.
-- "min": minimum value
-- "max": maximum value
-- "step": step increment (tick size) used with keyboard shortcuts
function Vscale_Get_Type return Glib.GType;
pragma Import (C, Vscale_Get_Type, "gtk_vscale_get_type");
-------------
-- Methods --
-------------
procedure Add_Mark
(Scale : access Gtk_Scale_Record;
Value : Gdouble;
Position : Gtk.Enums.Gtk_Position_Type;
Markup : UTF8_String);
-- Adds a mark at Value. A mark is indicated visually by drawing a tick
-- mark next to the scale, and GTK+ makes it easy for the user to position
-- the scale exactly at the marks value. If Markup is not null, text is
-- shown next to the tick mark. To remove marks from a scale, use
-- Gtk.Scale.Clear_Marks.
-- Since: gtk+ 2.16
-- "value": the value at which the mark is placed, must be between the
-- lower and upper limits of the scales' adjustment
-- "position": where to draw the mark. For a horizontal scale, GTK_POS_TOP
-- is drawn above the scale, anything else below. For a vertical scale,
-- GTK_POS_LEFT is drawn to the left of the scale, anything else to the
-- right.
-- "markup": Text to be shown at the mark, using <link
-- linkend="PangoMarkupFormat">Pango markup</link>, or null
procedure Clear_Marks (Scale : access Gtk_Scale_Record);
-- Removes any marks that have been added with Gtk.Scale.Add_Mark.
-- Since: gtk+ 2.16
function Get_Digits (Scale : access Gtk_Scale_Record) return Gint;
procedure Set_Digits
(Scale : access Gtk_Scale_Record;
Number_Of_Digits : Gint);
-- Sets the number of decimal places that are displayed in the value. Also
-- causes the value of the adjustment to be rounded off to this number of
-- digits, so the retrieved value matches the value the user saw.
-- "digits": the number of decimal places to display, e.g. use 1 to
-- display 1.0, 2 to display 1.00, etc
function Get_Draw_Value (Scale : access Gtk_Scale_Record) return Boolean;
procedure Set_Draw_Value
(Scale : access Gtk_Scale_Record;
Draw_Value : Boolean);
-- Specifies whether the current value is displayed as a string next to
-- the slider.
-- "draw_value": True to draw the value
function Get_Layout
(Scale : access Gtk_Scale_Record) return Pango.Layout.Pango_Layout;
-- Gets the Pango.Layout.Pango_Layout used to display the scale. The
-- returned object is owned by the scale so does not need to be freed by
-- the caller. or null if the Gtk.Scale.Gtk_Scale:draw-value property is
-- False.
-- Since: gtk+ 2.4
procedure Get_Layout_Offsets
(Scale : access Gtk_Scale_Record;
X : out Gint;
Y : out Gint);
-- Obtains the coordinates where the scale will draw the
-- Pango.Layout.Pango_Layout representing the text in the scale. Remember
-- when using the Pango.Layout.Pango_Layout function you need to convert to
-- and from pixels using PANGO_PIXELS or PANGO_SCALE. If the
-- Gtk.Scale.Gtk_Scale:draw-value property is False, the return values are
-- undefined.
-- Since: gtk+ 2.4
-- "x": location to store X offset of layout, or null
-- "y": location to store Y offset of layout, or null
function Get_Value_Pos
(Scale : access Gtk_Scale_Record) return Gtk.Enums.Gtk_Position_Type;
procedure Set_Value_Pos
(Scale : access Gtk_Scale_Record;
Pos : Gtk.Enums.Gtk_Position_Type);
-- Sets the position in which the current value is displayed.
-- "pos": the position in which the current value is displayed
---------------------
-- Interfaces_Impl --
---------------------
function Get_Orientation
(Self : access Gtk_Scale_Record) return Gtk.Enums.Gtk_Orientation;
procedure Set_Orientation
(Self : access Gtk_Scale_Record;
Orientation : Gtk.Enums.Gtk_Orientation);
----------------
-- Interfaces --
----------------
-- This class implements several interfaces. See Glib.Types
--
-- - "Buildable"
--
-- - "Orientable"
package Implements_Buildable is new Glib.Types.Implements
(Gtk.Buildable.Gtk_Buildable, Gtk_Scale_Record, Gtk_Scale);
function "+"
(Widget : access Gtk_Scale_Record'Class)
return Gtk.Buildable.Gtk_Buildable
renames Implements_Buildable.To_Interface;
function "-"
(Interf : Gtk.Buildable.Gtk_Buildable)
return Gtk_Scale
renames Implements_Buildable.To_Object;
package Implements_Orientable is new Glib.Types.Implements
(Gtk.Orientable.Gtk_Orientable, Gtk_Scale_Record, Gtk_Scale);
function "+"
(Widget : access Gtk_Scale_Record'Class)
return Gtk.Orientable.Gtk_Orientable
renames Implements_Orientable.To_Interface;
function "-"
(Interf : Gtk.Orientable.Gtk_Orientable)
return Gtk_Scale
renames Implements_Orientable.To_Object;
----------------
-- Properties --
----------------
-- The following properties are defined for this widget. See
-- Glib.Properties for more information on properties)
--
-- Name: Number_Of_Digits_Property
-- Type: Gint
-- Flags: read-write
--
-- Name: Draw_Value_Property
-- Type: Boolean
-- Flags: read-write
--
-- Name: Value_Pos_Property
-- Type: Gtk.Enums.Gtk_Position_Type
-- Flags: read-write
-- The following properties are defined for this widget. See
-- Glib.Properties for more information on properties)
-- The following properties are defined for this widget. See
-- Glib.Properties for more information on properties)
Number_Of_Digits_Property : constant Glib.Properties.Property_Int;
Draw_Value_Property : constant Glib.Properties.Property_Boolean;
Value_Pos_Property : constant Gtk.Enums.Property_Gtk_Position_Type;
-------------
-- Signals --
-------------
-- The following new signals are defined for this widget:
--
-- "format-value"
-- function Handler
-- (Self : access Gtk_Scale_Record'Class;
-- Value : Gdouble) return UTF8_String;
-- -- "value": the value to format
-- Signal which allows you to change how the scale value is displayed.
-- Connect a signal handler which returns an allocated string representing
-- Here's an example signal handler which displays a value 1.0 as with
-- "-->1.0<--". |[ static gchar* format_value_callback (GtkScale
-- *scale, gdouble value) { return g_strdup_printf
-- ("-->%0.*g<--", gtk_scale_get_digits (scale), value); } ]|
Signal_Format_Value : constant Glib.Signal_Name := "format-value";
private
Number_Of_Digits_Property : constant Glib.Properties.Property_Int :=
Glib.Properties.Build ("digits");
Draw_Value_Property : constant Glib.Properties.Property_Boolean :=
Glib.Properties.Build ("draw-value");
Value_Pos_Property : constant Gtk.Enums.Property_Gtk_Position_Type :=
Gtk.Enums.Build ("value-pos");
end Gtk.Scale;
|