forked from AuroraMiddleware/gtk
Clean up lots of GTK+ -> GTK
Replace most remaining uses of GTK+ in the docs and user-visible strings by GTK. Also remove some leftover "Was added in 3.x" sentences from the docs.
This commit is contained in:
parent
6ed1c181ee
commit
929a56e53c
@ -594,7 +594,7 @@ gdk_device_get_axis_use (GdkDevice *device,
|
||||
* Returns the #GdkDisplay to which @device pertains.
|
||||
*
|
||||
* Returns: (transfer none): a #GdkDisplay. This memory is owned
|
||||
* by GTK+, and must not be freed or unreffed.
|
||||
* by GTK, and must not be freed or unreffed.
|
||||
**/
|
||||
GdkDisplay *
|
||||
gdk_device_get_display (GdkDevice *device)
|
||||
|
@ -1145,7 +1145,7 @@ _gdk_display_get_next_serial (GdkDisplay *display)
|
||||
* Indicates to the GUI environment that the application has
|
||||
* finished loading, using a given identifier.
|
||||
*
|
||||
* GTK+ will call this function automatically for #GtkWindow
|
||||
* GTK will call this function automatically for #GtkWindow
|
||||
* with custom startup-notification identifier unless
|
||||
* gtk_window_set_auto_startup_notification() is called to
|
||||
* disable that feature.
|
||||
|
@ -301,9 +301,9 @@ typedef enum
|
||||
* @GDK_CROSSING_NORMAL: crossing because of pointer motion.
|
||||
* @GDK_CROSSING_GRAB: crossing because a grab is activated.
|
||||
* @GDK_CROSSING_UNGRAB: crossing because a grab is deactivated.
|
||||
* @GDK_CROSSING_GTK_GRAB: crossing because a GTK+ grab is activated.
|
||||
* @GDK_CROSSING_GTK_UNGRAB: crossing because a GTK+ grab is deactivated.
|
||||
* @GDK_CROSSING_STATE_CHANGED: crossing because a GTK+ widget changed
|
||||
* @GDK_CROSSING_GTK_GRAB: crossing because a GTK grab is activated.
|
||||
* @GDK_CROSSING_GTK_UNGRAB: crossing because a GTK grab is deactivated.
|
||||
* @GDK_CROSSING_STATE_CHANGED: crossing because a GTK widget changed
|
||||
* state (e.g. sensitivity).
|
||||
* @GDK_CROSSING_TOUCH_BEGIN: crossing because a touch sequence has begun,
|
||||
* this event is synthetic as the pointer might have not left the surface.
|
||||
|
@ -30,13 +30,13 @@
|
||||
* @Short_description: Using Pango in GDK
|
||||
* @Title: Pango Interaction
|
||||
*
|
||||
* Pango is the text layout system used by GDK and GTK+. The functions
|
||||
* Pango is the text layout system used by GDK and GTK. The functions
|
||||
* and types in this section are used to obtain clip regions for
|
||||
* #PangoLayouts, and to get #PangoContexts that can be used with
|
||||
* GDK.
|
||||
*
|
||||
* Creating a #PangoLayout object is the first step in rendering text,
|
||||
* and requires getting a handle to a #PangoContext. For GTK+ programs,
|
||||
* and requires getting a handle to a #PangoContext. For GTK programs,
|
||||
* you’ll usually want to use gtk_widget_get_pango_context(), or
|
||||
* gtk_widget_create_pango_layout(). Once you have a #PangoLayout,
|
||||
* you can set the text and attributes of it with Pango functions like
|
||||
|
@ -525,7 +525,7 @@
|
||||
|
||||
[self setFrame:new_frame display:YES];
|
||||
|
||||
/* Let the resizing be handled by GTK+. */
|
||||
/* Let the resizing be handled by GTK. */
|
||||
if (g_main_context_pending (NULL))
|
||||
g_main_context_iteration (NULL, FALSE);
|
||||
|
||||
|
@ -300,7 +300,7 @@ gdk_macos_keymap_update (GdkMacosKeymap *self)
|
||||
}
|
||||
}
|
||||
|
||||
/* Special-case shift-tab since GTK+ expects
|
||||
/* Special-case shift-tab since GTK expects
|
||||
* GDK_KEY_ISO_Left_Tab for that.
|
||||
*/
|
||||
if (found && p[j] == GDK_KEY_Tab && modifiers[j] == shiftKey)
|
||||
|
@ -1795,7 +1795,7 @@ gdk_wayland_surface_create_xdg_toplevel (GdkSurface *surface)
|
||||
app_id = g_get_prgname ();
|
||||
|
||||
if (app_id == NULL)
|
||||
app_id = "GTK+ Application";
|
||||
app_id = "GTK Application";
|
||||
|
||||
gdk_wayland_surface_set_application_id (surface, app_id);
|
||||
|
||||
@ -2587,7 +2587,7 @@ find_grab_input_seat (GdkSurface *surface,
|
||||
GdkWaylandSurface *tmp_impl;
|
||||
|
||||
/* Use the device that was used for the grab as the device for
|
||||
* the popup surface setup - so this relies on GTK+ taking the
|
||||
* the popup surface setup - so this relies on GTK taking the
|
||||
* grab before showing the popup surface.
|
||||
*/
|
||||
if (impl->grab_input_seat)
|
||||
@ -2611,7 +2611,7 @@ should_be_mapped (GdkSurface *surface)
|
||||
{
|
||||
GdkWaylandSurface *impl = GDK_WAYLAND_SURFACE (surface);
|
||||
|
||||
/* Don't map crazy temp that GTK+ uses for internal X11 shenanigans. */
|
||||
/* Don't map crazy temp that GTK uses for internal X11 shenanigans. */
|
||||
if (GDK_IS_DRAG_SURFACE (surface) && surface->x < 0 && surface->y < 0)
|
||||
return FALSE;
|
||||
|
||||
|
@ -24,9 +24,9 @@
|
||||
*/
|
||||
|
||||
/*
|
||||
GTK+ has two clipboards - normal clipboard and primary clipboard
|
||||
GTK has two clipboards - normal clipboard and primary clipboard
|
||||
Primary clipboard is only handled
|
||||
internally by GTK+ (it's not portable to Windows).
|
||||
internally by GTK (it's not portable to Windows).
|
||||
|
||||
("C:" means clipboard client (requestor), "S:" means clipboard server (provider))
|
||||
("transmute" here means "change the format of some data"; this term is used here
|
||||
@ -34,7 +34,7 @@ internally by GTK+ (it's not portable to Windows).
|
||||
which are completely unrelated)
|
||||
|
||||
For Clipboard:
|
||||
GTK+ calls one of the gdk_clipboard_set* () functions (either supplying
|
||||
GTK calls one of the gdk_clipboard_set* () functions (either supplying
|
||||
its own content provider, or giving a GTyped data for which GDK will
|
||||
create a content provider automatically).
|
||||
That function associates the content provider with the clipboard and calls
|
||||
@ -53,12 +53,12 @@ No data is sent anywhere.
|
||||
The content provider has a callback, which will be invoked every time
|
||||
the data from this provider is needed.
|
||||
|
||||
GTK+ might also call gdk_clipboard_store_async(), which instructs
|
||||
GTK might also call gdk_clipboard_store_async(), which instructs
|
||||
the backend to put the data into the OS clipboard manager (if
|
||||
supported and available) so that it remains available for other
|
||||
processes after the clipboard owner terminates.
|
||||
|
||||
When something needs to be obtained from clipboard, GTK+ calls
|
||||
When something needs to be obtained from clipboard, GTK calls
|
||||
C: gdk_clipboard_read_async () -> gdk_clipboard_read_internal (),
|
||||
providing it with a string-array of mime/types, which is internally
|
||||
converted into a GdkContentFormats object.
|
||||
@ -118,7 +118,7 @@ The thread remembers the fact that it has clipboard open, and does
|
||||
not try to close & reopen it, unless that is strictly necessary.
|
||||
The clipboard is closed after each queue processing run.
|
||||
|
||||
GTK+ calls one of the gdk_clipboard_set* () functions (either supplying
|
||||
GTK calls one of the gdk_clipboard_set* () functions (either supplying
|
||||
its own content provider, or giving a GTyped data for which GDK will
|
||||
create a content provider automatically).
|
||||
That function associates the content provider with the clipboard and calls
|
||||
@ -145,7 +145,7 @@ No data is sent anywhere.
|
||||
The content provider has a callback, which will be invoked every time
|
||||
the data from this provider is needed.
|
||||
|
||||
GTK+ might also call gdk_clipboard_store_async(), which instructs
|
||||
GTK might also call gdk_clipboard_store_async(), which instructs
|
||||
the W32 backend to put the data into the OS clipboard manager by
|
||||
sending WM_RENDERALLFORMATS to itself and then handling it normally.
|
||||
|
||||
@ -168,7 +168,7 @@ The cached remote formats are then mapped into GDK contentformats.
|
||||
This map is separate from the one that maps supported GDK contentformats
|
||||
to W32 formats for locally-claimed clipboards.
|
||||
|
||||
When something needs to be obtained from clipboard, GTK+ calls
|
||||
When something needs to be obtained from clipboard, GTK calls
|
||||
C: gdk_clipboard_read_async () -> gdk_clipboard_read_internal (),
|
||||
providing it with a string-array of mime/types, which is internally
|
||||
converted into a GdkContentFormats object.
|
||||
@ -233,7 +233,7 @@ functions that read arbitrary GTypes (as long as they are serializable),
|
||||
texts (strings) or textures (GdkPixbufs) this way.
|
||||
|
||||
If data must be stored on the clipboard, because the application is quitting,
|
||||
GTK+ will call
|
||||
GTK will call
|
||||
S: gdk_clipboard_store_async()
|
||||
on all the clipboards it owns. This creates multiple write stream (one for each
|
||||
format being stored), each backed by a HGLOBAL memory object. Once all memory
|
||||
@ -1572,7 +1572,7 @@ gdk_win32_clipdrop_init (GdkWin32Clipdrop *win32_clipdrop)
|
||||
_gdk_atom_array_index (atoms, GDK_WIN32_ATOM_INDEX_JFIF) = g_intern_static_string ("JFIF");
|
||||
_gdk_atom_array_index (atoms, GDK_WIN32_ATOM_INDEX_GIF) = g_intern_static_string ("GIF");
|
||||
|
||||
/* These are a bit unusual. It's here to allow GTK+ applications
|
||||
/* These are a bit unusual. It's here to allow GTK applications
|
||||
* to actually support CF_DIB and Shell ID List clipboard formats on their own,
|
||||
* instead of allowing GDK to use them internally for interoperability.
|
||||
*/
|
||||
@ -1634,7 +1634,7 @@ gdk_win32_clipdrop_init (GdkWin32Clipdrop *win32_clipdrop)
|
||||
|
||||
win32_clipdrop->compatibility_w32formats = g_hash_table_new_full (NULL, NULL, NULL, (GDestroyNotify) g_array_unref);
|
||||
|
||||
/* GTK+ actually has more text formats, but it's unlikely that we'd
|
||||
/* GTK actually has more text formats, but it's unlikely that we'd
|
||||
* get anything other than UTF8_STRING these days.
|
||||
* GTKTEXTBUFFERCONTENTS format can potentially be converted to
|
||||
* W32-compatible rich text format, but that's too complex to address right now.
|
||||
|
@ -57,7 +57,7 @@ static int debug_indent = 0;
|
||||
*
|
||||
* Adds an event filter to @window, allowing you to intercept messages
|
||||
* before they reach GDK. This is a low-level operation and makes it
|
||||
* easy to break GDK and/or GTK+, so you have to know what you're
|
||||
* easy to break GDK and/or GTK, so you have to know what you're
|
||||
* doing.
|
||||
**/
|
||||
void
|
||||
|
@ -46,27 +46,27 @@
|
||||
* the window.
|
||||
*
|
||||
* There's a mismatch between data types supported by W32 (W32 formats)
|
||||
* and by GTK+ (GDK contentformats).
|
||||
* and by GTK (GDK contentformats).
|
||||
* To account for it the data is transmuted back and forth. There are two
|
||||
* main points of transmutation:
|
||||
* * GdkWin32HDATAOutputStream: transmutes GTK+ data to W32 data
|
||||
* * GdkWin32Drop: transmutes W32 data to GTK+ data
|
||||
* * GdkWin32HDATAOutputStream: transmutes GTK data to W32 data
|
||||
* * GdkWin32Drop: transmutes W32 data to GTK data
|
||||
*
|
||||
* There are also two points where data formats are considered:
|
||||
* * When source drag context is created, it gets a list of GDK contentformats
|
||||
* that it supports, these are matched to the W32 formats they
|
||||
* correspond to (possibly with transmutation). New W32 formats for
|
||||
* GTK+-specific contentformats are also created here (see below).
|
||||
* GTK-specific contentformats are also created here (see below).
|
||||
* * When target drop context is created, it queries the IDataObject
|
||||
* for the list of W32 formats it supports and matches these to
|
||||
* corresponding GDK contentformats that it will be able to provide
|
||||
* (possibly with transmutation) later. Missing GDK contentformats for
|
||||
* W32-specific formats are also created here (see below).
|
||||
*
|
||||
* W32 formats are integers (CLIPFORMAT), while GTK+ contentformats
|
||||
* W32 formats are integers (CLIPFORMAT), while GTK contentformats
|
||||
* are mime/type strings, and cannot be used interchangeably.
|
||||
*
|
||||
* To accommodate advanced GTK+ applications the code allows them to
|
||||
* To accommodate advanced GTK applications the code allows them to
|
||||
* register drop targets that accept W32 data formats, and to register
|
||||
* drag sources that provide W32 data formats. To do that they must
|
||||
* register with the mime/type "application/x.windows.ZZZ", where
|
||||
@ -77,36 +77,36 @@
|
||||
* If such contentformat is accepted/provided, GDK will not try to
|
||||
* transmute it to/from something else. Otherwise GDK will do the following
|
||||
* transmutation:
|
||||
* * If GTK+ application provides image/png, image/gif or image/jpeg,
|
||||
* * If GTK application provides image/png, image/gif or image/jpeg,
|
||||
* GDK will claim to also provide "PNG", "GIF" or "JFIF" respectively,
|
||||
* and will pass these along verbatim.
|
||||
* * If GTK+ application provides any GdkPixbuf-compatible contentformat,
|
||||
* * If GTK application provides any GdkPixbuf-compatible contentformat,
|
||||
* GDK will also offer "PNG" and CF_DIB W32 formats.
|
||||
* * If GTK+ application provides text/plain;charset=utf8, GDK will also offer
|
||||
* * If GTK application provides text/plain;charset=utf8, GDK will also offer
|
||||
* CF_UNICODETEXT (UTF-16-encoded) and CF_TEXT (encoded with thread-
|
||||
* and locale-dependent codepage), and will do the conversion when such
|
||||
* data is requested.
|
||||
* * If GTK+ application accepts image/png, image/gif or image/jpeg,
|
||||
* * If GTK application accepts image/png, image/gif or image/jpeg,
|
||||
* GDK will claim to also accept "PNG", "GIF" or "JFIF" respectively,
|
||||
* and will pass these along verbatim.
|
||||
* * If GTK+ application accepts image/bmp, GDK will
|
||||
* * If GTK application accepts image/bmp, GDK will
|
||||
* claim to accept CF_DIB W32 format, and will convert
|
||||
* it, changing the header, when such data is provided.
|
||||
* * If GTK+ application accepts text/plain;charset=utf8, GDK will
|
||||
* * If GTK application accepts text/plain;charset=utf8, GDK will
|
||||
* claim to accept CF_UNICODETEXT and CF_TEXT, and will do
|
||||
* the conversion when such data is provided.
|
||||
* * If GTK+ application accepts text/uri-list, GDK will
|
||||
* * If GTK application accepts text/uri-list, GDK will
|
||||
* claim to accept "Shell IDList Array", and will do the
|
||||
* conversion when such data is provided.
|
||||
*
|
||||
* Currently the conversion from text/uri-list to "Shell IDList Array" is not
|
||||
* implemented, so it's not possible to drag & drop files from GTK+
|
||||
* applications to non-GTK+ applications the same way one can drag files
|
||||
* implemented, so it's not possible to drag & drop files from GTK
|
||||
* applications to non-GTK applications the same way one can drag files
|
||||
* from Windows Explorer.
|
||||
*
|
||||
* To increase inter-GTK compatibility, GDK will register GTK+-specific
|
||||
* To increase inter-GTK compatibility, GDK will register GTK-specific
|
||||
* formats by their mime/types, as-is (i.e "text/plain;charset=utf-8", for example).
|
||||
* That way two GTK+ applications can exchange data in their native formats
|
||||
* That way two GTK applications can exchange data in their native formats
|
||||
* (both well-known ones, such as text/plain;charset=utf8, and special,
|
||||
* known only to specific applications). This will work just
|
||||
* fine as long as both applications agree on what kind of data is stored
|
||||
@ -118,7 +118,7 @@
|
||||
* If more flexibility is needed, register one format that has some
|
||||
* internal indicators of the kind of data it contains, then write the application
|
||||
* in such a way that it requests the data and inspects its header before deciding
|
||||
* whether to accept it or not. For details see GTK+ drag & drop documentation
|
||||
* whether to accept it or not. For details see GTK drag & drop documentation
|
||||
* on the "drag-motion" and "drag-data-received" signals.
|
||||
*
|
||||
* How managed DnD works:
|
||||
|
@ -1007,7 +1007,7 @@ gdk_dropfiles_filter (GdkWin32Display *display,
|
||||
/* Awful hack to recognize temp files corresponding to
|
||||
* images dragged from Firefox... Open the file right here
|
||||
* so that it is less likely that Firefox manages to delete
|
||||
* it before the GTK+-using app (typically GIMP) has opened
|
||||
* it before the GTK-using app (typically GIMP) has opened
|
||||
* it.
|
||||
*
|
||||
* Not compiled in for now, because it means images dragged
|
||||
|
@ -1422,13 +1422,13 @@ gdk_x11_drag_drag_motion (GdkDrag *drag,
|
||||
|
||||
if (protocol == GDK_DRAG_PROTO_XDND && drag_x11->version == 0)
|
||||
{
|
||||
/* This ugly hack is necessary since GTK+ doesn't know about
|
||||
/* This ugly hack is necessary since GTK doesn't know about
|
||||
* the XDND protocol version, and in particular doesn't know
|
||||
* that gdk_drag_find_window() has the side-effect
|
||||
* of setting drag_x11->version, and therefore sometimes call
|
||||
* gdk_x11_drag_drag_motion() without a prior call to
|
||||
* gdk_drag_find_window(). This happens, e.g.
|
||||
* when GTK+ is proxying DND events to embedded windows.
|
||||
* when GTK is proxying DND events to embedded windows.
|
||||
*/
|
||||
if (proxy_xid)
|
||||
{
|
||||
@ -1517,7 +1517,7 @@ gdk_x11_drag_drag_motion (GdkDrag *drag,
|
||||
case GDK_DRAG_PROTO_ROOTWIN:
|
||||
{
|
||||
GdkContentFormats *formats = gdk_drag_get_formats (drag);
|
||||
/* GTK+ traditionally has used application/x-rootwin-drop,
|
||||
/* GTK traditionally has used application/x-rootwin-drop,
|
||||
* but the XDND spec specifies x-rootwindow-drop.
|
||||
*/
|
||||
if (gdk_content_formats_contain_mime_type (formats, "application/x-rootwindow-drop") ||
|
||||
|
@ -2845,14 +2845,14 @@ gdk_x11_surface_set_shadow_width (GdkSurface *surface,
|
||||
* @surface: (type GdkX11Surface): a #GdkSurface
|
||||
* @variant: the theme variant to export
|
||||
*
|
||||
* GTK+ applications can request a dark theme variant. In order to
|
||||
* make other applications - namely window managers using GTK+ for
|
||||
* themeing - aware of this choice, GTK+ uses this function to
|
||||
* GTK applications can request a dark theme variant. In order to
|
||||
* make other applications - namely window managers using GTK for
|
||||
* themeing - aware of this choice, GTK uses this function to
|
||||
* export the requested theme variant as _GTK_THEME_VARIANT property
|
||||
* on toplevel surfaces.
|
||||
*
|
||||
* Note that this property is automatically updated by GTK+, so this
|
||||
* function should only be used by applications which do not use GTK+
|
||||
* Note that this property is automatically updated by GTK, so this
|
||||
* function should only be used by applications which do not use GTK
|
||||
* to create toplevel surfaces.
|
||||
*/
|
||||
void
|
||||
|
@ -2460,10 +2460,10 @@ render_node_print (Printer *p,
|
||||
*
|
||||
* Serializes the @node for later deserialization via
|
||||
* gsk_render_node_deserialize(). No guarantees are made about the format
|
||||
* used other than that the same version of GTK+ will be able to deserialize
|
||||
* used other than that the same version of GTK will be able to deserialize
|
||||
* the result of a call to gsk_render_node_serialize() and
|
||||
* gsk_render_node_deserialize() will correctly reject files it cannot open
|
||||
* that were created with previous versions of GTK+.
|
||||
* that were created with previous versions of GTK.
|
||||
*
|
||||
* The intended use of this functions is testing, benchmarking and debugging.
|
||||
* The format is not meant as a permanent storage format.
|
||||
|
@ -272,7 +272,7 @@ gtk_assistant_page_class_init (GtkAssistantPageClass *class)
|
||||
* GtkAssistantPage:complete:
|
||||
*
|
||||
* Setting the "complete" property to %TRUE marks a page as
|
||||
* complete (i.e.: all the required fields are filled out). GTK+ uses
|
||||
* complete (i.e.: all the required fields are filled out). GTK uses
|
||||
* this information to control the sensitivity of the navigation buttons.
|
||||
*/
|
||||
g_object_class_install_property (object_class,
|
||||
@ -2042,7 +2042,7 @@ gtk_assistant_get_page_complete (GtkAssistant *assistant,
|
||||
*
|
||||
* Forces @assistant to recompute the buttons state.
|
||||
*
|
||||
* GTK+ automatically takes care of this in most situations,
|
||||
* GTK automatically takes care of this in most situations,
|
||||
* e.g. when the user goes to a different page, or when the
|
||||
* visibility or completeness of a page changes.
|
||||
*
|
||||
|
@ -27,7 +27,7 @@
|
||||
* parsing custom tags and constructing child objects.
|
||||
*
|
||||
* The GtkBuildable interface is implemented by all widgets and
|
||||
* many of the non-widget objects that are provided by GTK+. The
|
||||
* many of the non-widget objects that are provided by GTK. The
|
||||
* main user of this interface is #GtkBuilder. There should be
|
||||
* very little need for applications to call any of these functions directly.
|
||||
*
|
||||
|
@ -56,7 +56,7 @@ typedef struct _GtkBuilderClass GtkBuilderClass;
|
||||
* @GTK_BUILDER_ERROR_INVALID_VALUE: #GtkBuilder couldn’t parse
|
||||
* some attribute value.
|
||||
* @GTK_BUILDER_ERROR_VERSION_MISMATCH: The input file requires a newer version
|
||||
* of GTK+.
|
||||
* of GTK.
|
||||
* @GTK_BUILDER_ERROR_DUPLICATE_ID: An object id occurred twice.
|
||||
* @GTK_BUILDER_ERROR_OBJECT_TYPE_REFUSED: A specified object type is of the same type or
|
||||
* derived from the type of the composite class being extended with builder XML.
|
||||
|
@ -39,7 +39,7 @@
|
||||
*
|
||||
* As outlined in
|
||||
* [GtkWidget’s geometry management section][geometry-management],
|
||||
* GTK+ uses a height-for-width
|
||||
* GTK uses a height-for-width
|
||||
* geometry management system to compute the sizes of widgets and user
|
||||
* interfaces. #GtkCellArea uses the same semantics to calculate the
|
||||
* size of an area for an arbitrary number of #GtkTreeModel rows.
|
||||
|
@ -58,7 +58,7 @@
|
||||
* ]|
|
||||
*
|
||||
* Furthermore for implementations of GtkCellLayout that use a #GtkCellArea
|
||||
* to lay out cells (all GtkCellLayouts in GTK+ use a GtkCellArea)
|
||||
* to lay out cells (all GtkCellLayouts in GTK use a GtkCellArea)
|
||||
* [cell properties][cell-properties] can also be defined in the format by
|
||||
* specifying the custom <cell-packing> attribute which can contain multiple
|
||||
* <property> elements defined in the normal way.
|
||||
|
@ -242,7 +242,7 @@ gtk_cell_renderer_class_init (GtkCellRendererClass *class)
|
||||
* See gtk_cell_editable_start_editing() for information on the lifecycle of
|
||||
* the @editable and a way to do setup that doesn’t depend on the @renderer.
|
||||
*
|
||||
* Note that GTK+ doesn't guarantee that cell renderers will
|
||||
* Note that GTK doesn't guarantee that cell renderers will
|
||||
* continue to use the same kind of widget for editing in future
|
||||
* releases, therefore you should check the type of @editable
|
||||
* before doing any specific setup, as in the following example:
|
||||
|
@ -40,8 +40,6 @@
|
||||
* #GtkCellRendererAccel displays a keyboard accelerator (i.e. a key
|
||||
* combination like `Control + a`). If the cell renderer is editable,
|
||||
* the accelerator can be changed by simply typing the new combination.
|
||||
*
|
||||
* The #GtkCellRendererAccel cell renderer was added in GTK+ 2.10.
|
||||
*/
|
||||
|
||||
|
||||
@ -215,9 +213,9 @@ gtk_cell_renderer_accel_class_init (GtkCellRendererAccelClass *cell_accel_class)
|
||||
/**
|
||||
* GtkCellRendererAccel:accel-mode:
|
||||
*
|
||||
* Determines if the edited accelerators are GTK+ accelerators. If
|
||||
* Determines if the edited accelerators are GTK accelerators. If
|
||||
* they are, consumed modifiers are suppressed, only accelerators
|
||||
* accepted by GTK+ are allowed, and the accelerators are rendered
|
||||
* accepted by GTK are allowed, and the accelerators are rendered
|
||||
* in the same way as they are in menus.
|
||||
*/
|
||||
g_object_class_install_property (object_class,
|
||||
|
@ -34,12 +34,12 @@ typedef struct _GtkCellRendererAccel GtkCellRendererAccel;
|
||||
|
||||
/**
|
||||
* GtkCellRendererAccelMode:
|
||||
* @GTK_CELL_RENDERER_ACCEL_MODE_GTK: GTK+ accelerators mode
|
||||
* @GTK_CELL_RENDERER_ACCEL_MODE_GTK: GTK accelerators mode
|
||||
* @GTK_CELL_RENDERER_ACCEL_MODE_OTHER: Other accelerator mode
|
||||
*
|
||||
* Determines if the edited accelerators are GTK+ accelerators. If
|
||||
* Determines if the edited accelerators are GTK accelerators. If
|
||||
* they are, consumed modifiers are suppressed, only accelerators
|
||||
* accepted by GTK+ are allowed, and the accelerators are rendered
|
||||
* accepted by GTK are allowed, and the accelerators are rendered
|
||||
* in the same way as they are in menus.
|
||||
*/
|
||||
typedef enum
|
||||
|
@ -43,8 +43,6 @@
|
||||
* box and sets it to display the column specified by its
|
||||
* #GtkCellRendererCombo:text-column property. Further properties of the combo box
|
||||
* can be set in a handler for the #GtkCellRenderer::editing-started signal.
|
||||
*
|
||||
* The #GtkCellRendererCombo cell renderer was added in GTK+ 2.6.
|
||||
*/
|
||||
|
||||
typedef struct _GtkCellRendererComboPrivate GtkCellRendererComboPrivate;
|
||||
|
@ -41,8 +41,6 @@
|
||||
*
|
||||
* #GtkCellRendererProgress renders a numeric value as a progress par in a cell.
|
||||
* Additionally, it can display a text on top of the progress bar.
|
||||
*
|
||||
* The #GtkCellRendererProgress cell renderer was added in GTK+ 2.6.
|
||||
*/
|
||||
|
||||
|
||||
|
@ -36,7 +36,7 @@
|
||||
* for choosing colors. Depending on the situation, colors may be
|
||||
* allowed to have alpha (translucency).
|
||||
*
|
||||
* In GTK+, the main widgets that implement this interface are
|
||||
* In GTK, the main widgets that implement this interface are
|
||||
* #GtkColorChooserWidget, #GtkColorChooserDialog and #GtkColorButton.
|
||||
*/
|
||||
|
||||
|
@ -1373,8 +1373,8 @@ gtk_combo_box_popup (GtkComboBox *combo_box)
|
||||
* @device: a #GdkDevice
|
||||
*
|
||||
* Pops up the menu of @combo_box. Note that currently this does not do anything
|
||||
* with the device, as it was previously only used for list-mode ComboBoxes,
|
||||
* and those were removed in GTK+ 4. However, it is retained in case similar
|
||||
* with the device, as it was previously only used for list-mode combo boxes,
|
||||
* and those were removed in GTK 4. However, it is retained in case similar
|
||||
* functionality is added back later.
|
||||
**/
|
||||
void
|
||||
|
@ -111,7 +111,7 @@ parse_compose_value (GtkComposeData *compose_data,
|
||||
|
||||
if (g_utf8_get_char (g_utf8_next_char (words[1])) > 0)
|
||||
{
|
||||
g_warning ("GTK+ supports to output one char only: %s: %s", val, line);
|
||||
g_warning ("GTK supports to output one char only: %s: %s", val, line);
|
||||
goto fail;
|
||||
}
|
||||
|
||||
|
@ -55,7 +55,7 @@
|
||||
* of input, e.g. to display a message, ask a question, or anything else
|
||||
* that does not require extensive effort on the user’s part.
|
||||
*
|
||||
* GTK+ treats a dialog as a window split vertically. The top section is a
|
||||
* GTK treats a dialog as a window split vertically. The top section is a
|
||||
* #GtkBox, and is where widgets such as a #GtkLabel or a #GtkEntry should
|
||||
* be packed. The bottom area is known as the
|
||||
* “action area”. This is generally used for
|
||||
@ -76,7 +76,7 @@
|
||||
* If you add buttons to #GtkDialog using gtk_dialog_new_with_buttons(),
|
||||
* gtk_dialog_add_button(), gtk_dialog_add_buttons(), or
|
||||
* gtk_dialog_add_action_widget(), clicking the button will emit a signal
|
||||
* called #GtkDialog::response with a response ID that you specified. GTK+
|
||||
* called #GtkDialog::response with a response ID that you specified. GTK
|
||||
* will never assign a meaning to positive response IDs; these are entirely
|
||||
* user-defined. But for convenience, you can use the response IDs in the
|
||||
* #GtkResponseType enumeration (these all have values less than zero). If
|
||||
|
@ -55,19 +55,19 @@ typedef enum
|
||||
* GtkResponseType:
|
||||
* @GTK_RESPONSE_NONE: Returned if an action widget has no response id,
|
||||
* or if the dialog gets programmatically hidden or destroyed
|
||||
* @GTK_RESPONSE_REJECT: Generic response id, not used by GTK+ dialogs
|
||||
* @GTK_RESPONSE_ACCEPT: Generic response id, not used by GTK+ dialogs
|
||||
* @GTK_RESPONSE_REJECT: Generic response id, not used by GTK dialogs
|
||||
* @GTK_RESPONSE_ACCEPT: Generic response id, not used by GTK dialogs
|
||||
* @GTK_RESPONSE_DELETE_EVENT: Returned if the dialog is deleted
|
||||
* @GTK_RESPONSE_OK: Returned by OK buttons in GTK+ dialogs
|
||||
* @GTK_RESPONSE_CANCEL: Returned by Cancel buttons in GTK+ dialogs
|
||||
* @GTK_RESPONSE_CLOSE: Returned by Close buttons in GTK+ dialogs
|
||||
* @GTK_RESPONSE_YES: Returned by Yes buttons in GTK+ dialogs
|
||||
* @GTK_RESPONSE_NO: Returned by No buttons in GTK+ dialogs
|
||||
* @GTK_RESPONSE_APPLY: Returned by Apply buttons in GTK+ dialogs
|
||||
* @GTK_RESPONSE_HELP: Returned by Help buttons in GTK+ dialogs
|
||||
* @GTK_RESPONSE_OK: Returned by OK buttons in GTK dialogs
|
||||
* @GTK_RESPONSE_CANCEL: Returned by Cancel buttons in GTK dialogs
|
||||
* @GTK_RESPONSE_CLOSE: Returned by Close buttons in GTK dialogs
|
||||
* @GTK_RESPONSE_YES: Returned by Yes buttons in GTK dialogs
|
||||
* @GTK_RESPONSE_NO: Returned by No buttons in GTK dialogs
|
||||
* @GTK_RESPONSE_APPLY: Returned by Apply buttons in GTK dialogs
|
||||
* @GTK_RESPONSE_HELP: Returned by Help buttons in GTK dialogs
|
||||
*
|
||||
* Predefined values for use as response ids in gtk_dialog_add_button().
|
||||
* All predefined values are negative; GTK+ leaves values of 0 or greater for
|
||||
* All predefined values are negative; GTK leaves values of 0 or greater for
|
||||
* application-defined response ids.
|
||||
*/
|
||||
typedef enum
|
||||
|
@ -88,7 +88,7 @@
|
||||
* When using an entry for passwords and other sensitive information,
|
||||
* it can be put into “password mode” using gtk_entry_set_visibility().
|
||||
* In this mode, entered text is displayed using a “invisible” character.
|
||||
* By default, GTK+ picks the best invisible character that is available
|
||||
* By default, GTK picks the best invisible character that is available
|
||||
* in the current font, but it can be changed with
|
||||
* gtk_entry_set_invisible_char().
|
||||
*
|
||||
@ -685,7 +685,7 @@ gtk_entry_class_init (GtkEntryClass *class)
|
||||
*
|
||||
* Whether the primary icon is activatable.
|
||||
*
|
||||
* GTK+ emits the #GtkEntry::icon-press and #GtkEntry::icon-release
|
||||
* GTK emits the #GtkEntry::icon-press and #GtkEntry::icon-release
|
||||
* signals only on sensitive, activatable icons.
|
||||
*
|
||||
* Sensitive, but non-activatable icons can be used for purely
|
||||
@ -703,7 +703,7 @@ gtk_entry_class_init (GtkEntryClass *class)
|
||||
*
|
||||
* Whether the secondary icon is activatable.
|
||||
*
|
||||
* GTK+ emits the #GtkEntry::icon-press and #GtkEntry::icon-release
|
||||
* GTK emits the #GtkEntry::icon-press and #GtkEntry::icon-release
|
||||
* signals only on sensitive, activatable icons.
|
||||
*
|
||||
* Sensitive, but non-activatable icons can be used for purely
|
||||
@ -721,7 +721,7 @@ gtk_entry_class_init (GtkEntryClass *class)
|
||||
*
|
||||
* Whether the primary icon is sensitive.
|
||||
*
|
||||
* An insensitive icon appears grayed out. GTK+ does not emit the
|
||||
* An insensitive icon appears grayed out. GTK does not emit the
|
||||
* #GtkEntry::icon-press and #GtkEntry::icon-release signals and
|
||||
* does not allow DND from insensitive icons.
|
||||
*
|
||||
@ -740,7 +740,7 @@ gtk_entry_class_init (GtkEntryClass *class)
|
||||
*
|
||||
* Whether the secondary icon is sensitive.
|
||||
*
|
||||
* An insensitive icon appears grayed out. GTK+ does not emit the
|
||||
* An insensitive icon appears grayed out. GTK does not emit the
|
||||
* #GtkEntry::icon-press and #GtkEntry::icon-release signals and
|
||||
* does not allow DND from insensitive icons.
|
||||
*
|
||||
@ -2052,7 +2052,7 @@ gtk_entry_set_buffer (GtkEntry *entry,
|
||||
* as the invisible char, and will also appear that way when
|
||||
* the text in the entry widget is copied elsewhere.
|
||||
*
|
||||
* By default, GTK+ picks the best invisible character available
|
||||
* By default, GTK picks the best invisible character available
|
||||
* in the current font, but it can be changed with
|
||||
* gtk_entry_set_invisible_char().
|
||||
*
|
||||
@ -2099,7 +2099,7 @@ gtk_entry_get_visibility (GtkEntry *entry)
|
||||
* Sets the character to use in place of the actual text when
|
||||
* gtk_entry_set_visibility() has been called to set text visibility
|
||||
* to %FALSE. i.e. this is the character used in “password mode” to
|
||||
* show the user how many characters have been typed. By default, GTK+
|
||||
* show the user how many characters have been typed. By default, GTK
|
||||
* picks the best invisible char available in the current font. If you
|
||||
* set the invisible char to 0, then the user will get no feedback
|
||||
* at all; there will be no text on the screen as they type.
|
||||
|
@ -34,7 +34,7 @@
|
||||
|
||||
/**
|
||||
* SECTION:gtkenums
|
||||
* @Short_description: Public enumerated types used throughout GTK+
|
||||
* @Short_description: Public enumerated types used throughout GTK
|
||||
* @Title: Standard Enumerations
|
||||
*/
|
||||
|
||||
@ -201,7 +201,7 @@ typedef enum
|
||||
* @GTK_SENSITIVITY_ON: The arrow is always sensitive
|
||||
* @GTK_SENSITIVITY_OFF: The arrow is always insensitive
|
||||
*
|
||||
* Determines how GTK+ handles the sensitivity of stepper arrows
|
||||
* Determines how GTK handles the sensitivity of stepper arrows
|
||||
* at the end of range widgets.
|
||||
*/
|
||||
typedef enum
|
||||
|
@ -32,7 +32,7 @@
|
||||
* @See_also: #GtkFileChooserDialog, #GtkFileChooserWidget, #GtkFileChooserButton
|
||||
*
|
||||
* #GtkFileChooser is an interface that can be implemented by file
|
||||
* selection widgets. In GTK+, the main objects that implement this
|
||||
* selection widgets. In GTK, the main objects that implement this
|
||||
* interface are #GtkFileChooserWidget, #GtkFileChooserDialog, and
|
||||
* #GtkFileChooserButton. You do not need to write an object that
|
||||
* implements the #GtkFileChooser interface unless you are trying to
|
||||
|
@ -1,6 +1,6 @@
|
||||
/* -*- Mode: C; c-file-style: "gnu"; tab-width: 8 -*- */
|
||||
|
||||
/* GTK+: gtkfilechooserbutton.c
|
||||
/* gtkfilechooserbutton.c
|
||||
*
|
||||
* Copyright (c) 2004 James M. Cape <jcape@ignore-your.tv>
|
||||
*
|
||||
|
@ -1,4 +1,4 @@
|
||||
/* GTK+: gtkfilechooserbutton.h
|
||||
/* gtkfilechooserbutton.h
|
||||
*
|
||||
* Copyright (c) 2004 James M. Cape <jcape@ignore-your.tv>
|
||||
*
|
||||
|
@ -7850,7 +7850,7 @@ gtk_file_chooser_widget_init (GtkFileChooserWidget *impl)
|
||||
impl->auto_selecting_first_row = FALSE;
|
||||
impl->renamed_file = NULL;
|
||||
|
||||
/* Ensure GTK+ private types used by the template
|
||||
/* Ensure private types used by the template
|
||||
* definition before calling gtk_widget_init_template()
|
||||
*/
|
||||
g_type_ensure (GTK_TYPE_PATH_BAR);
|
||||
|
@ -54,8 +54,6 @@
|
||||
*
|
||||
* Also see #GtkListBox.
|
||||
*
|
||||
* GtkFlowBox was added in GTK+ 3.12.
|
||||
*
|
||||
* # CSS nodes
|
||||
*
|
||||
* |[<!-- language="plain" -->
|
||||
|
@ -33,10 +33,9 @@
|
||||
* @See_also: #GtkFontChooserDialog, #GtkFontChooserWidget, #GtkFontButton
|
||||
*
|
||||
* #GtkFontChooser is an interface that can be implemented by widgets
|
||||
* displaying the list of fonts. In GTK+, the main objects
|
||||
* displaying the list of fonts. In GTK, the main objects
|
||||
* that implement this interface are #GtkFontChooserWidget,
|
||||
* #GtkFontChooserDialog and #GtkFontButton. The GtkFontChooser interface
|
||||
* has been introduced in GTK+ 3.2.
|
||||
* #GtkFontChooserDialog and #GtkFontButton.
|
||||
*/
|
||||
|
||||
enum
|
||||
@ -458,7 +457,7 @@ _gtk_font_chooser_font_activated (GtkFontChooser *chooser,
|
||||
* gtk_font_chooser_set_font_map (font_chooser, fontmap);
|
||||
* ]|
|
||||
*
|
||||
* Note that other GTK+ widgets will only be able to use the application-specific
|
||||
* Note that other GTK widgets will only be able to use the application-specific
|
||||
* font if it is present in the font map they use:
|
||||
*
|
||||
* |[
|
||||
|
@ -1073,7 +1073,7 @@ gtk_gesture_set_state (GtkGesture *gesture,
|
||||
* by @gesture.
|
||||
*
|
||||
* Returns: (transfer container) (element-type GdkEventSequence): A list
|
||||
* of #GdkEventSequences, the list elements are owned by GTK+
|
||||
* of #GdkEventSequences, the list elements are owned by GTK
|
||||
* and must not be freed or modified, the list itself must be deleted
|
||||
* through g_list_free()
|
||||
**/
|
||||
|
@ -25,7 +25,7 @@
|
||||
* #GtkGestureClick is a #GtkGesture implementation able to recognize
|
||||
* multiple clicks on a nearby zone, which can be listened for through
|
||||
* the #GtkGestureClick::pressed signal. Whenever time or distance
|
||||
* between clicks exceed the GTK+ defaults, #GtkGestureClick::stopped
|
||||
* between clicks exceed the GTK defaults, #GtkGestureClick::stopped
|
||||
* is emitted, and the click counter is reset.
|
||||
*/
|
||||
|
||||
|
@ -290,7 +290,7 @@ gtk_gesture_long_press_class_init (GtkGestureLongPressClass *klass)
|
||||
* @y: the Y coordinate where the press happened, relative to the widget allocation
|
||||
*
|
||||
* This signal is emitted whenever a press goes unmoved/unreleased longer than
|
||||
* what the GTK+ defaults tell.
|
||||
* what the GTK defaults tell.
|
||||
*/
|
||||
signals[PRESSED] =
|
||||
g_signal_new (I_("pressed"),
|
||||
|
@ -262,7 +262,7 @@ gtk_gesture_stylus_get_axes (GtkGestureStylus *gesture,
|
||||
* @backlog: (out) (array length=n_elems): coordinates and times for the backlog events
|
||||
* @n_elems: (out): return location for the number of elements
|
||||
*
|
||||
* By default, GTK+ will limit rate of input events. On stylus input where
|
||||
* By default, GTK will limit rate of input events. On stylus input where
|
||||
* accuracy of strokes is paramount, this function returns the accumulated
|
||||
* coordinate/timing state before the emission of the current
|
||||
* #GtkGestureStylus::motion signal.
|
||||
|
@ -971,7 +971,7 @@ gtk_icon_theme_class_init (GtkIconThemeClass *klass)
|
||||
* GtkIconTheme::changed:
|
||||
* @self: the icon theme
|
||||
*
|
||||
* Emitted when the current icon theme is switched or GTK+ detects
|
||||
* Emitted when the current icon theme is switched or GTK detects
|
||||
* that a change has occurred in the contents of the current
|
||||
* icon theme.
|
||||
*/
|
||||
|
@ -5662,8 +5662,8 @@ check_model_dnd (GtkTreeModel *model,
|
||||
"g_signal_stop_emission_by_name() in your signal handler to prevent "
|
||||
"the default handler from running. Look at the source code "
|
||||
"for the default handler in gtkiconview.c to get an idea what "
|
||||
"your handler should do. (gtkiconview.c is in the GTK+ source "
|
||||
"code.) If you're using GTK+ from a language other than C, "
|
||||
"your handler should do. (gtkiconview.c is in the GTK source "
|
||||
"code.) If you're using GTK from a language other than C, "
|
||||
"there may be a more natural way to override default handlers, e.g. via derivation.",
|
||||
signal, g_type_name (required_iface), signal);
|
||||
return FALSE;
|
||||
|
@ -45,12 +45,9 @@ typedef struct _GtkImage GtkImage;
|
||||
/**
|
||||
* GtkImageType:
|
||||
* @GTK_IMAGE_EMPTY: there is no image displayed by the widget
|
||||
* @GTK_IMAGE_ICON_NAME: the widget contains a named icon.
|
||||
* This image type was added in GTK+ 2.6
|
||||
* @GTK_IMAGE_GICON: the widget contains a #GIcon.
|
||||
* This image type was added in GTK+ 2.14
|
||||
* @GTK_IMAGE_PAINTABLE: the widget contains a #GdkPaintable.
|
||||
* This image type was added in GTK+ 3.96
|
||||
* @GTK_IMAGE_ICON_NAME: the widget contains a named icon
|
||||
* @GTK_IMAGE_GICON: the widget contains a #GIcon
|
||||
* @GTK_IMAGE_PAINTABLE: the widget contains a #GdkPaintable
|
||||
*
|
||||
* Describes the image data representation used by a #GtkImage. If you
|
||||
* want to get the image from the widget, you can only get the
|
||||
|
@ -29,14 +29,14 @@
|
||||
* @short_description: Base class for input method contexts
|
||||
* @include: gtk/gtk.h,gtk/gtkimmodule.h
|
||||
*
|
||||
* #GtkIMContext defines the interface for GTK+ input methods. An input method
|
||||
* is used by GTK+ text input widgets like #GtkEntry to map from key events to
|
||||
* #GtkIMContext defines the interface for GTK input methods. An input method
|
||||
* is used by GTK text input widgets like #GtkEntry to map from key events to
|
||||
* Unicode character strings.
|
||||
*
|
||||
* The default input method can be set programmatically via the
|
||||
* #GtkSettings:gtk-im-module GtkSettings property. Alternatively, you may set
|
||||
* the GTK_IM_MODULE environment variable as documented in
|
||||
* [Running GTK+ Applications][gtk-running].
|
||||
* [Running GTK Applications][gtk-running].
|
||||
*
|
||||
* The #GtkEntry #GtkEntry:im-module and #GtkTextView #GtkTextView:im-module
|
||||
* properties may also be used to set input methods for specific widget
|
||||
@ -47,14 +47,14 @@
|
||||
* An input method may consume multiple key events in sequence and finally
|
||||
* output the composed result. This is called preediting, and an input method
|
||||
* may provide feedback about this process by displaying the intermediate
|
||||
* composition states as preedit text. For instance, the default GTK+ input
|
||||
* composition states as preedit text. For instance, the default GTK input
|
||||
* method implements the input of arbitrary Unicode code points by holding down
|
||||
* the Control and Shift keys and then typing “U” followed by the hexadecimal
|
||||
* digits of the code point. When releasing the Control and Shift keys,
|
||||
* preediting ends and the character is inserted as text. Ctrl+Shift+u20AC for
|
||||
* example results in the € sign.
|
||||
*
|
||||
* Additional input methods can be made available for use by GTK+ widgets as
|
||||
* Additional input methods can be made available for use by GTK widgets as
|
||||
* loadable modules. An input method module is a small shared library which
|
||||
* implements a subclass of #GtkIMContext or #GtkIMContextSimple and exports
|
||||
* these four functions:
|
||||
@ -94,7 +94,7 @@
|
||||
* After a new loadable input method module has been installed on the system,
|
||||
* the configuration file `gtk.immodules` needs to be
|
||||
* regenerated by [gtk-query-immodules-3.0][gtk-query-immodules-3.0],
|
||||
* in order for the new input method to become available to GTK+ applications.
|
||||
* in order for the new input method to become available to GTK applications.
|
||||
*/
|
||||
|
||||
enum {
|
||||
|
@ -280,7 +280,7 @@ quartz_focus_out (GtkIMContext *context)
|
||||
GtkIMContextQuartz *qc = GTK_IM_CONTEXT_QUARTZ (context);
|
||||
qc->focused = FALSE;
|
||||
|
||||
/* Commit any partially built strings or it'll mess up other GTK+ widgets in the window */
|
||||
/* Commit any partially built strings or it'll mess up other widgets in the window */
|
||||
discard_preedit (context);
|
||||
}
|
||||
|
||||
|
@ -1,6 +1,6 @@
|
||||
/*
|
||||
* gtkinfobar.c
|
||||
* This file is part of GTK+
|
||||
* This file is part of GTK
|
||||
*
|
||||
* Copyright (C) 2005 - Paolo Maggi
|
||||
*
|
||||
@ -71,7 +71,7 @@
|
||||
*
|
||||
* Similar to #GtkMessageDialog, the contents of a #GtkInfoBar can by
|
||||
* classified as error message, warning, informational message, etc,
|
||||
* by using gtk_info_bar_set_message_type(). GTK+ may use the message type
|
||||
* by using gtk_info_bar_set_message_type(). GTK may use the message type
|
||||
* to determine how the message is displayed.
|
||||
*
|
||||
* A simple example for using a #GtkInfoBar:
|
||||
@ -1061,7 +1061,7 @@ gtk_info_bar_buildable_add_child (GtkBuildable *buildable,
|
||||
*
|
||||
* Sets the message type of the message area.
|
||||
*
|
||||
* GTK+ uses this type to determine how the message is displayed.
|
||||
* GTK uses this type to determine how the message is displayed.
|
||||
*/
|
||||
void
|
||||
gtk_info_bar_set_message_type (GtkInfoBar *info_bar,
|
||||
|
@ -1,6 +1,6 @@
|
||||
/*
|
||||
* gtkinfobar.h
|
||||
* This file is part of GTK+
|
||||
* This file is part of GTK
|
||||
*
|
||||
* Copyright (C) 2005 - Paolo Maggi
|
||||
*
|
||||
|
@ -227,9 +227,9 @@
|
||||
*
|
||||
* # Links
|
||||
*
|
||||
* GTK+ supports markup for clickable hyperlinks in addition
|
||||
* GTK supports markup for clickable hyperlinks in addition
|
||||
* to regular Pango markup. The markup for links is borrowed from HTML,
|
||||
* using the `<a>` with “href“, “title“ and “class“ attributes. GTK+ renders links
|
||||
* using the `<a>` with “href“, “title“ and “class“ attributes. GTK renders links
|
||||
* similar to the way they appear in web browsers, with colored, underlined
|
||||
* text. The “title“ attribute is displayed as a tooltip on the link. The “class“
|
||||
* attribute is used as style class on the CSS node for the link.
|
||||
@ -240,7 +240,7 @@
|
||||
* const char *text =
|
||||
* "Go to the"
|
||||
* "<a href=\"http://www.gtk.org title=\"<i>Our</i> website\">"
|
||||
* "GTK+ website</a> for more...";
|
||||
* "GTK website</a> for more...";
|
||||
* GtkWidget *label = gtk_label_new (NULL);
|
||||
* gtk_label_set_markup (GTK_LABEL (label), text);
|
||||
* ]|
|
||||
@ -2644,7 +2644,7 @@ gtk_label_get_max_width_chars (GtkLabel *self)
|
||||
* by the edge of the widget if it exceeds the widget size.
|
||||
*
|
||||
* Note that setting line wrapping to %TRUE does not make the label
|
||||
* wrap at its parent container’s width, because GTK+ widgets
|
||||
* wrap at its parent container’s width, because GTK widgets
|
||||
* conceptually can’t make their requisition depend on the parent
|
||||
* container’s size. For a label that wraps at a specific position,
|
||||
* set the label’s width using gtk_widget_set_size_request().
|
||||
@ -5577,7 +5577,7 @@ gtk_label_activate_current_link (GtkLabel *self)
|
||||
* or for use in a #GtkWidget::query-tooltip handler.
|
||||
*
|
||||
* Returns: (nullable): the currently active URI or %NULL if there is none.
|
||||
* The string is owned by GTK+ and must not be freed or modified.
|
||||
* The string is owned by GTK and must not be freed or modified.
|
||||
*/
|
||||
const char *
|
||||
gtk_label_get_current_uri (GtkLabel *self)
|
||||
|
@ -35,7 +35,7 @@
|
||||
* values 0.25, 0.75 and 1.0 respectively.
|
||||
*
|
||||
* Note that it is your responsibility to update preexisting offsets
|
||||
* when changing the minimum or maximum value. GTK+ will simply clamp
|
||||
* when changing the minimum or maximum value. GTK will simply clamp
|
||||
* them to the new range.
|
||||
*
|
||||
* ## Adding a custom offset on the bar
|
||||
@ -87,8 +87,6 @@
|
||||
* set the minimum value to 0 and the maximum value to 5 after changing the indicator
|
||||
* mode to discrete.
|
||||
*
|
||||
* GtkLevelBar was introduced in GTK+ 3.6.
|
||||
*
|
||||
* # GtkLevelBar as GtkBuildable
|
||||
*
|
||||
* The GtkLevelBar implementation of the GtkBuildable interface supports a
|
||||
|
@ -64,8 +64,6 @@
|
||||
* the user tries to activate it. If it is selectable, the row will be marked
|
||||
* as selected when the user tries to select it.
|
||||
*
|
||||
* The GtkListBox widget was added in GTK+ 3.10.
|
||||
*
|
||||
* # GtkListBox as GtkBuildable
|
||||
*
|
||||
* The GtkListBox implementation of the #GtkBuildable interface supports
|
||||
|
@ -106,13 +106,13 @@
|
||||
*
|
||||
* # Performance Considerations
|
||||
*
|
||||
* Internally, the #GtkListStore was implemented with a linked list with
|
||||
* a tail pointer prior to GTK+ 2.6. As a result, it was fast at data
|
||||
* insertion and deletion, and not fast at random data access. The
|
||||
* #GtkListStore sets the #GTK_TREE_MODEL_ITERS_PERSIST flag, which means
|
||||
* that #GtkTreeIters can be cached while the row exists. Thus, if
|
||||
* access to a particular row is needed often and your code is expected to
|
||||
* run on older versions of GTK+, it is worth keeping the iter around.
|
||||
* Internally, the #GtkListStore was originally implemented with a linked list
|
||||
* with a tail pointer. As a result, it was fast at data insertion and deletion,
|
||||
* and not fast at random data access. The #GtkListStore sets the
|
||||
* #GTK_TREE_MODEL_ITERS_PERSIST flag, which means that #GtkTreeIters can be
|
||||
* cached while the row exists. Thus, if access to a particular row is needed
|
||||
* often and your code is expected to run on older versions of GTK, it is worth
|
||||
* keeping the iter around.
|
||||
*
|
||||
* # Atomic Operations
|
||||
*
|
||||
|
@ -36,9 +36,9 @@
|
||||
*
|
||||
* This provides a simple way to play back video files with GTK.
|
||||
*
|
||||
* GTK+ provides a GIO extension point for #GtkMediaFile implementations
|
||||
* GTK provides a GIO extension point for #GtkMediaFile implementations
|
||||
* to allow for external implementations using various media frameworks.
|
||||
* GTK+ itself includes implementations using GStreamer and ffmpeg.
|
||||
* GTK itself includes implementations using GStreamer and ffmpeg.
|
||||
*/
|
||||
|
||||
typedef struct _GtkMediaFilePrivate GtkMediaFilePrivate;
|
||||
|
@ -606,7 +606,7 @@ popover_destroy_cb (GtkMenuButton *menu_button)
|
||||
* be changed to an arrow if it was customized.
|
||||
*
|
||||
* If the does not fit in the available space in the given direction,
|
||||
* GTK+ will its best to keep it inside the screen and fully visible.
|
||||
* GTK will its best to keep it inside the screen and fully visible.
|
||||
*
|
||||
* If you pass %GTK_ARROW_NONE for a @direction, the popup will behave
|
||||
* as if you passed %GTK_ARROW_DOWN (although you won’t see any arrows).
|
||||
|
@ -53,7 +53,7 @@
|
||||
* allowed to change, so listen to the notify signals to update your item's
|
||||
* appearance. When using a GObject library, this can conveniently be done
|
||||
* with g_object_bind_property() and #GBinding, and this is how this is
|
||||
* implemented in GTK+; the appearance side is implemented in #GtkModelMenuItem.
|
||||
* implemented in GTK; the appearance side is implemented in #GtkModelMenuItem.
|
||||
*
|
||||
* When an item is clicked, simply call gtk_menu_tracker_item_activated() in
|
||||
* response. The #GtkMenuTrackerItem will take care of everything related to
|
||||
|
@ -68,7 +68,7 @@
|
||||
* @short_description: Functions for working with GIO
|
||||
* @Title: Filesystem utilities
|
||||
*
|
||||
* The functions and objects described here make working with GTK+ and
|
||||
* The functions and objects described here make working with GTK and
|
||||
* GIO more convenient.
|
||||
*
|
||||
* #GtkMountOperation is needed when mounting volumes:
|
||||
|
@ -39,8 +39,6 @@
|
||||
* oriented horizontally or vertically. #GtkOrientable is more flexible in that
|
||||
* it allows the orientation to be changed at runtime, allowing the widgets
|
||||
* to “flip”.
|
||||
*
|
||||
* #GtkOrientable was introduced in GTK+ 2.16.
|
||||
*/
|
||||
|
||||
|
||||
|
@ -70,8 +70,6 @@
|
||||
* page_setup = new_page_setup;
|
||||
* }
|
||||
* ]|
|
||||
*
|
||||
* Printing support was added in GTK+ 2.10.
|
||||
*/
|
||||
|
||||
#define KEYFILE_GROUP_NAME "Page Setup"
|
||||
|
@ -54,8 +54,6 @@
|
||||
* The #GtkPaperSize object stores not only the dimensions (width
|
||||
* and height) of a paper size and its name, it also provides
|
||||
* default [print margins][print-margins].
|
||||
*
|
||||
* Printing support has been added in GTK 2.10.
|
||||
*/
|
||||
|
||||
|
||||
|
@ -90,8 +90,6 @@
|
||||
* g_object_unref (layout);
|
||||
* }
|
||||
* ]|
|
||||
*
|
||||
* Printing support was added in GTK+ 2.10.
|
||||
*/
|
||||
|
||||
|
||||
@ -192,7 +190,7 @@ _gtk_print_context_get_fontmap (GtkPrintContext *context)
|
||||
*
|
||||
* This function is intended to be used when implementing
|
||||
* an internal print preview, it is not needed for printing,
|
||||
* since GTK+ itself creates a suitable cairo context in that
|
||||
* since GTK itself creates a suitable cairo context in that
|
||||
* case.
|
||||
*/
|
||||
void
|
||||
|
@ -41,8 +41,6 @@
|
||||
* such as its description, its location, the number of queued jobs,
|
||||
* etc. Most importantly, a #GtkPrinter object can be used to create
|
||||
* a #GtkPrintJob object, which lets you print to the printer.
|
||||
*
|
||||
* Printing support was added in GTK+ 2.10.
|
||||
*/
|
||||
|
||||
|
||||
|
@ -40,11 +40,11 @@
|
||||
* @See_also: #GtkPrintContext, #GtkPrintUnixDialog
|
||||
*
|
||||
* GtkPrintOperation is the high-level, portable printing API.
|
||||
* It looks a bit different than other GTK+ dialogs such as the
|
||||
* It looks a bit different than other GTK dialogs such as the
|
||||
* #GtkFileChooser, since some platforms don’t expose enough
|
||||
* infrastructure to implement a good print dialog. On such
|
||||
* platforms, GtkPrintOperation uses the native print dialog.
|
||||
* On platforms which do not provide a native print dialog, GTK+
|
||||
* On platforms which do not provide a native print dialog, GTK
|
||||
* uses its own, see #GtkPrintUnixDialog.
|
||||
*
|
||||
* The typical way to use the high-level printing API is to create
|
||||
@ -1101,7 +1101,7 @@ gtk_print_operation_class_init (GtkPrintOperationClass *class)
|
||||
* A string used to identify the job (e.g. in monitoring
|
||||
* applications like eggcups).
|
||||
*
|
||||
* If you don't set a job name, GTK+ picks a default one
|
||||
* If you don't set a job name, GTK picks a default one
|
||||
* by numbering successive print jobs.
|
||||
*/
|
||||
g_object_class_install_property (gobject_class,
|
||||
@ -1308,7 +1308,7 @@ gtk_print_operation_class_init (GtkPrintOperationClass *class)
|
||||
* Used as the label of the tab containing custom widgets.
|
||||
* Note that this property may be ignored on some platforms.
|
||||
*
|
||||
* If this is %NULL, GTK+ uses a default label.
|
||||
* If this is %NULL, GTK uses a default label.
|
||||
*/
|
||||
g_object_class_install_property (gobject_class,
|
||||
PROP_CUSTOM_TAB_LABEL,
|
||||
@ -1515,7 +1515,7 @@ gtk_print_operation_get_print_settings (GtkPrintOperation *op)
|
||||
* Sets the name of the print job. The name is used to identify
|
||||
* the job (e.g. in monitoring applications like eggcups).
|
||||
*
|
||||
* If you don’t set a job name, GTK+ picks a default one by
|
||||
* If you don’t set a job name, GTK picks a default one by
|
||||
* numbering successive print jobs.
|
||||
**/
|
||||
void
|
||||
|
@ -205,7 +205,7 @@ struct _GtkPrintOperationClass
|
||||
* or paper size from a key file.
|
||||
*
|
||||
* Error codes that identify various errors that can occur while
|
||||
* using the GTK+ printing support.
|
||||
* using the GTK printing support.
|
||||
*/
|
||||
typedef enum
|
||||
{
|
||||
|
@ -44,8 +44,6 @@
|
||||
* the settings for the next time your app runs, or even store them in a
|
||||
* document. The predefined keys try to use shared values as much as possible
|
||||
* so that moving such a document between systems still works.
|
||||
*
|
||||
* Printing support was added in GTK+ 2.10.
|
||||
*/
|
||||
|
||||
typedef struct _GtkPrintSettingsClass GtkPrintSettingsClass;
|
||||
|
@ -195,7 +195,7 @@ void gtk_print_settings_set_int (GtkPrintSettings
|
||||
* GTK_PRINT_SETTINGS_OUTPUT_URI:
|
||||
*
|
||||
* The key used by the “Print to file” printer to store the URI
|
||||
* to which the output should be written. GTK+ itself supports
|
||||
* to which the output should be written. GTK itself supports
|
||||
* only “file://” URIs.
|
||||
*/
|
||||
#define GTK_PRINT_SETTINGS_OUTPUT_URI "output-uri"
|
||||
|
@ -336,12 +336,12 @@ gtk_range_class_init (GtkRangeClass *class)
|
||||
* type of scroll event that occurred and the resultant new value.
|
||||
* The application can handle the event itself and return %TRUE to
|
||||
* prevent further processing. Or, by returning %FALSE, it can pass
|
||||
* the event to other handlers until the default GTK+ handler is
|
||||
* the event to other handlers until the default GTK handler is
|
||||
* reached.
|
||||
*
|
||||
* The value parameter is unrounded. An application that overrides
|
||||
* the GtkRange::change-value signal is responsible for clamping the
|
||||
* value to the desired number of decimal digits; the default GTK+
|
||||
* value to the desired number of decimal digits; the default GTK
|
||||
* handler clamps the value based on #GtkRange:round-digits.
|
||||
*
|
||||
* Returns: %TRUE to prevent other handlers from being invoked for
|
||||
@ -1668,7 +1668,7 @@ range_grab_add (GtkRange *range,
|
||||
{
|
||||
GtkRangePrivate *priv = gtk_range_get_instance_private (range);
|
||||
|
||||
/* Don't perform any GDK/GTK+ grab here. Since a button
|
||||
/* Don't perform any GDK/GTK grab here. Since a button
|
||||
* is down, there's an ongoing implicit grab on
|
||||
* the widget, which pretty much guarantees this
|
||||
* is the only widget receiving the pointer events.
|
||||
|
@ -36,7 +36,7 @@
|
||||
*
|
||||
* The #GtkRecentManager acts like a database of all the recently
|
||||
* used files. You can create new #GtkRecentManager objects, but
|
||||
* it is more efficient to use the default manager created by GTK+.
|
||||
* it is more efficient to use the default manager created by GTK
|
||||
*
|
||||
* Adding a new recently used file is as simple as:
|
||||
*
|
||||
@ -81,8 +81,6 @@
|
||||
* Note that the maximum age of the recently used files list is
|
||||
* controllable through the #GtkSettings:gtk-recent-files-max-age
|
||||
* property.
|
||||
*
|
||||
* Recently used files are supported since GTK+ 2.10.
|
||||
*/
|
||||
|
||||
#include "config.h"
|
||||
|
@ -53,8 +53,6 @@
|
||||
* When styling #GtkRevealer using CSS, remember that it only hides its contents,
|
||||
* not itself. That means applied margin, padding and borders will be
|
||||
* visible even when the #GtkRevealer:reveal-child property is set to %FALSE.
|
||||
*
|
||||
* The GtkRevealer widget was added in GTK+ 3.10.
|
||||
*/
|
||||
|
||||
/**
|
||||
|
@ -1657,7 +1657,7 @@ gtk_scale_clear_marks (GtkScale *scale)
|
||||
* 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
|
||||
* 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.
|
||||
|
@ -67,7 +67,7 @@
|
||||
*
|
||||
* #GtkScaleButton provides a button which pops up a scale widget.
|
||||
* This kind of widget is commonly used for volume controls in multimedia
|
||||
* applications, and GTK+ provides a #GtkVolumeButton subclass that
|
||||
* applications, and GTK provides a #GtkVolumeButton subclass that
|
||||
* is tailored for this use case.
|
||||
*
|
||||
* # CSS nodes
|
||||
@ -190,10 +190,9 @@ gtk_scale_button_class_init (GtkScaleButtonClass *klass)
|
||||
*
|
||||
* The orientation of the #GtkScaleButton's popup window.
|
||||
*
|
||||
* Note that since GTK+ 2.16, #GtkScaleButton implements the
|
||||
* #GtkOrientable interface which has its own @orientation
|
||||
* property. However we redefine the property here in order to
|
||||
* override its default horizontal orientation.
|
||||
* Note that #GtkScaleButton implements the #GtkOrientable interface
|
||||
* which has its own @orientation property. However, we redefine the
|
||||
* property here in order to override its default horizontal orientation.
|
||||
**/
|
||||
g_object_class_override_property (gobject_class,
|
||||
PROP_ORIENTATION,
|
||||
|
@ -296,7 +296,7 @@ gtk_scrollable_set_vscroll_policy (GtkScrollable *scrollable,
|
||||
*
|
||||
* Returns the size of a non-scrolling border around the
|
||||
* outside of the scrollable. An example for this would
|
||||
* be treeview headers. GTK+ can use this information to
|
||||
* be treeview headers. GTK can use this information to
|
||||
* display overlaid graphics, like the overshoot indication,
|
||||
* at the right position.
|
||||
*
|
||||
|
@ -692,7 +692,7 @@ binding_compose_params (GtkWidget *widget,
|
||||
|
||||
g_type_class_unref (class);
|
||||
}
|
||||
/* This is just a hack for compatibility with GTK+-1.2 where a string
|
||||
/* This is just a hack for compatibility with GTK 1.2 where a string
|
||||
* could be used for a single flag value / without the support for multiple
|
||||
* values in gtk_rc_parse_flags(), this isn't very useful.
|
||||
*/
|
||||
|
@ -299,7 +299,7 @@ gtk_shortcuts_group_class_init (GtkShortcutsGroupClass *klass)
|
||||
*
|
||||
* The size group for the accelerator portion of shortcuts in this group.
|
||||
*
|
||||
* This is used internally by GTK+, and must not be modified by applications.
|
||||
* This is used internally by GTK, and must not be modified by applications.
|
||||
*/
|
||||
properties[PROP_ACCEL_SIZE_GROUP] =
|
||||
g_param_spec_object ("accel-size-group",
|
||||
@ -313,7 +313,7 @@ gtk_shortcuts_group_class_init (GtkShortcutsGroupClass *klass)
|
||||
*
|
||||
* The size group for the textual portion of shortcuts in this group.
|
||||
*
|
||||
* This is used internally by GTK+, and must not be modified by applications.
|
||||
* This is used internally by GTK, and must not be modified by applications.
|
||||
*/
|
||||
properties[PROP_TITLE_SIZE_GROUP] =
|
||||
g_param_spec_object ("title-size-group",
|
||||
@ -327,7 +327,7 @@ gtk_shortcuts_group_class_init (GtkShortcutsGroupClass *klass)
|
||||
*
|
||||
* A rough measure for the number of lines in this group.
|
||||
*
|
||||
* This is used internally by GTK+, and is not useful for applications.
|
||||
* This is used internally by GTK, and is not useful for applications.
|
||||
*/
|
||||
properties[PROP_HEIGHT] =
|
||||
g_param_spec_uint ("height", P_("Height"), P_("Height"),
|
||||
|
@ -586,7 +586,7 @@ gtk_shortcuts_shortcut_class_init (GtkShortcutsShortcutClass *klass)
|
||||
*
|
||||
* An icon to represent the shortcut or gesture. This property is used if
|
||||
* #GtkShortcutsShortcut:shortcut-type is set to #GTK_SHORTCUT_GESTURE.
|
||||
* For the other predefined gesture types, GTK+ provides an icon on its own.
|
||||
* For the other predefined gesture types, GTK provides an icon on its own.
|
||||
*/
|
||||
properties[PROP_ICON] =
|
||||
g_param_spec_object ("icon",
|
||||
@ -627,7 +627,7 @@ gtk_shortcuts_shortcut_class_init (GtkShortcutsShortcutClass *klass)
|
||||
*
|
||||
* This is typically used for gestures and should be a short, one-line
|
||||
* text that describes the gesture itself. For the predefined gesture
|
||||
* types, GTK+ provides a subtitle on its own.
|
||||
* types, GTK provides a subtitle on its own.
|
||||
*/
|
||||
properties[PROP_SUBTITLE] =
|
||||
g_param_spec_string ("subtitle",
|
||||
@ -653,7 +653,7 @@ gtk_shortcuts_shortcut_class_init (GtkShortcutsShortcutClass *klass)
|
||||
*
|
||||
* The size group for the accelerator portion of this shortcut.
|
||||
*
|
||||
* This is used internally by GTK+, and must not be modified by applications.
|
||||
* This is used internally by GTK, and must not be modified by applications.
|
||||
*/
|
||||
properties[PROP_ACCEL_SIZE_GROUP] =
|
||||
g_param_spec_object ("accel-size-group",
|
||||
@ -667,7 +667,7 @@ gtk_shortcuts_shortcut_class_init (GtkShortcutsShortcutClass *klass)
|
||||
*
|
||||
* The size group for the textual portion of this shortcut.
|
||||
*
|
||||
* This is used internally by GTK+, and must not be modified by applications.
|
||||
* This is used internally by GTK, and must not be modified by applications.
|
||||
*/
|
||||
properties[PROP_TITLE_SIZE_GROUP] =
|
||||
g_param_spec_object ("title-size-group",
|
||||
@ -708,7 +708,7 @@ gtk_shortcuts_shortcut_class_init (GtkShortcutsShortcutClass *klass)
|
||||
* GtkShortcutsShortcut:action-name:
|
||||
*
|
||||
* A detailed action name. If this is set for a shortcut
|
||||
* of type %GTK_SHORTCUT_ACCELERATOR, then GTK+ will use
|
||||
* of type %GTK_SHORTCUT_ACCELERATOR, then GTK will use
|
||||
* the accelerators that are associated with the action
|
||||
* via gtk_application_set_accels_for_action(), and setting
|
||||
* #GtkShortcutsShortcut:accelerator is not necessary.
|
||||
|
@ -60,7 +60,7 @@
|
||||
* group; when all widgets have been removed, the size group will be
|
||||
* freed.
|
||||
*
|
||||
* Widgets can be part of multiple size groups; GTK+ will compute the
|
||||
* Widgets can be part of multiple size groups; GTK will compute the
|
||||
* horizontal size of a widget from the horizontal requisition of all
|
||||
* widgets that can be reached from the widget by a chain of size groups
|
||||
* of type %GTK_SIZE_GROUP_HORIZONTAL or %GTK_SIZE_GROUP_BOTH, and the
|
||||
@ -429,7 +429,7 @@ gtk_size_group_remove_widget (GtkSizeGroup *size_group,
|
||||
* Returns the list of widgets associated with @size_group.
|
||||
*
|
||||
* Returns: (element-type GtkWidget) (transfer none): a #GSList of
|
||||
* widgets. The list is owned by GTK+ and should not be modified.
|
||||
* widgets. The list is owned by GTK and should not be modified.
|
||||
**/
|
||||
GSList *
|
||||
gtk_size_group_get_widgets (GtkSizeGroup *size_group)
|
||||
|
@ -206,7 +206,7 @@ _gtk_size_request_cache_commit (SizeRequestCache *cache,
|
||||
/* looks for a cached size request for this for_size.
|
||||
*
|
||||
* Note that this caching code was originally derived from
|
||||
* the Clutter toolkit but has evolved for other GTK+ requirements.
|
||||
* the Clutter toolkit but has evolved for other GTK requirements.
|
||||
*/
|
||||
gboolean
|
||||
_gtk_size_request_cache_lookup (const SizeRequestCache *cache,
|
||||
|
@ -1,7 +1,7 @@
|
||||
/* GTK - The GIMP Toolkit
|
||||
* Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
|
||||
*
|
||||
* GtkSpinButton widget for GTK+
|
||||
* GtkSpinButton widget for GTK
|
||||
* Copyright (C) 1998 Lars Hamann and Stefan Jeske
|
||||
*
|
||||
* This library is free software; you can redistribute it and/or
|
||||
|
@ -51,8 +51,6 @@
|
||||
* It is possible to associate multiple #GtkStackSwitcher widgets
|
||||
* with the same #GtkStack widget.
|
||||
*
|
||||
* The GtkStackSwitcher widget was added in 3.10.
|
||||
*
|
||||
* # CSS nodes
|
||||
*
|
||||
* GtkStackSwitcher has a single CSS node named stackswitcher and
|
||||
|
@ -63,7 +63,7 @@
|
||||
* gtk_style_context_add_provider_for_display(). The resulting style is a
|
||||
* combination of all providers’ information in priority order.
|
||||
*
|
||||
* For GTK+ widgets, any #GtkStyleContext returned by
|
||||
* For GTK widgets, any #GtkStyleContext returned by
|
||||
* gtk_widget_get_style_context() will already have a #GdkDisplay and
|
||||
* RTL/LTR information set. The style context will also be updated
|
||||
* automatically if any of these settings change on the widget.
|
||||
@ -75,7 +75,7 @@
|
||||
* which style classes it uses itself, and which style classes may be added by
|
||||
* applications to affect their appearance.
|
||||
*
|
||||
* GTK+ defines macros for a number of style classes.
|
||||
* GTK defines macros for a number of style classes.
|
||||
*
|
||||
* # Custom styling in UI libraries and applications
|
||||
*
|
||||
@ -428,7 +428,7 @@ gtk_style_context_remove_provider (GtkStyleContext *context,
|
||||
* Adds a global style provider to @display, which will be used
|
||||
* in style construction for all #GtkStyleContexts under @display.
|
||||
*
|
||||
* GTK+ uses this to make styling information from #GtkSettings
|
||||
* GTK uses this to make styling information from #GtkSettings
|
||||
* available.
|
||||
*
|
||||
* Note: If both priorities are the same, A #GtkStyleProvider
|
||||
@ -1337,7 +1337,7 @@ gtk_snapshot_render_insertion_cursor (GtkSnapshot *snapshot,
|
||||
* information may be included.
|
||||
*
|
||||
* This function is intended for testing and debugging of the
|
||||
* CSS implementation in GTK+. There are no guarantees about
|
||||
* CSS implementation in GTK. There are no guarantees about
|
||||
* the format of the returned string, it may change.
|
||||
*
|
||||
* Returns: a newly allocated string representing @context
|
||||
|
@ -46,7 +46,7 @@
|
||||
|
||||
/**
|
||||
* SECTION:gtktesting
|
||||
* @Short_description: Utilities for testing GTK+ applications
|
||||
* @Short_description: Utilities for testing GTK applications
|
||||
* @Title: Testing
|
||||
*/
|
||||
|
||||
@ -60,7 +60,7 @@
|
||||
* stripped before return.
|
||||
* @...: currently unused
|
||||
*
|
||||
* This function is used to initialize a GTK+ test program.
|
||||
* This function is used to initialize a GTK test program.
|
||||
*
|
||||
* It will in turn call g_test_init() and gtk_init() to properly
|
||||
* initialize the testing framework and graphical toolkit. It’ll
|
||||
|
@ -138,7 +138,7 @@ struct _GtkTextAppearance
|
||||
*
|
||||
* Using #GtkTextAttributes directly should rarely be necessary.
|
||||
* It’s primarily useful with gtk_text_iter_get_attributes().
|
||||
* As with most GTK+ structs, the fields in this struct should only
|
||||
* As with most GTK structs, the fields in this struct should only
|
||||
* be read, never modified directly.
|
||||
*/
|
||||
struct _GtkTextAttributes
|
||||
|
@ -48,7 +48,7 @@
|
||||
* image, or you want the tooltip to have different contents per #GtkTreeView
|
||||
* row or cell, you will have to do a little more work:
|
||||
*
|
||||
* - Set the #GtkWidget:has-tooltip property to %TRUE, this will make GTK+
|
||||
* - Set the #GtkWidget:has-tooltip property to %TRUE, this will make GTK
|
||||
* monitor the widget for motion and related events which are needed to
|
||||
* determine when and where to show a tooltip.
|
||||
*
|
||||
|
@ -26,10 +26,10 @@
|
||||
* @Short_description: Interfaces for drag-and-drop support in GtkTreeView
|
||||
* @Title: GtkTreeView drag-and-drop
|
||||
*
|
||||
* GTK+ supports Drag-and-Drop in tree views with a high-level and a low-level
|
||||
* GTK supports Drag-and-Drop in tree views with a high-level and a low-level
|
||||
* API.
|
||||
*
|
||||
* The low-level API consists of the GTK+ DND API, augmented by some treeview
|
||||
* The low-level API consists of the GTK DND API, augmented by some treeview
|
||||
* utility functions: gtk_tree_view_set_drag_dest_row(),
|
||||
* gtk_tree_view_get_drag_dest_row(), gtk_tree_view_get_dest_row_at_pos(),
|
||||
* gtk_tree_view_create_row_drag_icon(), gtk_tree_set_row_drag_data() and
|
||||
|
@ -2323,7 +2323,7 @@ gtk_tree_row_reference_new (GtkTreeModel *model,
|
||||
*
|
||||
* These functions must be called exactly once per proxy when the
|
||||
* corresponding signal on the model is emitted. This single call
|
||||
* updates all row references for that proxy. Since built-in GTK+
|
||||
* updates all row references for that proxy. Since built-in GTK
|
||||
* objects like #GtkTreeView already use this mechanism internally,
|
||||
* using them as the proxy object will produce unpredictable results.
|
||||
* Further more, passing the same object as @model and @proxy
|
||||
|
@ -2057,7 +2057,7 @@ _gtk_tree_view_column_allocate (GtkTreeViewColumn *tree_column,
|
||||
* “fixed-width” property is not clamped. If the column sizing is
|
||||
* #GTK_TREE_VIEW_COLUMN_GROW_ONLY or #GTK_TREE_VIEW_COLUMN_AUTOSIZE, setting
|
||||
* a fixed width overrides the automatically calculated width. Note that
|
||||
* @fixed_width is only a hint to GTK+; the width actually allocated to the
|
||||
* @fixed_width is only a hint to GTK; the width actually allocated to the
|
||||
* column may be greater or less than requested.
|
||||
*
|
||||
* Along with “expand”, the “fixed-width” property changes when the column is
|
||||
|
@ -90,10 +90,10 @@
|
||||
* @minor: minor version (e.g. 2 for version 1.2.5)
|
||||
* @micro: micro version (e.g. 5 for version 1.2.5)
|
||||
*
|
||||
* Returns %TRUE if the version of the GTK+ header files
|
||||
* Returns %TRUE if the version of the GTK header files
|
||||
* is the same as or newer than the passed-in version.
|
||||
*
|
||||
* Returns: %TRUE if GTK+ headers are new enough
|
||||
* Returns: %TRUE if GTK headers are new enough
|
||||
*/
|
||||
#define GTK_CHECK_VERSION(major,minor,micro) \
|
||||
(GTK_MAJOR_VERSION > (major) || \
|
||||
|
@ -92,19 +92,19 @@
|
||||
* @Short_description: Base class for all widgets
|
||||
* @Title: GtkWidget
|
||||
*
|
||||
* GtkWidget is the base class all widgets in GTK+ derive from. It manages the
|
||||
* GtkWidget is the base class all widgets in GTK derive from. It manages the
|
||||
* widget lifecycle, states and style.
|
||||
*
|
||||
* # Height-for-width Geometry Management # {#geometry-management}
|
||||
*
|
||||
* GTK+ uses a height-for-width (and width-for-height) geometry management
|
||||
* GTK uses a height-for-width (and width-for-height) geometry management
|
||||
* system. Height-for-width means that a widget can change how much
|
||||
* vertical space it needs, depending on the amount of horizontal space
|
||||
* that it is given (and similar for width-for-height). The most common
|
||||
* example is a label that reflows to fill up the available width, wraps
|
||||
* to fewer lines, and therefore needs less height.
|
||||
*
|
||||
* Height-for-width geometry management is implemented in GTK+ by way
|
||||
* Height-for-width geometry management is implemented in GTK by way
|
||||
* of two virtual methods:
|
||||
*
|
||||
* - #GtkWidgetClass.get_request_mode()
|
||||
@ -223,7 +223,7 @@
|
||||
* as well as its CSS style.
|
||||
* If a widget used the wrappers inside its virtual method implementations,
|
||||
* then the adjustments (such as widget margins) would be applied
|
||||
* twice. GTK+ therefore does not allow this and will warn if you try
|
||||
* twice. GTK therefore does not allow this and will warn if you try
|
||||
* to do it.
|
||||
*
|
||||
* Of course if you are getting the size request for
|
||||
@ -231,7 +231,7 @@
|
||||
* Otherwise, you would not properly consider widget margins,
|
||||
* #GtkSizeGroup, and so forth.
|
||||
*
|
||||
* GTK+ also supports baseline vertical alignment of widgets. This
|
||||
* GTK also supports baseline vertical alignment of widgets. This
|
||||
* means that widgets are positioned such that the typographical baseline of
|
||||
* widgets in the same row are aligned. This happens if a widget supports baselines,
|
||||
* has a vertical alignment of %GTK_ALIGN_BASELINE, and is inside a widget
|
||||
@ -5271,7 +5271,7 @@ gtk_widget_set_name (GtkWidget *widget,
|
||||
* Retrieves the name of a widget. See gtk_widget_set_name() for the
|
||||
* significance of widget names.
|
||||
*
|
||||
* Returns: name of the widget. This string is owned by GTK+ and
|
||||
* Returns: name of the widget. This string is owned by GTK and
|
||||
* should not be modified or freed
|
||||
**/
|
||||
const char *
|
||||
@ -7465,7 +7465,7 @@ gtk_widget_adjust_baseline_request (GtkWidget *widget,
|
||||
*
|
||||
* Returns the list of pointer #GdkDevices that are currently
|
||||
* on top of @widget. Free the list
|
||||
* with g_free(), the elements are owned by GTK+ and must
|
||||
* with g_free(), the elements are owned by GTK and must
|
||||
* not be freed.
|
||||
*/
|
||||
GdkDevice **
|
||||
@ -7500,7 +7500,7 @@ _gtk_widget_list_devices (GtkWidget *widget,
|
||||
* @to: the #GtkWidget the virtual pointer is moving to.
|
||||
* @mode: the #GdkCrossingMode to place on the synthesized events.
|
||||
*
|
||||
* Generate crossing event(s) on widget state (sensitivity) or GTK+ grab change.
|
||||
* Generate crossing event(s) on widget state (sensitivity) or GTK grab change.
|
||||
*/
|
||||
void
|
||||
_gtk_widget_synthesize_crossing (GtkWidget *from,
|
||||
@ -10436,7 +10436,7 @@ gtk_widget_class_set_template_from_resource (GtkWidgetClass *widget_class,
|
||||
g_return_if_fail (resource_name && resource_name[0]);
|
||||
|
||||
/* This is a hack, because class initializers now access resources
|
||||
* and GIR/gtk-doc initializes classes without initializing GTK+,
|
||||
* and GIR/gtk-doc initializes classes without initializing GTK,
|
||||
* we ensure that our base resources are registered here and
|
||||
* avoid warnings which building GIRs/documentation.
|
||||
*/
|
||||
|
@ -786,7 +786,7 @@ gtk_window_class_init (GtkWindowClass *klass)
|
||||
*
|
||||
* Whether mnemonics are currently visible in this window.
|
||||
*
|
||||
* This property is maintained by GTK+ based on user input,
|
||||
* This property is maintained by GTK based on user input,
|
||||
* and should not be set by applications.
|
||||
*/
|
||||
window_props[PROP_MNEMONICS_VISIBLE] =
|
||||
@ -801,7 +801,7 @@ gtk_window_class_init (GtkWindowClass *klass)
|
||||
*
|
||||
* Whether 'focus rectangles' are currently visible in this window.
|
||||
*
|
||||
* This property is maintained by GTK+ based on user input
|
||||
* This property is maintained by GTK based on user input
|
||||
* and should not be set by applications.
|
||||
*/
|
||||
window_props[PROP_FOCUS_VISIBLE] =
|
||||
@ -1996,7 +1996,7 @@ gtk_window_get_title (GtkWindow *window)
|
||||
* function before calling gtk_window_present() or any equivalent
|
||||
* function generating a window map event.
|
||||
*
|
||||
* This function is only useful on X11, not with other GTK+ targets.
|
||||
* This function is only useful on X11, not with other GTK targets.
|
||||
**/
|
||||
void
|
||||
gtk_window_set_startup_id (GtkWindow *window,
|
||||
@ -2411,7 +2411,7 @@ gtk_window_unset_transient_for (GtkWindow *window)
|
||||
* [window managers][gtk-X11-arch] to e.g. keep the
|
||||
* dialog on top of the main window, or center the dialog over the
|
||||
* main window. gtk_dialog_new_with_buttons() and other convenience
|
||||
* functions in GTK+ will sometimes call
|
||||
* functions in GTK will sometimes call
|
||||
* gtk_window_set_transient_for() on your behalf.
|
||||
*
|
||||
* Passing %NULL for @parent unsets the current transient window.
|
||||
@ -2764,7 +2764,7 @@ gtk_window_enable_csd (GtkWindow *window)
|
||||
* A typical widget used here is #GtkHeaderBar, as it provides various features
|
||||
* expected of a titlebar while allowing the addition of child widgets to it.
|
||||
*
|
||||
* If you set a custom titlebar, GTK+ will do its best to convince
|
||||
* If you set a custom titlebar, GTK will do its best to convince
|
||||
* the window manager not to put its own titlebar on the window.
|
||||
* Depending on the system, this function may not work for a window
|
||||
* that is already visible, so you set the titlebar before calling
|
||||
@ -2845,9 +2845,9 @@ gtk_window_get_titlebar (GtkWindow *window)
|
||||
*
|
||||
* By default, windows are decorated with a title bar, resize
|
||||
* controls, etc. Some [window managers][gtk-X11-arch]
|
||||
* allow GTK+ to disable these decorations, creating a
|
||||
* allow GTK to disable these decorations, creating a
|
||||
* borderless window. If you set the decorated property to %FALSE
|
||||
* using this function, GTK+ will do its best to convince the window
|
||||
* using this function, GTK will do its best to convince the window
|
||||
* manager not to decorate the window. Depending on the system, this
|
||||
* function may not have any effect when called on a window that is
|
||||
* already visible, so you should call it before calling gtk_widget_show().
|
||||
@ -2905,9 +2905,9 @@ gtk_window_get_decorated (GtkWindow *window)
|
||||
* @setting: %TRUE to decorate the window as deletable
|
||||
*
|
||||
* By default, windows have a close button in the window frame. Some
|
||||
* [window managers][gtk-X11-arch] allow GTK+ to
|
||||
* [window managers][gtk-X11-arch] allow GTK to
|
||||
* disable this button. If you set the deletable property to %FALSE
|
||||
* using this function, GTK+ will do its best to convince the window
|
||||
* using this function, GTK will do its best to convince the window
|
||||
* manager not to show a close button. Depending on the system, this
|
||||
* function may not have any effect when called on a window that is
|
||||
* already visible, so you should call it before calling gtk_widget_show().
|
||||
@ -3272,7 +3272,7 @@ gtk_window_set_default_icon_name (const char *name)
|
||||
*
|
||||
* Returns the fallback icon name for windows that has been set
|
||||
* with gtk_window_set_default_icon_name(). The returned
|
||||
* string is owned by GTK+ and should not be modified. It
|
||||
* string is owned by GTK and should not be modified. It
|
||||
* is only valid until the next call to
|
||||
* gtk_window_set_default_icon_name().
|
||||
*
|
||||
@ -3476,7 +3476,7 @@ gtk_window_get_default_size (GtkWindow *window,
|
||||
*
|
||||
* Windows may not be resized smaller than 1 by 1 pixels.
|
||||
*
|
||||
* When using client side decorations, GTK+ will do its best to adjust
|
||||
* When using client side decorations, GTK will do its best to adjust
|
||||
* the given size so that the resulting window size matches the
|
||||
* requested size without the title bar, borders and shadows added for
|
||||
* the client side decorations, but there is no guarantee that the
|
||||
@ -3521,7 +3521,7 @@ gtk_window_resize (GtkWindow *window,
|
||||
*
|
||||
* Obtains the current size of @window.
|
||||
*
|
||||
* If @window is not visible on screen, this function return the size GTK+
|
||||
* If @window is not visible on screen, this function return the size GTK
|
||||
* will suggest to the [window manager][gtk-X11-arch] for the initial window
|
||||
* size (but this is not reliably the same as the size the window manager
|
||||
* will actually select). See: gtk_window_set_default_size().
|
||||
@ -3529,7 +3529,7 @@ gtk_window_resize (GtkWindow *window,
|
||||
* Depending on the windowing system and the window manager constraints,
|
||||
* the size returned by this function may not match the size set using
|
||||
* gtk_window_resize(); additionally, since gtk_window_resize() may be
|
||||
* implemented as an asynchronous operation, GTK+ cannot guarantee in any
|
||||
* implemented as an asynchronous operation, GTK cannot guarantee in any
|
||||
* way that this code:
|
||||
*
|
||||
* |[<!-- language="C" -->
|
||||
@ -5384,7 +5384,7 @@ gtk_window_move_resize (GtkWindow *window)
|
||||
* or gtk_window_move().
|
||||
*
|
||||
* If the configure request has changed, we send off a new one. To
|
||||
* ensure GTK+ invariants are maintained (resize queue does what it
|
||||
* ensure GTK invariants are maintained (resize queue does what it
|
||||
* should), we go ahead and size_allocate the requested size in this
|
||||
* function.
|
||||
*
|
||||
|
@ -112,7 +112,7 @@ static TestInterface interfaces[] = {
|
||||
" <property name=\"label\">Long label</property>"
|
||||
" <child>"
|
||||
" <object class=\"GtkLabel\" id=\"label1\">"
|
||||
" <property name=\"label\" translatable=\"yes\">This is a really long label for the purpose of testing line wrapping is working correctly in conjunction with height-for-width support in GTK+</property>"
|
||||
" <property name=\"label\" translatable=\"yes\">This is a really long label for the purpose of testing line wrapping is working correctly in conjunction with height-for-width support in GTK</property>"
|
||||
" <property name=\"wrap\">True</property>"
|
||||
" <property name=\"max_width_chars\">30</property>"
|
||||
" <attributes>"
|
||||
|
@ -1,4 +1,4 @@
|
||||
/* testtooltips.c: Test application for GTK+ >= 2.12 tooltips code
|
||||
/* testtooltips.c: Test application for GTK >= 2.12 tooltips code
|
||||
*
|
||||
* Copyright (C) 2006-2007 Imendio AB
|
||||
* Contact: Kristian Rietveld <kris@imendio.com>
|
||||
|
@ -12,7 +12,7 @@ test_init (void)
|
||||
int
|
||||
main (int argc, char *argv[])
|
||||
{
|
||||
/* Don't use gtk_test_init here because it implicitly initializes GTK+. */
|
||||
/* Don't use gtk_test_init here because it implicitly initializes GTK. */
|
||||
g_test_init (&argc, &argv, NULL);
|
||||
gtk_disable_setlocale();
|
||||
setlocale (LC_ALL, "C");
|
||||
|
@ -372,7 +372,7 @@ test_type (gconstpointer data)
|
||||
if (!g_type_is_a (type, G_TYPE_OBJECT))
|
||||
return;
|
||||
|
||||
/* non-GTK+ */
|
||||
/* non-GTK */
|
||||
if (g_str_equal (g_type_name (type), "GdkPixbufSimpleAnim"))
|
||||
return;
|
||||
|
||||
@ -503,7 +503,7 @@ test_type (gconstpointer data)
|
||||
if ((pspec->flags & G_PARAM_CONSTRUCT_ONLY) != 0)
|
||||
continue;
|
||||
|
||||
/* non-GTK+ */
|
||||
/* non-GTK */
|
||||
if (g_str_equal (g_type_name (pspec->owner_type), "GdkPixbufSimpleAnim") ||
|
||||
g_str_equal (g_type_name (pspec->owner_type), "GMountOperation"))
|
||||
continue;
|
||||
|
@ -101,7 +101,7 @@ test_finalize_object (gconstpointer data)
|
||||
/* Assert that the object finalizes properly */
|
||||
g_object_weak_ref (object, check_finalized, &finalized);
|
||||
|
||||
/* Toplevels are owned by GTK+, just tell GTK+ to destroy it */
|
||||
/* Toplevels are owned by GTK, just tell GTK to destroy it */
|
||||
if (GTK_IS_WINDOW (object))
|
||||
gtk_window_destroy (GTK_WINDOW (object));
|
||||
else
|
||||
|
Loading…
Reference in New Issue
Block a user