CailMisc: CAIL Reference Manual

CailMisc

CailMisc — CailMisc is a set of utility functions which may be useful to implementors of Atk interfaces for custom widgets.

Functions

AtkAttributeSet *	cail_misc_add_attribute ()
AtkAttributeSet *	cail_misc_layout_get_run_attributes ()
AtkAttributeSet *	cail_misc_get_default_attributes ()
void	cail_misc_get_extents_from_pango_rectangle ()
gint	cail_misc_get_index_at_point_in_layout ()
void	cail_misc_get_origins ()
AtkAttributeSet *	cail_misc_buffer_get_run_attributes ()

Description

CailMisc is a set of utility function which are used in the implemementation of Atk interfaces for CTK+ widgets. They may be useful to implementors of Atk interfaces for custom widgets.

Functions

cail_misc_add_attribute ()

AtkAttributeSet *
cail_misc_add_attribute (AtkAttributeSet *attrib_set,
                         AtkTextAttribute attr,
                         gchar *value);

Creates an AtkAttribute from attr and value , and adds it to attrib_set .

Parameters

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.

cail_misc_layout_get_run_attributes ()

AtkAttributeSet *
cail_misc_layout_get_run_attributes (AtkAttributeSet *attrib_set,
                                     PangoLayout *layout,
                                     const gchar *text,
                                     gint offset,
                                     gint *start_offset,
                                     gint *end_offset);

Adds the attributes for the run starting at offset to the specified attribute set.

Parameters

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.

cail_misc_get_default_attributes ()

AtkAttributeSet *
cail_misc_get_default_attributes (AtkAttributeSet *attrib_set,
                                  PangoLayout *layout,
                                  CtkWidget *widget);

Adds the default attributes to the specified attribute set.

Parameters

attrib_set	The AtkAttributeSet to add the attribute to
layout	The PangoLayout from which the attributes will be obtained
widget	The CtkWidget for which the default attributes are required.

Returns

A pointer to the AtkAttributeSet.

cail_misc_get_extents_from_pango_rectangle ()

void
cail_misc_get_extents_from_pango_rectangle
                               (CtkWidget *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 .

Parameters

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

cail_misc_get_index_at_point_in_layout ()

gint
cail_misc_get_index_at_point_in_layout
                               (CtkWidget *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.

Parameters

widget	A CtkWidget
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

cail_misc_get_origins ()

void
cail_misc_get_origins (CtkWidget *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.

Parameters

widget	a CtkWidget
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

cail_misc_buffer_get_run_attributes ()

AtkAttributeSet *
cail_misc_buffer_get_run_attributes (CtkTextBuffer *buffer,
                                     gint offset,
                                     gint *start_offset,
                                     gint *end_offset);

Creates an AtkAttributeSet which contains the attributes for the run starting at offset.

Parameters

buffer	The CtkTextBuffer 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.