gtk+-*.0: Hide dedicated constructors of compact classes bound as structs
[vala-gnome.git] / vapi / metadata / Gtk-4.0.metadata
blob957a027022b0aaca340926f9e0f0bf0c3d523f60
1 // Issues which can't (currently) be fixed through annotations alone,
2 // but may be some day.
3 ////////////////////////////////////////////////////////////////////
5 *.event#parameter type="Gdk.Event"
6 *.*.event#parameter type="Gdk.Event"
8 // G-I doesn't support per-sybmol includes
9 * cheader_filename="gtk/gtk.h"
10 *Accessible cheader_filename="gtk/gtk.h,gtk/gtk-a11y.h"
11 IMContext cheader_filename="gtk/gtk.h,gtk/gtkimmodule.h"
13 // Causes vapigen issues, not sure why -- <union> without name
15 // G-I doesn't support structs
16 BindingSet struct=false
17 BindingEntry struct=false
18 BindingSignal struct=false
19 Border struct
20 FileFilterInfo struct=false
21 FixedChild struct=false
22 Requisition struct
23 TextIter struct
24 TreeIter struct
26 // Hide dedicated constructors of former compact classes
27 Border
28   .new skip
29 Requisition
30   .new skip
32 // Bug #636812: no support for annotating the type of a closure
33 AccelGroup
34   .connect*.closure type="owned Gtk.AccelGroupActivate"
35 AccelLabel
36   .set_accel_closure.accel_closure type="owned Gtk.AccelGroupActivate"
38 // Bug #: Virtual methods without invokers
39 EntryBuffer
40   .get_text#virtual_method name="get_text_internal"
41   .get_text#virtual_method.n_bytes out default=null
42 Range
43   .get_range_border.* out
44   .get_range_size_request.minimum out
45   .get_range_size_request.natural out
46 TextView
47   .create_buffer unowned=false skip=false
48 Widget
49   .compute_expand#virtual_method.* out
50   .dispatch_child_properties_changed.pspecs array array_length_idx=0
52 // Bug #657202: Floating references
53 FileFilter
54   .to_gvariant floating
55 PageSetup
56   .to_gvariant floating
57 PaperSize
58   .to_gvariant floating
59 PrintSettings
60   .to_gvariant floating
62 // Arrays without length arguments
63 TreeStore
64   .reorder skip=false
66 // Better deprecation notices
67 CellRenderer
68   .get_size replacement="get_preferred_size"
70 // G-I cannot deprecate whole types
72 // G-I cannot handle returning non-boxed types
73 binding_set_by_class skip=false
74 ContainerClass
75   .find_child_property skip=false
77 // G-I cannot handle variadic functions
78 *.*_valist skip=false
79 *.*_valist.args type="va_list"
80 *.*_valist.var_args type="va_list"
81 Builder
82   .add_callback_symbols skip=false
83 CellArea
84   .add_with_properties skip=false
85   .cell_get skip=false
86   .cell_set skip=false
87 Container
88   .add_with_properties skip=false
89   .child_get* skip=false
90   .child_set* skip=false
91 Dialog
92   .add_buttons skip=false
93   .new_with_buttons skip=false
94 FileChooserDialog
95   .new skip=false
96 InfoBar
97   .add_buttons skip=false
98   .new_with_buttons skip=false
99 ListStore
100   .new skip=false sentinel="-1"
101   .insert_with_values skip=false sentinel="-1"
102   .set skip=false sentinel="-1"
103 MessageDialog
104   .new skip=false printf_format
105   .format_secondary_markup skip=false printf_format
106   .format_secondary_text skip=false printf_format
107   .new_with_markup skip=false printf_format
108 Snapshot
109   .* skip=false
110 StyleContext
111   .get skip=false
112 TextBuffer
113   .create_tag skip=false
114   .insert_with_tags skip=false
115   .insert_with_tags_by_name skip=false
116 TreePath
117   .new_from_indices skip=false sentinel="-1"
118 TreeStore
119   .new skip=false sentinel=""
120   .insert_with_values skip=false sentinel="-1"
121   .set skip=false sentinel="-1"
122 TreeView
123   .insert_column_with_attributes skip=false
124 TreeViewColumn
125   .set_attributes skip=false
126   .new_with_attributes skip=false
127 Widget abstract=false
128   .new skip=false
129 Actionable
130   .set_action_target skip=false
131 CellLayout
132   .set_attributes skip=false
133 TreeModel
134   .get skip=false sentinel="-1"
136 // Abstract vs. virtual
137 CellRenderer
138   .get_size#virtual_method abstract
139 TreeModel
140   .iter_previous#virtual_method virtual
141   .ref_node#virtual_method virtual
142   .unref_node#virtual_method virtual
144 // Unregistered callback types
145 Builder
146   .lookup_callback_symbol skip=false
148 // Bug #: Default values
149 CellAreaBox
150   .pack_*.align default=false
151   .pack_*.fixed default=true
152   .pack_*.expand default=true
153 Editable
154   .get_chars.start_pos default=0
155   .get_chars.end_pos default=-1
156 EntryBuffer
157   .new.initial_chars default=null
158 Gesture
159   .get_point.x nullable default=null
160   .get_point.y nullable default=null
161 Grid
162   .attach*.width default=1
163   .attach*.height default=1
164 IconInfo
165   .load_symbolic*.success_color default=null
166   .load_symbolic*.warning_color default=null
167   .load_symbolic*.error_color default=null
168   .load_symbolic*.was_symbolic default=null
169   .*.cancellable default=null
170 Layout
171   .new.* default=null
172 Menu
173   .popup_at_*.trigger_event default=null
174 Notebook
175   .append_page.tab_label default=null
176   .prepend_page.tab_label default=null
177 ScaleButton
178   .new.min default=0.0
179   .new.max default=100.0
180   .new.step default=2.0
181   .new.icons default=null
182 TextBuffer
183   .set_text.len default=-1
184 TextTag
185   .new.name default=null
186 TextMark
187   .new.left_gravity default=false
188 Window
189   .new.type default=Gtk.WindowType.TOPLEVEL
191 // Ownership of out arguments
192 CellRenderer
193   .get_preferred_size.minimum_size unowned=false
194   .get_preferred_size.natural_size unowned=false
195 ComboBox
196   .get_active_iter.iter unowned=false
198 // Structs as generic type arguments
199 binding_entry_add_signall.binding_args type="GLib.SList<Gtk.BindingArg?>"
201 // Subclasses conflicting with virtual methods with different signatures
202 CellAreaBox
203   .pack_end name="pack_end_full"
204   .pack_start name="pack_start_full"
205 FileFilter
206   .get_name name="get_filter_name"
207   .set_name name="set_filter_name"
209 // Field ownership
210 RecentData
211   .* unowned=false
213 // Bug #: Nullable properties & fields
214 ComboBox.active_id nullable
215 RecentData
216   .display_name nullable
217   .description nullable
219 // Skipped for G-I, but usable from Vala
220 FlowBox
221   .bind_model skip=false
222   .bind_model.create_widget_func nullable
223 FlowBoxCreateWidgetFunc skip=false
224   .item type="GLib.Object"
225 IMContextSimple
226   .add_table skip=false
227 TreeSelection
228   .get_select_function skip=false
229   .get_user_data skip=false
231 // Symbol name conflicts
232 EntryCompletion
233   .insert_prefix#method name="request_prefix_insertion"
234 Notebook
235   .insert_page#virtual_method name="insert_page_menu"
236   .insert_page#virtual_method.tab_label nullable
237   .insert_page#virtual_method.menu_label nullable
238   .insert_page_menu skip
239 TreeView
240   .row_expanded#method name="is_row_expanded"
241 Widget
242   .compute_expand#virtual_method name="compute_expand_internal"
243   .draw#method name="draw_to_cairo_context"
244 Window
245   .activate_default#method name="try_activate_default"
246   .activate_focus#method name="try_activate_focus"
247 Editable
248   .delete_text#method skip
249   .insert_text#method skip
251 // time_t
252 RecentInfo
253   .get_added type="time_t"
254   .get_application_info.time_ type="time_t"
255   .get_modified type="time_t"
256   .get_visited type="time_t"
258 // Not sure what g-i was thinking
259 TreeModel
260   .filter_new parent="Gtk.TreeModelFilter" name="new" symbol_type="constructor"
261   .sort_new_with_model parent="Gtk.TreeModelSort" name="new_with_model" symbol_type="constructor"
263 // Vala-specific, not really bugs
264 /////////////////////////////////
266 // Backwards compatibility
267 AccelGroup
268   .find type="Gtk.AccelKey*"
269 CssProvider
270   .load_from_data name="load_from_buffer"
271 EntryBuffer
272   .new.initial_chars type="uint8[]?" array_length_idx=1
273   .emit_inserted_text.chars type="uint8[]" array_length_idx=2
274   .insert_text.chars type="uint8[]" array_length_idx=2
275   .set_text.chars type="uint8[]" array_length_idx=1
276 InfoBar
277   .get_content_area type="unowned Gtk.Container"
278 ListStore
279   .append return_void
280   .move_after.iter ref
281   .move_before.iter ref
282   .prepend return_void
283   .remove.iter ref
284 PaperSize
285   .free destroys_instance
286 SelectionData
287   .free destroys_instance
288   .get_data skip=false
289 Snapshot
290   .free_to_node destroys_instance
291 render_* parent="Gtk.StyleContext"
292 render_* symbol_type="method" instance_idx=0
293 TextBuffer
294   .delete.start ref
295   .delete.end ref
296   .delete_interactive.start_iter ref
297   .delete_interactive.end_iter ref
298   .get_end_iter return_void
299   .get_start_iter return_void
300   .insert*.iter ref
301   .insert_text.pos ref
302   .insert_text#signal.location ref
303 TextView
304   .backward*.iter ref
305   .forward*.iter ref
306   .get_iter_location return_void
307   .get_visible_rect return_void
308   .move_visually.iter ref
309 TreePath
310   .free destroys_instance
311   .get_indices skip
312   .get_indices_with_depth name="get_indices"
313 tree_row_reference_reordered skip=false name="reordered" parent="Gtk.TreeRowReference"
314 TreeRowReference
315   .free destroys_instance
316 TreeStore
317   .move_after.iter ref
318   .move_before.iter ref
319   .remove.iter ref
320 TreeView
321   .get_background_area return_void
322   .get_cell_area return_void
323   .get_visible_rect return_void
324 Widget
325   .drag_*#method parent="Gtk" symbol_type="function"
326   .get_allocation return_void
327   .get_clip return_void
328   .grab_add parent="Gtk" symbol_type="function"
329   .grab_remove parent="Gtk" symbol_type="function"
330   .intersect.intersection unowned=false nullable default=null
331   .size_allocate return_void
332 WidgetPath
333   .free destroys_instance
334 TreeModel
335   .get_value return_void
336   .rows_reordered skip
337 BindingArg
338   .d.* skip
339 rc_property_parse_* skip
340 show_about_dialog skip=false
341 test_init skip=false
343 test_init.argvp unowned
345 *.*.string name="str"
347 // Forward upstream
348 ///////////////////
349 GLArea
350   .create_context skip=false
351 Notebook
352   .create_window skip=false
353 PrintOperation
354   .create_custom_widget skip=false
356 // Not completely sure
357 Button
358   .get_label nullable
359   .label nullable
360   .set_label.label nullable
361 ComboBox
362   .get_row_separator_func skip=false
363 Entry
364   .populate_popup#signal.widget type="Gtk.Menu"
365 FileChooserNative
366   .accept_label nullable
367   .cancel_label nullable
368 Menu
369   .get_for_attach_widget type="unowned GLib.List<Gtk.Menu>"
370   .popped_up.*_rect type="Gdk.Rectangle"
371 NativeDialog
372   .title nullable
373   .transient_for nullable
374   .get_title nullable
375   .get_transient_for nullable
376   .set_title.title nullable
377   .set_transient_for.parent nullable
378 Window
379   .list_toplevels type="GLib.List<unowned Gtk.Window>"
380   .set_focus#signal.object nullable
381 TreeModel
382   .get_path nullable
383   .iter_next.iter ref
384   .iter_previous.iter ref
385 TreeView
386   .insert_column_with_attributes.title nullable
387 TreeViewColumn
388   .new_with_attributes.title nullable
389 TextView
390   .populate_popup.popup type="Gtk.Menu"
391 TreeView
392   .get_*_func skip=false
394 // Sure
395 binding_set_by_class.object_class type="GLib.ObjectClass"
396 *.ref unowned
398 // These delegate types don't have targets in the typedefs, but they
399 // get called with a target.
400 AccelGroupActivate skip
402 // Possible TODO
403 ////////////////
405 // TreeViewColumn.title nullable // (plus all title params in TreeView and TreeViewColumn)