/usr/share/ada/adainclude/gtkada/gtk-tooltips.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 | -----------------------------------------------------------------------
-- GtkAda - Ada95 binding for Gtk+/Gnome --
-- --
-- Copyright (C) 2000-2009, 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>
-- Tooltips are the small text windows that popup when the mouse rests over
-- a widget, and that provide a quick help for the user.
--
-- In GtkAda, all tooltips belong to a group (a Gtk_Tooltips). All the
-- individual tooltips in a group can be disabled or enabled at the same
-- time. Likewise, the colors and style of a tooltip can be set on a group
-- basis.
--
-- See the example at the end for how to change the default colors used
-- for tooltips.
-- </description>
-- <c_version>2.8.17</c_version>
-- <testgtk>create_tooltips.adb</testgtk>
with Glib;
with Gtk.Enums;
with Gtk.Object;
with Gtk.Widget;
package Gtk.Tooltips is
type Gtk_Tooltips_Record is new Gtk.Object.Gtk_Object_Record with private;
type Gtk_Tooltips is access all Gtk_Tooltips_Record'Class;
-- <doc_ignore>
type Tooltips_Data
(Text_Length : Natural; Private_Length : Natural) is
record
Tooltips : Gtk_Tooltips; -- the group of the tooltip
Widget : Gtk.Widget.Gtk_Widget; -- the widget to which it applies
Text : UTF8_String (1 .. Text_Length); -- the text of the tooltip
Text_Private : UTF8_String (1 .. Private_Length); -- the private text
end record;
-- </doc_ignore>
procedure Gtk_New (Widget : out Gtk_Tooltips);
-- Create a new group of tooltips.
procedure Initialize (Widget : access Gtk_Tooltips_Record'Class);
-- Internal initialization function.
-- See the section "Creating your own widgets" in the documentation.
function Get_Type return Glib.GType;
-- Return the internal value associated with a Gtk_Tooltips.
procedure Enable (Tooltips : access Gtk_Tooltips_Record);
-- Enable all the tooltips in the group.
-- From now on, when the mouse rests over a widget for a short period of
-- time, the help text is automatically displayed.
procedure Disable (Tooltips : access Gtk_Tooltips_Record);
-- Disable all the tooptips in the group.
-- From now on, no tooltips in this group will appear, unless they are
-- re-enabled.
procedure Set_Tip
(Tooltips : access Gtk_Tooltips_Record;
Widget : access Gtk.Widget.Gtk_Widget_Record'Class;
Tip_Text : UTF8_String;
Tip_Private : UTF8_String := "");
-- Add a new tooltip to Widget.
-- The message that appears in the tooltip is Tip_Text, and the tooltip
-- belongs to the group Tooltips.
-- Tip_Private contains more information, that can be displayed by a
-- Gtk_Tips_Query widget through the "widget_selected" signal.
-- In most cases, Tip_Private should simply keep its default empty value.
function Get_Data
(Widget : access Gtk.Widget.Gtk_Widget_Record'Class) return Tooltips_Data;
-- Return the tooltip data associated with the Widget.
-- If there is none, the two text fields in the returned structure have
-- a length 0.
procedure Force_Window (Widget : access Gtk_Tooltips_Record);
-- Make sure the window in which the tooltips will be displayed is
-- created.
-- This is useful if you want to modify some characteristics of that
-- window.
procedure Set_Markup
(Tooltips : access Gtk_Tooltips_Record;
Text : UTF8_String);
-- Sets the text of the tooltip to be markup, which is marked up with the
-- Pango text markup language. If markup is empty string, the label will be
-- hidden.
procedure Set_Icon_From_Stock
(Tooltips : access Gtk_Tooltips_Record;
Stock_Id : String;
Size : Gtk.Enums.Gtk_Icon_Size);
-- Sets the icon of the tooltip (which is in front of the text) to be the
-- stock item indicated by stock_id with the size indicated by size. If
-- stock_id is emtry string, the image will be hidden.
-----------------
-- Obsolescent --
-----------------
-- All subprograms below are now obsolescent in gtk+. They might be removed
-- from future versions of gtk+ (and therefore GtkAda).
-- To find out whether your code uses any of these, we recommend compiling
-- with the -gnatwj switch
-- <doc_ignore>
procedure Set_Delay
(Tooltips : access Gtk_Tooltips_Record;
Duration : Guint := 500);
pragma Obsolescent; -- Set_Delay
-- Set the delay between the user moving the mouse over a widget and the
-- text appearing. Duration is in milli-seconds.
-- </doc_ignore>
----------------
-- Properties --
----------------
-- <properties>
-- The following properties are defined for this widget. See
-- Glib.Properties for more information on properties.
--
-- </properties>
-------------
-- Signals --
-------------
-- <signals>
-- The following new signals are defined for this widget:
-- </signals>
private
type Gtk_Tooltips_Record is
new Gtk.Object.Gtk_Object_Record with null record;
pragma Import (C, Get_Type, "gtk_tooltips_get_type");
end Gtk.Tooltips;
-- <example>
-- <include>../examples/documentation/tooltips.adb</include>
-- </example>
-- No binding: gtk_tooltips_get_info_from_tip_window
|