Commit Graph

2252 Commits

Author SHA1 Message Date
Ignacio Casal Quinteiro
fdea6c5c19 Fix typo. 2010-10-24 22:51:51 +02:00
Matthias Clasen
520a6aeb8f Fix up docs 2010-10-23 23:41:08 +02:00
Matthias Clasen
d7653e7c0c Add a unique->GtkApplication migration guide 2010-10-23 22:51:38 +02:00
Matthias Clasen
3e594dd845 Fix doc build 2010-10-23 21:23:22 +02:00
Matthias Clasen
7651c231e0 Revert the id-column patch
It didn't quite turn out as I wanted it.
I'll put it in bug 619148 for now.
2010-10-23 19:34:20 +02:00
Matthias Clasen
9fb36fff36 Add a way to associate numeric ids with combobox values
This will let us use combo boxes as property editors for
GSettings enmerations easily.
2010-10-23 02:31:30 +02:00
Javier Jardón
38dbb84095 gtkadjustment: Move documentation to inline comments 2010-10-23 00:31:37 +02:00
Javier Jardón
96f2f2ff5b gtkscrollbar: Move documentation to inline comments 2010-10-23 00:31:37 +02:00
Javier Jardón
ec0c739520 gtktreemodelfilter: Move documentation to inline comments 2010-10-23 00:31:37 +02:00
Javier Jardón
8d3b36d534 gtktreeselection: Move documentation to inline comments 2010-10-23 00:31:37 +02:00
Javier Jardón
e51daa79fe gtktreesortable: Move documentation to inline comments 2010-10-23 00:31:37 +02:00
Javier Jardón
16cf23959f gtktreeviewcolumn: Move documentation to inline comments 2010-10-23 00:31:36 +02:00
Javier Jardón
8f766d36f4 gtktreestore: Move documentation to inline comments 2010-10-23 00:31:36 +02:00
Carlos Garnacho
1bbbd005a4 GtkColorButton: Add API to deal with GdkRGBA. 2010-10-22 20:14:57 +02:00
Carlos Garnacho
cb5b74e9c6 GtkColorSelection: Add API to deal with GdkRGBA.
The hook to change the global palette is still unchanged, it is quite
tied to GdkColor and the color format used to store the palette in
GtkSettings.
2010-10-22 20:14:56 +02:00
Carlos Garnacho
ce06043f17 GdkWindow: Add gdk_window_set_background_rgba()
This new function takes a GdkRGBA in order to set the background to
an alpha color. Keep in mind that RGBA visuals and a composited environment
are still necessary to have an alpha background displayed.
2010-10-22 20:14:56 +02:00
Carlos Garnacho
5a5f8081f0 Add GdkRGBA struct to supersede GdkColor
GdkRGBA is a boxed struct similar to GdkColor, with the difference
that it stores alpha information as well, and colors are stored in
[0..1] doubles, in the cairo spirit.

gdk_cairo_set_source_rgba() has been also added to allow easier handling
of this new type.
2010-10-22 20:14:56 +02:00
Matthias Clasen
c750003168 Point to GtkGrid from the GtkBox and GtkTable docs 2010-10-22 19:59:29 +02:00
Matthias Clasen
09ec50af90 Remove GtkScrollablePolicy again
This was a miscommunication, the properties need to live elsewhere.
2010-10-22 19:24:03 +02:00
Matthias Clasen
0d9ebb501d Move min-display-width/height to GtkScrolledWindow
It is just too annoying to have to implement these properties in
every scrollable. Instead, we now have ::min-content-height/width
in GtkScrolledWindow.

We also add GtkScrollablePolicy to determine how to size the
scrollable content.
2010-10-22 19:21:17 +02:00
Javier Jardón
8999053b5f docs: Add gtk-doc notation
to emphasize that GtkMisc and GtkAdjustment are not encouraged in new code
2010-10-22 17:59:38 +02:00
Matthias Clasen
8cd13d09e8 Discourage use of GtkMisc and GtkAlignment 2010-10-22 16:52:08 +02:00
Matthias Clasen
8f0ae8e8a3 Add GtkGrid
GtkGrid is a container similar to GtkTable, without legacy
properties and unnecessary restrictions.
It does height-for-width geometry management.
2010-10-22 16:42:50 +02:00
Christian Persch
b0fe3e49bb Add gtk_recent_info_get_gicon()
https://bugzilla.gnome.org/show_bug.cgi?id=617174
2010-10-22 11:58:00 +01:00
Emmanuele Bassi
03fc0dd5ca recent-manager: Add RecentInfo.create_app_info()
A simple wrapper that makes it possible to create a GAppInfo from a
GtkRecentInfo blob.
2010-10-22 11:54:53 +01:00
Tadej Borovšak
55196a705f Add GtkScrollable interface
The GtkScrollable interface provides "hadjustment" and "vadjustment"
properties that are used by GtkScrolledWindow. It replaces
the ::set_scroll_adjustment signal. The scrollable interface
also has ::min-display-width/height properties that can be
used to control the minimally visible part inside a scrolled window.
2010-10-22 11:03:45 +02:00
Christian Dywan
5862075e9d comboboxtext: Add gtk_combo_box_text_remove_all()
https://bugzilla.gnome.org/show_bug.cgi?id=324899
2010-10-21 14:30:11 +02:00
Matthias Clasen
596da84312 Make GtkEntry a no-window widget
Use input-only windows for capturing input, and just draw onto
the parent window. This allows themes to make entries with rounded
corners. Patch by Boram Park.

