This file is indexed.

/usr/share/ada/adainclude/gtkada/gtk-stack.ads is in libgtkada16.1.0-dev 17.0.2017-2.

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
------------------------------------------------------------------------------
--                                                                          --
--      Copyright (C) 1998-2000 E. Briot, J. Brobecker and A. Charlet       --
--                     Copyright (C) 2000-2017, AdaCore                     --
--                                                                          --
-- This library is free software;  you can redistribute it and/or modify it --
-- under terms of the  GNU General Public License  as published by the Free --
-- Software  Foundation;  either version 3,  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 MERCHAN- --
-- TABILITY or FITNESS FOR A PARTICULAR PURPOSE.                            --
--                                                                          --
--                                                                          --
--                                                                          --
--                                                                          --
--                                                                          --
-- You should have received a copy of the GNU General Public License and    --
-- a copy of the GCC Runtime Library Exception along with this program;     --
-- see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see    --
-- <http://www.gnu.org/licenses/>.                                          --
--                                                                          --
------------------------------------------------------------------------------

--  <description>
--  The GtkStack widget is a container which only shows one of its children at
--  a time. In contrast to GtkNotebook, GtkStack does not provide a means for
--  users to change the visible child. Instead, the
--  Gtk.Stack_Switcher.Gtk_Stack_Switcher widget can be used with GtkStack to
--  provide this functionality.
--
--  Transitions between pages can be animated as slides or fades. This can be
--  controlled with Gtk.Stack.Set_Transition_Type. These animations respect the
--  Gtk.Settings.Gtk_Settings:gtk-enable-animations setting.
--
--  The GtkStack widget was added in GTK+ 3.10.
--
--  </description>
pragma Ada_2005;

pragma Warnings (Off, "*is already use-visible*");
with Glib;                    use Glib;
with Glib.Generic_Properties; use Glib.Generic_Properties;
with Glib.Properties;         use Glib.Properties;
with Glib.Types;              use Glib.Types;
with Gtk.Buildable;           use Gtk.Buildable;
with Gtk.Container;           use Gtk.Container;
with Gtk.Widget;              use Gtk.Widget;

