|  |  |  | GAIL Reference Manual | |
|---|---|---|---|---|
| GailMiscGailMisc — GailMisc is a set of utility functions which may be useful to implementors of Atk interfaces for custom widgets. | 
AtkAttributeSet* gail_misc_add_attribute (AtkAttributeSet *attrib_set, AtkTextAttribute attr, gchar *value); AtkAttributeSet* gail_misc_layout_get_run_attributes (AtkAttributeSet *attrib_set, PangoLayout *layout, gchar *text, gint offset, gint *start_offset, gint *end_offset); AtkAttributeSet* gail_misc_get_default_attributes (AtkAttributeSet *attrib_set, PangoLayout *layout, GtkWidget *widget); void gail_misc_get_extents_from_pango_rectangle (GtkWidget *widget, PangoRectangle *char_rect, gint x_layout, gint y_layout, gint *x, gint *y, gint *width, gint *height, AtkCoordType coords); gint gail_misc_get_index_at_point_in_layout (GtkWidget *widget, PangoLayout *layout, gint x_layout, gint y_layout, gint x, gint y, AtkCoordType coords); void gail_misc_get_origins (GtkWidget *widget, gint *x_window, gint *y_window, gint *x_toplevel, gint *y_toplevel); AtkAttributeSet* gail_misc_add_to_attr_set (AtkAttributeSet *attrib_set, GtkTextAttributes *attrs, AtkTextAttribute attr); AtkAttributeSet* gail_misc_buffer_get_run_attributes (GtkTextBuffer *buffer, gint offset, gint *start_offset, gint *end_offset);
GailMisc is a set of utility function which are used in the implemementation of Atk interfaces for Gtk widgets. They may be useful to implementors of Atk interfaces for custom widgets.
AtkAttributeSet* gail_misc_add_attribute (AtkAttributeSet *attrib_set, AtkTextAttribute attr, gchar *value);
Creates an AtkAttribute from attr and value, and adds it
to attrib_set.
| attrib_set: | The AtkAttributeSet to add the attribute to | 
| attr: | The AtkTextAttrribute which identifies the attribute to be added | 
| value: | The attribute value | 
| Returns : | A pointer to the new AtkAttributeSet. | 
AtkAttributeSet* gail_misc_layout_get_run_attributes (AtkAttributeSet *attrib_set, PangoLayout *layout, gchar *text, gint offset, gint *start_offset, gint *end_offset);
Adds the attributes for the run starting at offset to the specified attribute set.
| attrib_set: | The AtkAttributeSet to add the attribute to | 
| layout: | The PangoLayout from which the attributes will be obtained | 
| text: | The text | 
| offset: | The offset at which the attributes are required | 
| start_offset: | The start offset of the current run | 
| end_offset: | The end offset of the current run | 
| Returns : | A pointer to the AtkAttributeSet. | 
AtkAttributeSet* gail_misc_get_default_attributes (AtkAttributeSet *attrib_set, PangoLayout *layout, GtkWidget *widget);
Adds the default attributes to the specified attribute set.
| attrib_set: | The AtkAttributeSet to add the attribute to | 
| layout: | The PangoLayout from which the attributes will be obtained | 
| widget: | The GtkWidget for which the default attributes are required. | 
| Returns : | A pointer to the AtkAttributeSet. | 
void        gail_misc_get_extents_from_pango_rectangle
                                            (GtkWidget *widget,
                                             PangoRectangle *char_rect,
                                             gint x_layout,
                                             gint y_layout,
                                             gint *x,
                                             gint *y,
                                             gint *width,
                                             gint *height,
                                             AtkCoordType coords);
Gets the extents of char_rect in device coordinates,
relative to either top-level window or screen coordinates as
specified by coords.
| widget: | The widget that contains the PangoLayout, that contains the PangoRectangle | 
| char_rect: | The PangoRectangle from which to calculate extents | 
| x_layout: | The x-offset at which the widget displays the
  PangoLayout that contains the PangoRectangle, relative to widget | 
| y_layout: | The y-offset at which the widget displays the
  PangoLayout that contains the PangoRectangle, relative to widget | 
| x: | The x-position of the PangoRectangle relative to coords | 
| y: | The y-position of the PangoRectangle relative to coords | 
| width: | The width of the PangoRectangle | 
| height: | The height of the PangoRectangle | 
| coords: | An AtkCoordType enumeration | 
gint gail_misc_get_index_at_point_in_layout (GtkWidget *widget, PangoLayout *layout, gint x_layout, gint y_layout, gint x, gint y, AtkCoordType coords);
Gets the byte offset at the specified x and y in a PangoLayout.
| widget: | A GtkWidget | 
| layout: | The PangoLayout from which to get the index at the specified point. | 
| x_layout: | The x-offset at which the widget displays the
  PangoLayout, relative to widget | 
| y_layout: | The y-offset at which the widget displays the
  PangoLayout, relative to widget | 
| x: | The x-coordinate relative to coordsat which to
  calculate the index | 
| y: | The y-coordinate relative to coordsat which to
  calculate the index | 
| coords: | An AtkCoordType enumeration | 
| Returns : | the byte offset at the specified xandyin a
  PangoLayout | 
void gail_misc_get_origins (GtkWidget *widget, gint *x_window, gint *y_window, gint *x_toplevel, gint *y_toplevel);
Gets the origin of the widget window, and the origin of the widgets top-level window.
| widget: | a GtkWidget | 
| x_window: | the x-origin of the widget->window | 
| y_window: | the y-origin of the widget->window | 
| x_toplevel: | the x-origin of the toplevel window for widget->window | 
| y_toplevel: | the y-origin of the toplevel window for widget->window | 
AtkAttributeSet* gail_misc_add_to_attr_set (AtkAttributeSet *attrib_set, GtkTextAttributes *attrs, AtkTextAttribute attr);
Gets the value for the AtkTextAttribute from the GtkTextAttributes and adds it to the AttributeSet.
| attrib_set: | An AtkAttributeSet | 
| attrs: | The GtkTextAttributes containing the attribute value | 
| attr: | The AtkTextAttribute to be added | 
| Returns : | A pointer to the updated AtkAttributeSet. | 
AtkAttributeSet* gail_misc_buffer_get_run_attributes (GtkTextBuffer *buffer, gint offset, gint *start_offset, gint *end_offset);
Creates an AtkAttributeSet which contains the attributes for the run starting at offset.
| buffer: | The GtkTextBuffer for which the attributes will be obtained | 
| offset: | The offset at which the attributes are required | 
| start_offset: | The start offset of the current run | 
| end_offset: | The end offset of the current run | 
| Returns : | A pointer to the AtkAttributeSet. |