https://bugzilla.gnome.org/show_bug.cgi?id=632736
2010-10-21 13:17:33 +02:00
Javier Jardón
9f035742e3 gtkapplication: fix docs 2010-10-20 11:07:11 +02:00
Matthias Clasen
0219eea4d7 Remove GtkComboBoxEntry and the combo box text api 2010-10-20 11:02:03 +02:00
Javier Jardón
9b3ee686ea Completely remove gtk_widget_hide_all
This completes commit d1a9d764a8
2010-10-19 20:25:33 +02:00
Matthias Clasen
4824a73084 Add padding to class structs 2010-10-19 19:07:36 +02:00
Javier Jardón
04900c8caa docs: Update templates 2010-10-19 03:31:02 +02:00
Benjamin Otte
ff142ac2ef gtk: Add gtk_widget_queue_draw_region()
People were requesting it and it mirrors the behavior of GdkWindow.
2010-10-18 19:22:44 +02:00
Javier Jardón
f2ae6814e7 docs: Remove template about deprecated GtkItemFactory 2010-10-16 05:24:24 +02:00
Javier Jardón
45c463e376 GtkComboBoxText: Use gtk_combo_box_text_remove instead gtk_combo_box_text_remove_text 2010-10-16 02:07:38 +02:00
Matthias Clasen
50cbd23d5b docs: cross-reference to GtkComboBoxText 2010-10-15 16:58:28 -04:00
Matthias Clasen
3e9bdf6fd9 Add docs for GtkComboBoxText 2010-10-15 16:58:27 -04:00
Javier Jardón
80d3f1fcda docs: update OSX port project page 2010-10-15 20:55:32 +02:00
Alberto Garcia
8d05e74212 Make gtk_accelerator_get_default_mod_mask() return a GdkModifierType
Fixes https://bugzilla.gnome.org/show_bug.cgi?id=313350
2010-10-15 14:46:22 -04:00
Matthias Clasen
921fc8807c Deprecate gtk_init_add, gtk_remove_add and friends
This functions are going to be removed in GTK+ 3.

https://bugzilla.gnome.org/show_bug.cgi?id=629955
2010-10-15 14:13:32 -04:00
Colin Walters
18578b33c5 Add boxed type and constructor
This allows bindings to sanely construct these.

https://bugzilla.gnome.org/show_bug.cgi?id=632095
2010-10-15 13:54:37 -04:00
Matthias Clasen
f87023d8ee Forgotten file 2010-10-15 13:07:08 -04:00
Matthias Clasen
28cb8583c3 docs: move some tutorial content to the reference
We add a "Getting started" chapter that will grow into a
(hopefully) non-outdated, maintained tutorial. For now, it
includes two minimal examples by xincluding them.
2010-10-15 13:02:50 -04:00
Emmanuele Bassi
f085c8b272 docs: Move the introduction of the tutorial in the reference
The tutorial should just go away, but some of its contents can be moved
to the API reference as chapters.

https://bugzilla.gnome.org/show_bug.cgi?id=632059
2010-10-15 13:02:50 -04:00
Matthias Clasen
56e797397b Improve GtkBox and GtkTable docs a bit
This adds some details gleaned from the tutorial, before its
impending demise.
2010-10-15 10:58:35 -04:00
Matthias Clasen
9ff4f0819f Some GDK documentation fixes 2010-10-14 21:45:56 -04:00
Tristan Van Berkom
9612c64817 Deprecate GtkComboBoxEntry in favor of added properties to GtkComboBox
GtkComboBox now sports a construct-only "has-entry" property which
decides if it uses a GtkEntry to allow additional user input. Also
it has a new "entry-text-column" to fetch strings for the entry
from the model.

This patch deprecates the GtkComboBoxEntry and updates the rest of GTK+
to use the new semantics on GtkComboBox instead.