package Gtk.Stack is

   type Gtk_Stack_Record is new Gtk_Container_Record with null record;
   type Gtk_Stack is access all Gtk_Stack_Record'Class;

   type Gtk_Stack_Transition_Type is (
      Stack_Transition_Type_None,
      Stack_Transition_Type_Crossfade,
      Stack_Transition_Type_Slide_Right,
      Stack_Transition_Type_Slide_Left,
      Stack_Transition_Type_Slide_Up,
      Stack_Transition_Type_Slide_Down,
      Stack_Transition_Type_Slide_Left_Right,
      Stack_Transition_Type_Slide_Up_Down,
      Stack_Transition_Type_Over_Up,
      Stack_Transition_Type_Over_Down,
      Stack_Transition_Type_Over_Left,
      Stack_Transition_Type_Over_Right,
      Stack_Transition_Type_Under_Up,
      Stack_Transition_Type_Under_Down,
      Stack_Transition_Type_Under_Left,
      Stack_Transition_Type_Under_Right,
      Stack_Transition_Type_Over_Up_Down,
      Stack_Transition_Type_Over_Down_Up,
      Stack_Transition_Type_Over_Left_Right,
      Stack_Transition_Type_Over_Right_Left);
   pragma Convention (C, Gtk_Stack_Transition_Type);
   --  These enumeration values describe the possible transitions between
   --  pages in a Gtk.Stack.Gtk_Stack widget.
   --
   --  New values may be added to this enumeration over time.

   ----------------------------
   -- Enumeration Properties --
   ----------------------------

   package Gtk_Stack_Transition_Type_Properties is
      new Generic_Internal_Discrete_Property (Gtk_Stack_Transition_Type);
   type Property_Gtk_Stack_Transition_Type is new Gtk_Stack_Transition_Type_Properties.Property;

   ------------------
   -- Constructors --
   ------------------

   procedure Gtk_New (Self : out Gtk_Stack);
   procedure Initialize (Self : not null access Gtk_Stack_Record'Class);
   --  Creates a new Gtk.Stack.Gtk_Stack container.
   --  Since: gtk+ 3.10
   --  Initialize does nothing if the object was already created with another
   --  call to Initialize* or G_New.

   function Gtk_Stack_New return Gtk_Stack;
   --  Creates a new Gtk.Stack.Gtk_Stack container.
   --  Since: gtk+ 3.10

   function Get_Type return Glib.GType;
   pragma Import (C, Get_Type, "gtk_stack_get_type");

   -------------
   -- Methods --
   -------------

   procedure Add_Named
      (Self  : not null access Gtk_Stack_Record;
       Child : not null access Gtk.Widget.Gtk_Widget_Record'Class;
       Name  : UTF8_String);
   --  Adds a child to Stack. The child is identified by the Name.
   --  Since: gtk+ 3.10
   --  "child": the widget to add
   --  "name": the name for Child

   procedure Add_Titled
      (Self  : not null access Gtk_Stack_Record;
       Child : not null access Gtk.Widget.Gtk_Widget_Record'Class;
       Name  : UTF8_String;
       Title : UTF8_String);
   --  Adds a child to Stack. The child is identified by the Name. The Title
   --  will be used by Gtk.Stack_Switcher.Gtk_Stack_Switcher to represent Child
   --  in a tab bar, so it should be short.
   --  Since: gtk+ 3.10
   --  "child": the widget to add
   --  "name": the name for Child
   --  "title": a human-readable title for Child

   function Get_Child_By_Name
      (Self : not null access Gtk_Stack_Record;
       Name : UTF8_String) return Gtk.Widget.Gtk_Widget;
   --  Finds the child of the Gtk.Stack.Gtk_Stack with the name given as the
   --  argument. Returns null if there is no child with this name.
   --  Since: gtk+ 3.12
   --  "name": the name of the child to find

   function Get_Homogeneous
      (Self : not null access Gtk_Stack_Record) return Boolean;
   --  Gets whether Stack is homogeneous. See Gtk.Stack.Set_Homogeneous.
   --  Since: gtk+ 3.10

   procedure Set_Homogeneous
      (Self        : not null access Gtk_Stack_Record;
       Homogeneous : Boolean);
   --  Sets the Gtk.Stack.Gtk_Stack to be homogeneous or not. If it is
   --  homogeneous, the Gtk.Stack.Gtk_Stack will request the same size for all
   --  its children. If it isn't, the stack may change size when a different
   --  child becomes visible.
   --  Since: gtk+ 3.10
   --  "homogeneous": True to make Stack homogeneous

   function Get_Transition_Duration
      (Self : not null access Gtk_Stack_Record) return Guint;
   --  Returns the amount of time (in milliseconds) that transitions between
   --  pages in Stack will take.
   --  Since: gtk+ 3.10

   procedure Set_Transition_Duration
      (Self     : not null access Gtk_Stack_Record;
       Duration : Guint);
   --  Sets the duration that transitions between pages in Stack will take.
   --  Since: gtk+ 3.10
   --  "duration": the new duration, in milliseconds

   function Get_Transition_Running
      (Self : not null access Gtk_Stack_Record) return Boolean;
   --  Returns whether the Stack is currently in a transition from one page to
   --  another.
   --  Since: gtk+ 3.12

   function Get_Transition_Type
      (Self : not null access Gtk_Stack_Record)
       return Gtk_Stack_Transition_Type;
   --  Gets the type of animation that will be used for transitions between
   --  pages in Stack.
   --  Since: gtk+ 3.10

   procedure Set_Transition_Type
      (Self       : not null access Gtk_Stack_Record;
       Transition : Gtk_Stack_Transition_Type);
   --  Sets the type of animation that will be used for transitions between
   --  pages in Stack. Available types include various kinds of fades and
   --  slides.
   --  The transition type can be changed without problems at runtime, so it
   --  is possible to change the animation based on the page that is about to
   --  become current.
   --  Since: gtk+ 3.10
   --  "transition": the new transition type

   function Get_Visible_Child
      (Self : not null access Gtk_Stack_Record) return Gtk.Widget.Gtk_Widget;
   --  Gets the currently visible child of Stack, or null if there are no
   --  visible children.
   --  Since: gtk+ 3.10

   procedure Set_Visible_Child
      (Self  : not null access Gtk_Stack_Record;
       Child : not null access Gtk.Widget.Gtk_Widget_Record'Class);
   --  Makes Child the visible child of Stack.
   --  If Child is different from the currently visible child, the transition
   --  between the two will be animated with the current transition type of
   --  Stack.
   --  Note that the Child widget has to be visible itself (see
   --  Gtk.Widget.Show) in order to become the visible child of Stack.
   --  Since: gtk+ 3.10
   --  "child": a child of Stack

   function Get_Visible_Child_Name
      (Self : not null access Gtk_Stack_Record) return UTF8_String;
   --  Returns the name of the currently visible child of Stack, or null if
   --  there is no visible child.
   --  Since: gtk+ 3.10

   procedure Set_Visible_Child_Name
      (Self : not null access Gtk_Stack_Record;
       Name : UTF8_String);
   --  Makes the child with the given name visible.
   --  If Child is different from the currently visible child, the transition
   --  between the two will be animated with the current transition type of
   --  Stack.
   --  Note that the child widget has to be visible itself (see
   --  Gtk.Widget.Show) in order to become the visible child of Stack.
   --  Since: gtk+ 3.10
   --  "name": the name of the child to make visible

   procedure Set_Visible_Child_Full
      (Self       : not null access Gtk_Stack_Record;
       Name       : UTF8_String;
       Transition : Gtk_Stack_Transition_Type);
   --  Makes the child with the given name visible.
   --  Note that the child widget has to be visible itself (see
   --  Gtk.Widget.Show) in order to become the visible child of Stack.
   --  Since: gtk+ 3.10
   --  "name": the name of the child to make visible
   --  "transition": the transition type to use

   ----------------
   -- Properties --
   ----------------
   --  The following properties are defined for this widget. See
   --  Glib.Properties for more information on properties)

   Homogeneous_Property : constant Glib.Properties.Property_Boolean;

   Transition_Duration_Property : constant Glib.Properties.Property_Uint;

   Transition_Running_Property : constant Glib.Properties.Property_Boolean;

   Transition_Type_Property : constant Gtk.Stack.Property_Gtk_Stack_Transition_Type;
   --  Type: Gtk_Stack_Transition_Type

   Visible_Child_Property : constant Glib.Properties.Property_Object;
   --  Type: Gtk.Widget.Gtk_Widget

   Visible_Child_Name_Property : constant Glib.Properties.Property_String;

   ----------------
   -- Interfaces --
   ----------------
   --  This class implements several interfaces. See Glib.Types
   --
   --  - "Buildable"

   package Implements_Gtk_Buildable is new Glib.Types.Implements
     (Gtk.Buildable.Gtk_Buildable, Gtk_Stack_Record, Gtk_Stack);
   function "+"
     (Widget : access Gtk_Stack_Record'Class)
   return Gtk.Buildable.Gtk_Buildable
   renames Implements_Gtk_Buildable.To_Interface;
   function "-"
     (Interf : Gtk.Buildable.Gtk_Buildable)
   return Gtk_Stack
   renames Implements_Gtk_Buildable.To_Object;

private
   Visible_Child_Name_Property : constant Glib.Properties.Property_String :=
     Glib.Properties.Build ("visible-child-name");
   Visible_Child_Property : constant Glib.Properties.Property_Object :=
     Glib.Properties.Build ("visible-child");
   Transition_Type_Property : constant Gtk.Stack.Property_Gtk_Stack_Transition_Type :=
     Gtk.Stack.Build ("transition-type");
   Transition_Running_Property : constant Glib.Properties.Property_Boolean :=
     Glib.Properties.Build ("transition-running");
   Transition_Duration_Property : constant Glib.Properties.Property_Uint :=
     Glib.Properties.Build ("transition-duration");
   Homogeneous_Property : constant Glib.Properties.Property_Boolean :=
     Glib.Properties.Build ("homogeneous");
end Gtk.Stack;