|
|
|
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 coords at which to
calculate the index
|
|
The y-coordinate relative to coords at which to
calculate the index
|
|
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.
|
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. |