GtkComboBoxEntry will be removed altogether before GTK+ 3, in a
later commit.
2010-10-13 21:52:27 -04:00
Matthias Clasen
7c8ee80c5a Add new API to docs and symbol list 2010-10-13 11:24:56 -04:00
Matthias Clasen
b36819957f Remove GtkWrapBox from the docs, too 2010-10-13 10:21:04 -04:00
Tristan Van Berkom
e3cc39cb98 Removed all traces of GtkWrapBox from GTK+. 2010-10-13 22:26:44 +09:00
Matthias Clasen
c7e024d160 Rework GdkPangoRenderer example to use existing api 2010-10-12 11:29:56 -04:00
Matthias Clasen
abb25b7895 docs: add a longdesc for X-specifics 2010-10-12 11:29:56 -04:00
Matthias Clasen
d8700a02f1 docs: Remove mentions of GdkPixmap from cursor docs 2010-10-12 11:29:55 -04:00
Matthias Clasen
ec7c2acf7b Move GdkVisualType docs inline 2010-10-12 11:29:55 -04:00
Matthias Clasen
4d63d96762 docs: Correct some link targets 2010-10-12 11:29:55 -04:00
Matthias Clasen
f106d369a7 Don't link to old stuff 2010-10-12 01:10:32 -04:00
Matthias Clasen
5a6ea62125 Add a missing close tag 2010-10-12 01:05:39 -04:00
Matthias Clasen
b23dc8477f Remove a note about GTK 1.2 api 2010-10-12 00:57:13 -04:00
Matthias Clasen
6899956770 Reorder some sections 2010-10-12 00:47:49 -04:00
Matthias Clasen
cf1745a935 Remove mentions of dialog separator from the docs 2010-10-12 00:38:04 -04:00
Matthias Clasen
82712a150a Some documentation updates 2010-10-12 00:33:38 -04:00
Javier Jardón
c2ab54a31f docs: Move documentation do inline comments: GtkContainer 2010-10-11 05:13:45 +02:00
Javier Jardón
ee58c6c37d docs: Move documentation to inline comments: GtkScrolledWindow 2010-10-11 02:17:08 +02:00
Matthias Clasen
f8490e425f Add a migration guide section about resize grips 2010-10-08 02:18:15 -04:00
Matthias Clasen
b04bceb47e Remove resize grip handling from GtkStatusbar
We remove the resize grip from GtkStatusbar, but keep the code
that makes the content avoid the grip, and adapt it to GtkWindow
grips.

The gtk_status_bar_set/get_has_resize_grip() functions and related
properties are removed.
2010-10-08 02:14:19 -04:00
Matthias Clasen
f6347baf64 Add resize grips to GtkWindow
Allow any window to display a resize grip, in the south-east or
south-west corner, depending on text direction. This is implemented
as a shaped window that gets overlayed on top of whatever content
is there. We add api that allows widgets to avoid the resize grip,
if desired.

The ::has-resize-grip property controls if a window may display
a resize grip. It will only be displayed if the window is resizable
and not maximized.

The size and visual appearance of the resize grip is under theme
control, using the resize-grip-width/height style properties and
the paint_resize_grip style function.
2010-10-08 02:14:10 -04:00
Javier Jardón
718ccc9e4e docs: visuals: Do not mention deprecated GdkRGB API's
Reported by Milan Bouchet-Valat in bug
https://bugzilla.gnome.org/show_bug.cgi?id=631473
2010-10-06 01:11:19 +02:00
Javier Jardón
cc0ada40b5 docs: reword GtkAdjustment short description 2010-10-05 22:55:08 +02:00
Javier Jardón
97bdf55b6d docs: Move documentation to inline comments: colors 2010-10-04 03:48:05 +02:00
Javier Jardón
9e869af6c5 docs: Move documentation to inline comments: pixbufs 2010-10-04 03:36:12 +02:00
Javier Jardón
a4c2018452 docs: Move documentation to inline comments: regions 2010-10-04 03:19:43 +02:00
Javier Jardón
4e71a4df7b docs: Move documentation to inline comments: cairo_interaction 2010-10-04 03:04:09 +02:00
Javier Jardón
5a30dad531 docs: Move documentation to inline comments: GtkComboBox 2010-10-04 02:37:42 +02:00
Javier Jardón
bbd80b671a docs: Move documentation to inline comments: GtkNotebook 2010-10-03 20:21:48 +02:00
Javier Jardón
c4705377f4 docs: Latest 2.x release will be 2.24, not 2.22 2010-10-03 04:59:23 +02:00
Javier Jardón
2a9d299aa3 docs: Use gtk_widget_get_preferred_size() instead gtk_size_request_get_preferred_size()
GtkSizeRequest interface is now merged in GtkWidget
2010-10-03 03:42:31 +02:00
Garrett Regier
78bd97bfbe docs: Move documentation to inline comments: GtkEntryBuffer
Fixes https://bugzilla.gnome.org/show_bug.cgi?id=617320

