AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity
c49cc977fa
gtk2/gtk/a11y/gtkcellaccessibleparent.h

141 lines
7.6 KiB
C
Raw Normal View History

Cosmetics Replace GAIL in top comments by 'GTK+ - accessibility implementations'.
2012-10-30 14:21:44 +00:00
/* GTK+ - accessibility implementations
Convert GailCellParent to GtkCellAccessibleParent
2011-07-10 03:56:42 +00:00
* Copyright 2001 Sun Microsystems Inc.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public
Change FSF Address
2012-02-27 13:01:10 +00:00
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
Convert GailCellParent to GtkCellAccessibleParent
2011-07-10 03:56:42 +00:00
*/
Move single-include guards inside include guards gcc has optimizations for include guards that only work if they are outermost in the the header. https://bugzilla.gnome.org/show_bug.cgi?id=689810
2012-12-28 14:57:34 +00:00
#ifndef __GTK_CELL_ACCESSIBLE_PARENT_H__
#define __GTK_CELL_ACCESSIBLE_PARENT_H__
Add single-include guards to a11y headers More preparation for installing these headers.
2012-10-30 15:39:38 +00:00
#if !defined (__GTK_A11Y_H_INSIDE__) && !defined (GTK_COMPILATION)
#error "Only <gtk/gtk-a11y.h> can be included directly."
#endif
Convert GailCellParent to GtkCellAccessibleParent
2011-07-10 03:56:42 +00:00
#include <atk/atk.h>
Fix inter-header includes Since we are going to install these headers soon, we need to make their mutual includes work in the installed location as well. Also, avoid including individual gtk headers, to avoid trouble with single-include guards.
2012-12-27 06:21:11 +00:00
#include <gtk/a11y/gtkcellaccessible.h>
Convert GailCellParent to GtkCellAccessibleParent
2011-07-10 03:56:42 +00:00
G_BEGIN_DECLS
/*
* The GtkCellAccessibleParent interface should be supported by any object
* which contains children which are flyweights, i.e. do not have corresponding
* widgets and the children need help from their parent to provide
* functionality. One example is GtkTreeViewAccessible where the children
* GtkCellAccessible need help from the GtkTreeViewAccessible in order to
* implement atk_component_get_extents().
*/
Make accessible implementations public This commit exposes the get_type() functions and standard headers for accessible implementations. This makes it possible to derive from the GTK accessible implementations without GType magic tricks. This is necessary, because we require the a11y type hierarchy to be parallel to the widget type hierarchy. So, if you derive a widget and need to adjust its a11y implementation, you have to be able to derive its accessible implementation. This commit probably exposes more than is absolutely necessary, it also exposes accessibles of widgets that are unlikely candidates for deriving from.
2012-12-27 06:04:46 +00:00
#define GTK_TYPE_CELL_ACCESSIBLE_PARENT (gtk_cell_accessible_parent_get_type ())
Convert GailCellParent to GtkCellAccessibleParent
2011-07-10 03:56:42 +00:00
#define GTK_IS_CELL_ACCESSIBLE_PARENT(obj) G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_CELL_ACCESSIBLE_PARENT)
#define GTK_CELL_ACCESSIBLE_PARENT(obj) G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_CELL_ACCESSIBLE_PARENT, GtkCellAccessibleParent)
#define GTK_CELL_ACCESSIBLE_PARENT_GET_IFACE(obj) (G_TYPE_INSTANCE_GET_INTERFACE ((obj), GTK_TYPE_CELL_ACCESSIBLE_PARENT, GtkCellAccessibleParentIface))
typedef struct _GtkCellAccessibleParent GtkCellAccessibleParent;
typedef struct _GtkCellAccessibleParentIface GtkCellAccessibleParentIface;
struct _GtkCellAccessibleParentIface
{
GTypeInterface parent;
void ( *get_cell_extents) (GtkCellAccessibleParent *parent,
GtkCellAccessible *cell,
gint *x,
gint *y,
gint *width,
gint *height,
AtkCoordType coord_type);
void ( *get_cell_area) (GtkCellAccessibleParent *parent,
GtkCellAccessible *cell,
GdkRectangle *cell_rect);
gboolean ( *grab_focus) (GtkCellAccessibleParent *parent,
GtkCellAccessible *cell);
a11y: Add _gtk_cell_accessible_parent_get_child_index() This will soon replace the shenanigans we do to keep the index of cells current.
2011-11-10 21:07:19 +00:00
int ( *get_child_index) (GtkCellAccessibleParent *parent,
GtkCellAccessible *cell);
a11y: Add get_renderer_state() to cell accessibles Accessibles can use this function to query the state that their row would be rendered with.
2011-11-24 00:55:38 +00:00
GtkCellRendererState
( *get_renderer_state) (GtkCellAccessibleParent *parent,
a11y: Don't duplicate information anymore We do provide the expandable and expanded information via GtkCellRendererState now so there is no need to use extra flags.
2011-12-11 02:02:12 +00:00
GtkCellAccessible *cell);
a11y: Redo cell accessible action handling Multiple changes: - actions are now available unconditionally, but only work in the right state. This mirrors other actions. - instead of adding actions manually, they invoke the action on the GtkCellAccessibleParent interface. Tests have been updated to reflect the changes
2011-12-12 14:18:54 +00:00
/* actions */
void ( *expand_collapse) (GtkCellAccessibleParent *parent,
GtkCellAccessible *cell);
void ( *activate) (GtkCellAccessibleParent *parent,
GtkCellAccessible *cell);
void ( *edit) (GtkCellAccessibleParent *parent,
GtkCellAccessible *cell);
a11y: Add API to update relationsets of cells to their parents
2014-03-24 14:51:38 +00:00
/* end of actions */
void ( *update_relationset) (GtkCellAccessibleParent *parent,
GtkCellAccessible *cell,
AtkRelationSet *relationset);
A11y: Add support for AtkTableCell
2018-12-14 19:25:27 +00:00
void ( *get_cell_position) (GtkCellAccessibleParent *parent,
GtkCellAccessible *cell,
gint *row,
gint *column);
GPtrArray * ( *get_column_header_cells) (GtkCellAccessibleParent *parent,
GtkCellAccessible *cell);
GPtrArray * ( *get_row_header_cells) (GtkCellAccessibleParent *parent,
GtkCellAccessible *cell);
Convert GailCellParent to GtkCellAccessibleParent
2011-07-10 03:56:42 +00:00
};
Add annotations in a11y headers
2013-05-05 18:24:55 +00:00
GDK_AVAILABLE_IN_ALL
Make accessible implementations public This commit exposes the get_type() functions and standard headers for accessible implementations. This makes it possible to derive from the GTK accessible implementations without GType magic tricks. This is necessary, because we require the a11y type hierarchy to be parallel to the widget type hierarchy. So, if you derive a widget and need to adjust its a11y implementation, you have to be able to derive its accessible implementation. This commit probably exposes more than is absolutely necessary, it also exposes accessibles of widgets that are unlikely candidates for deriving from.
2012-12-27 06:04:46 +00:00
GType gtk_cell_accessible_parent_get_type (void);
Convert GailCellParent to GtkCellAccessibleParent
2011-07-10 03:56:42 +00:00
Add annotations in a11y headers
2013-05-05 18:24:55 +00:00
GDK_AVAILABLE_IN_ALL
Make accessible implementations public This commit exposes the get_type() functions and standard headers for accessible implementations. This makes it possible to derive from the GTK accessible implementations without GType magic tricks. This is necessary, because we require the a11y type hierarchy to be parallel to the widget type hierarchy. So, if you derive a widget and need to adjust its a11y implementation, you have to be able to derive its accessible implementation. This commit probably exposes more than is absolutely necessary, it also exposes accessibles of widgets that are unlikely candidates for deriving from.
2012-12-27 06:04:46 +00:00
void gtk_cell_accessible_parent_get_cell_extents (GtkCellAccessibleParent *parent,
GtkCellAccessible *cell,
gint *x,
gint *y,
gint *width,
gint *height,
AtkCoordType coord_type);
Add annotations in a11y headers
2013-05-05 18:24:55 +00:00
GDK_AVAILABLE_IN_ALL
Make accessible implementations public This commit exposes the get_type() functions and standard headers for accessible implementations. This makes it possible to derive from the GTK accessible implementations without GType magic tricks. This is necessary, because we require the a11y type hierarchy to be parallel to the widget type hierarchy. So, if you derive a widget and need to adjust its a11y implementation, you have to be able to derive its accessible implementation. This commit probably exposes more than is absolutely necessary, it also exposes accessibles of widgets that are unlikely candidates for deriving from.
2012-12-27 06:04:46 +00:00
void gtk_cell_accessible_parent_get_cell_area (GtkCellAccessibleParent *parent,
GtkCellAccessible *cell,
GdkRectangle *cell_rect);
Add annotations in a11y headers
2013-05-05 18:24:55 +00:00
GDK_AVAILABLE_IN_ALL
Make accessible implementations public This commit exposes the get_type() functions and standard headers for accessible implementations. This makes it possible to derive from the GTK accessible implementations without GType magic tricks. This is necessary, because we require the a11y type hierarchy to be parallel to the widget type hierarchy. So, if you derive a widget and need to adjust its a11y implementation, you have to be able to derive its accessible implementation. This commit probably exposes more than is absolutely necessary, it also exposes accessibles of widgets that are unlikely candidates for deriving from.
2012-12-27 06:04:46 +00:00
gboolean gtk_cell_accessible_parent_grab_focus (GtkCellAccessibleParent *parent,
GtkCellAccessible *cell);
Add annotations in a11y headers
2013-05-05 18:24:55 +00:00
GDK_AVAILABLE_IN_ALL
Make accessible implementations public This commit exposes the get_type() functions and standard headers for accessible implementations. This makes it possible to derive from the GTK accessible implementations without GType magic tricks. This is necessary, because we require the a11y type hierarchy to be parallel to the widget type hierarchy. So, if you derive a widget and need to adjust its a11y implementation, you have to be able to derive its accessible implementation. This commit probably exposes more than is absolutely necessary, it also exposes accessibles of widgets that are unlikely candidates for deriving from.
2012-12-27 06:04:46 +00:00
int gtk_cell_accessible_parent_get_child_index (GtkCellAccessibleParent *parent,
GtkCellAccessible *cell);
Add annotations in a11y headers
2013-05-05 18:24:55 +00:00
GDK_AVAILABLE_IN_ALL
a11y: Add get_renderer_state() to cell accessibles Accessibles can use this function to query the state that their row would be rendered with.
2011-11-24 00:55:38 +00:00
GtkCellRendererState
Make accessible implementations public This commit exposes the get_type() functions and standard headers for accessible implementations. This makes it possible to derive from the GTK accessible implementations without GType magic tricks. This is necessary, because we require the a11y type hierarchy to be parallel to the widget type hierarchy. So, if you derive a widget and need to adjust its a11y implementation, you have to be able to derive its accessible implementation. This commit probably exposes more than is absolutely necessary, it also exposes accessibles of widgets that are unlikely candidates for deriving from.
2012-12-27 06:04:46 +00:00
gtk_cell_accessible_parent_get_renderer_state(GtkCellAccessibleParent *parent,
a11y: Redo cell accessible action handling Multiple changes: - actions are now available unconditionally, but only work in the right state. This mirrors other actions. - instead of adding actions manually, they invoke the action on the GtkCellAccessibleParent interface. Tests have been updated to reflect the changes
2011-12-12 14:18:54 +00:00
GtkCellAccessible *cell);
Add annotations in a11y headers
2013-05-05 18:24:55 +00:00
GDK_AVAILABLE_IN_ALL
Make accessible implementations public This commit exposes the get_type() functions and standard headers for accessible implementations. This makes it possible to derive from the GTK accessible implementations without GType magic tricks. This is necessary, because we require the a11y type hierarchy to be parallel to the widget type hierarchy. So, if you derive a widget and need to adjust its a11y implementation, you have to be able to derive its accessible implementation. This commit probably exposes more than is absolutely necessary, it also exposes accessibles of widgets that are unlikely candidates for deriving from.
2012-12-27 06:04:46 +00:00
void gtk_cell_accessible_parent_expand_collapse (GtkCellAccessibleParent *parent,
GtkCellAccessible *cell);
Add annotations in a11y headers
2013-05-05 18:24:55 +00:00
GDK_AVAILABLE_IN_ALL
Make accessible implementations public This commit exposes the get_type() functions and standard headers for accessible implementations. This makes it possible to derive from the GTK accessible implementations without GType magic tricks. This is necessary, because we require the a11y type hierarchy to be parallel to the widget type hierarchy. So, if you derive a widget and need to adjust its a11y implementation, you have to be able to derive its accessible implementation. This commit probably exposes more than is absolutely necessary, it also exposes accessibles of widgets that are unlikely candidates for deriving from.
2012-12-27 06:04:46 +00:00
void gtk_cell_accessible_parent_activate (GtkCellAccessibleParent *parent,
GtkCellAccessible *cell);
Add annotations in a11y headers
2013-05-05 18:24:55 +00:00
GDK_AVAILABLE_IN_ALL
Make accessible implementations public This commit exposes the get_type() functions and standard headers for accessible implementations. This makes it possible to derive from the GTK accessible implementations without GType magic tricks. This is necessary, because we require the a11y type hierarchy to be parallel to the widget type hierarchy. So, if you derive a widget and need to adjust its a11y implementation, you have to be able to derive its accessible implementation. This commit probably exposes more than is absolutely necessary, it also exposes accessibles of widgets that are unlikely candidates for deriving from.
2012-12-27 06:04:46 +00:00
void gtk_cell_accessible_parent_edit (GtkCellAccessibleParent *parent,
GtkCellAccessible *cell);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
a11y: Add API to update relationsets of cells to their parents
2014-03-24 14:51:38 +00:00
void gtk_cell_accessible_parent_update_relationset (GtkCellAccessibleParent *parent,
GtkCellAccessible *cell,
AtkRelationSet *relationset);
A11y: Add support for AtkTableCell
2018-12-14 19:25:27 +00:00
GDK_AVAILABLE_IN_ALL
void gtk_cell_accessible_parent_get_cell_position(GtkCellAccessibleParent *parent,
GtkCellAccessible *cell,
gint *row,
gint *column);
GPtrArray *gtk_cell_accessible_parent_get_column_header_cells (GtkCellAccessibleParent *parent,
GtkCellAccessible *cell);
GPtrArray *gtk_cell_accessible_parent_get_row_header_cells (GtkCellAccessibleParent *parent,
GtkCellAccessible *cell);
Convert GailCellParent to GtkCellAccessibleParent
2011-07-10 03:56:42 +00:00
G_END_DECLS
#endif /* __GTK_CELL_ACCESSIBLE_PARENT_H__ */
Reference in New Issue Copy Permalink