GtkAccessible

GtkAccessible — Accessibility support for widgets

Synopsis

#include <gtk/gtk.h>

struct              GtkAccessible;
void                gtk_accessible_connect_widget_destroyed
                                                        (GtkAccessible *accessible);
GtkWidget *         gtk_accessible_get_widget           (GtkAccessible *accessible);
void                gtk_accessible_set_widget           (GtkAccessible *accessible,
                                                         GtkWidget *widget);

Object Hierarchy

  GObject
   +----AtkObject
         +----GtkAccessible

Properties

  "widget"                   GtkWidget*            : Read / Write

Description

The GtkAccessible class is the base class for accessible implementations for GtkWidget subclasses. It is a thin wrapper around AtkObject, which adds facilities for associating a widget with its accessible object.

An accessible implementation for a third-party widget should derive from GtkAccessible and implement the suitable interfaces from ATK, such as AtkText or AtkSelection. To establish the connection between the widget class and its corresponding acccessible implementation, override the get_accessible vfunc in GtkWidgetClass.

Details

struct GtkAccessible

struct GtkAccessible;

gtk_accessible_connect_widget_destroyed ()

void                gtk_accessible_connect_widget_destroyed
                                                        (GtkAccessible *accessible);

Warning

gtk_accessible_connect_widget_destroyed has been deprecated since version 3.4 and should not be used in newly-written code. Use gtk_accessible_set_widget() and its vfuncs.

This function specifies the callback function to be called when the widget corresponding to a GtkAccessible is destroyed.

accessible :

a GtkAccessible

gtk_accessible_get_widget ()

GtkWidget *         gtk_accessible_get_widget           (GtkAccessible *accessible);

Gets the GtkWidget corresponding to the GtkAccessible. The returned widget does not have a reference added, so you do not need to unref it.

`accessible` :	a GtkAccessible
Returns :	pointer to the GtkWidget corresponding to the GtkAccessible, or `NULL`. [transfer none]

Since 2.22

gtk_accessible_set_widget ()

void                gtk_accessible_set_widget           (GtkAccessible *accessible,
                                                         GtkWidget *widget);

Sets the GtkWidget corresponding to the GtkAccessible.

Note

accessible will not hold a reference to widget. It is the caller's responsibility to ensure that when widget is destroyed, the widget is unset by calling this function again with widget set to NULL.

`accessible` :	a GtkAccessible
`widget` :	a GtkWidget or `NULL` to unset. [allow-none]