|  |  |  | 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.
| 
 | The AtkAttributeSet to add the attribute to | 
| 
 | The AtkTextAttrribute which identifies the attribute to be added | 
| 
 | 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.
| 
 | The AtkAttributeSet to add the attribute to | 
| 
 | The PangoLayout from which the attributes will be obtained | 
| 
 | The text | 
| 
 | The offset at which the attributes are required | 
| 
 | The start offset of the current run | 
| 
 | 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.
| 
 | The AtkAttributeSet to add the attribute to | 
| 
 | The PangoLayout from which the attributes will be obtained | 
| 
 | 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.
| 
 | The widget that contains the PangoLayout, that contains the PangoRectangle | 
| 
 | The PangoRectangle from which to calculate extents | 
| 
 | The x-offset at which the widget displays the
  PangoLayout that contains the PangoRectangle, relative to widget | 
| 
 | The y-offset at which the widget displays the
  PangoLayout that contains the PangoRectangle, relative to widget | 
| 
 | The x-position of the PangoRectangle relative to coords | 
| 
 | The y-position of the PangoRectangle relative to coords | 
| 
 | The width of the PangoRectangle | 
| 
 | The height of the PangoRectangle | 
| 
 | 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.
| 
 | A GtkWidget | 
| 
 | The PangoLayout from which to get the index at the specified point. | 
| 
 | The x-offset at which the widget displays the
  PangoLayout, relative to widget | 
| 
 | The y-offset at which the widget displays the
  PangoLayout, relative to widget | 
| 
 | The x-coordinate relative to coordsat which to
  calculate the index | 
| 
 | The y-coordinate relative to coordsat which to
  calculate the index | 
| 
 | 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.
| 
 | a GtkWidget | 
| 
 | the x-origin of the widget->window | 
| 
 | the y-origin of the widget->window | 
| 
 | the x-origin of the toplevel window for widget->window | 
| 
 | 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.
| 
 | An AtkAttributeSet | 
| 
 | The GtkTextAttributes containing the attribute value | 
| 
 | 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.
| 
 | The GtkTextBuffer for which the attributes will be obtained | 
| 
 | The offset at which the attributes are required | 
| 
 | The start offset of the current run | 
| 
 | The end offset of the current run | 
| Returns : | A pointer to the AtkAttributeSet. |