Signed-off-by: Javier Jardón <jjardon@gnome.org>
2010-10-03 01:21:38 +02:00
Javier Jardón
ccaf842919 docs: Move documentation to inline comments: GtkTooltip 2010-10-03 00:59:39 +02:00
Javier Jardón
3846988211 docs: Move documentation to inline comments: GtkToolbar 2010-10-03 00:30:25 +02:00
Garrett Regier
5fcf06bb91 docs: Move documentation to inline comments: GtkComboBoxEntry
Fixes https://bugzilla.gnome.org/show_bug.cgi?id=617308

Signed-off-by: Javier Jardón <jjardon@gnome.org>
2010-10-02 22:39:35 +02:00
Matthias Clasen
fc2da1a137 Migration guide: Add an example for creating custom cursors 2010-10-01 14:54:11 -04:00
Matthias Clasen
86665897db Revert an erroneous change 2010-10-01 13:46:39 -04:00
Matthias Clasen
0bca60fdd3 GTK docs: various fixups 2010-10-01 13:05:12 -04:00
Matthias Clasen
32d1defc76 GDK docs: help gtk-doc understand gdk_window_invalidate_maybe_recurse 2010-10-01 09:10:52 -04:00
Matthias Clasen
4e96a84c67 GDK docs: Clean out some dead symbols 2010-10-01 08:09:31 -04:00
Javier Jardón
b072ea220c Remove unneded casts
As gtk_adjustment_new() returns a GtkAdjustment* now

https://bugzilla.gnome.org/show_bug.cgi?id=630731
2010-09-29 01:18:10 +02:00
Benjamin Otte
948768c708 API: remove gtk_window_set_visual()
gtk_widget_set_visual() exists now and can be used instead.

This reverts commit 59b227e123.
2010-09-28 19:13:24 +02:00
Benjamin Otte
5ac6234815 API: gtk: Add gtk_widget_set_visual()
It turns out that the previous handling of just providing a way to set
visuals just on toplevels was not sufficient. In particular it
complicated the various implementations of the tray icon specification.
This patch reintroduces gtk_widget_set_visual() which behaves very
similar to GTK2's gtk_widget_set_colormap().

A future commit will remove the gtk_window_set_visual() function.
2010-09-28 19:11:21 +02:00
Matthias Clasen
87e29c99d7 Add a migration guide section on GtkObject 2010-09-26 22:29:33 -04:00
Matthias Clasen
b81de973af Remove GtkObject from the docs 2010-09-26 22:18:46 -04:00
Matthias Clasen
f53ad33994 Remove GtkObject completely 2010-09-26 22:18:19 -04:00
Javier Jardón
945e97e505 Move documentation to inline comments: GtkPaperSize 2010-09-27 03:49:49 +02:00
Javier Jardón
e267ed84db Move documentation to inline comments: GtkAccelMap 2010-09-27 02:56:25 +02:00
Matthias Clasen
aa8561aac2 Add a missing end tag 2010-09-26 20:42:07 -04:00
Matthias Clasen
b522a1b367 Migration guide: Add an example for colormap -> visual 2010-09-26 15:11:46 +02:00
Matthias Clasen
d3a90eae72 Expand the migration guide
This commit add some text about mult-window ::draw implementations,
pointing out the gtk_cairo_should_draw_window() and
gtk_cairo_transform_to_window() convenience functions.
2010-09-26 15:11:46 +02:00
Benjamin Otte
0795f1e0c9 API: Add gtk_cairo_transform_to_window()
The function reverses the transform that GTK does before emitting a draw
event. So we can use it in "old" widgets to revert the coordinate system
properly.
2010-09-26 15:11:45 +02:00
Benjamin Otte
d9c9259861 Move GtkSizeRequest into GtkWidget
It doesn't make sense to keep them separate as GtkSizeRequest requires a
GtkWidget and GtkWidget implements GtkSizeRequest, so you can never have
one without the other.
It also makes the code a lot easier because no casts are required when
calling functions.

Also, the names would translate to gtk_widget_get_width() and people
agreed that this would be a too generic name, so a "preferred" was added
to the names.

So this patch moves the functions:
gtk_size_request_get_request_mode() => gtk_widget_get_request_mode()
gtk_size_request_get_width() => gtk_widget_get_preferred_width()
gtk_size_request_get_height() => gtk_widget_get_preferred_height()
gtk_size_request_get_size() => gtk_widget_get_preferred_size()
gtk_size_request_get_width_for_height() =>
  gtk_widget_get_preferred_width_for_height()
gtk_size_request_get_height_for_width() =>
  gtk_widget_get_preferred_height_for_width()
... and moves the corresponding vfuncs to the GtkWidgetClass.

The patch also renames the implementations of the vfuncs in widgets to
include the word "preferrred".
2010-09-26 15:11:45 +02:00
Benjamin Otte
f52a1fcfbd API: remove gdk_drawable_get_size() 2010-09-26 15:11:45 +02:00