| | | GAIL Reference Manual |
|---|
GailMisc — 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 coords at which to calculate the index |
| y : | The y-coordinate relative to coords at which to calculate the index |
| coords : | An AtkCoordType enumeration |
| Returns : | the byte offset at the specified x and y in 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. |
| << GailTextUtil |