![]() |
![]() |
![]() |
adg-1 reference manual |
![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy |
AdgTableRow; constCpmlExtents * adg_table_row_arrange (AdgTableRow *table_row
,const
); AdgTableRow * adg_table_row_dup (CpmlExtents *layoutconst AdgTableRow *table_row
);void adg_table_row_foreach (AdgTableRow *table_row
,,
GCallback callback);
gpointer user_datavoid adg_table_row_free (AdgTableRow *table_row
); constCpmlExtents * adg_table_row_get_extents (AdgTableRow *table_row
);gdouble adg_table_row_get_height (AdgTableRow *table_row
); AdgTable * adg_table_row_get_table (AdgTableRow *table_row
);void adg_table_row_insert (AdgTableRow *table_row
,AdgTableCell *table_cell
,AdgTableCell *before_cell
); AdgTableRow * adg_table_row_new (AdgTable *table
); AdgTableRow * adg_table_row_new_before (AdgTableRow *before_row
);void adg_table_row_remove (AdgTableRow *table_row
,AdgTableCell *table_cell
);void adg_table_row_set_height (AdgTableRow *table_row
,); const AdgPair * adg_table_row_size_request (
gdouble heightAdgTableRow *table_row
);
The AdgTableRow is a boxed type containing a single row of cells of an AdgTable object.
Every row is segmented into different cells. It must be populated
by using the adg_table_cell_new()
or
adg_table_cell_new_before()
.
typedef struct _AdgTableRow AdgTableRow;
An opaque structure referring to a row of an AdgTable. Any table can have an unlimited number of rows.
Since 1.0
constCpmlExtents * adg_table_row_arrange (AdgTableRow *table_row
,const
);CpmlExtents *layout
Rearranges the underlying AdgTableCell owned by table_row
using
the new extents provided in layout
. If the x or y size component
of layout
is negative, the value holded by the internal extents
struct is not overriden.
table_row->extents must be up to date if layout->size.x
or
layout->size.y
is negative in order to have a valid size.
|
an AdgTableRow |
|
the new extents to use |
Returns : |
the extents of table_row or NULL |
Since 1.0
AdgTableRow * adg_table_row_dup (const AdgTableRow *table_row
);
Duplicates table_row
. The returned duplicate should be freed
with adg_table_row_free()
when no longer needed.
|
an AdgTableRow structure |
Returns : |
a duplicate of table_row . [transfer full] |
Since 1.0
void adg_table_row_foreach (AdgTableRow *table_row
,,
GCallback callback);
gpointer user_data
Invokes callback
on each cell of table_row
.
The callback should be declared as:
void callback(AdgTableCell *table_cell, gpointer user_data);
|
an AdgTableRow |
|
a callback. [scope call] |
|
callback user data |
Since 1.0
void adg_table_row_free (AdgTableRow *table_row
);
Releases all the memory allocated by table_row
, itself included.
|
an AdgTableRow structure |
Since 1.0
constCpmlExtents * adg_table_row_get_extents (AdgTableRow *table_row
);
Gets the extents of table_row
. This function is useful only after
the arrange()
|
a valid AdgTableRow |
Returns : |
the extents of table_row or NULL |
Since 1.0
gdouble adg_table_row_get_height (AdgTableRow *table_row
);
Gets the height of table_row
.
|
a valid AdgTableRow |
Returns : |
the requested height or 0 |
Since 1.0
AdgTable * adg_table_row_get_table (AdgTableRow *table_row
);
Returns the container table of table_row
. The returned table
is owned by table_row
and must not be modified or freed.
|
a valid AdgTableRow |
Returns : |
the requested table or NULL |
Since 1.0
void adg_table_row_insert (AdgTableRow *table_row
,AdgTableCell *table_cell
,AdgTableCell *before_cell
);
Inserts table_cell
inside table_row
. If before_cell
is specified, table_cell
is inserted before it.
|
a valid AdgTableRow |
|
the AdgTableCell to insert |
|
an AdgTableRow or NULL |
Since 1.0
AdgTableRow * adg_table_row_new (AdgTable *table
);
Creates a new empty row and appends it at the end of the rows
yet present in table
. By default, the height of this new
row will be the fallback value provided by the table style:
you can override it by using adg_table_row_set_height()
.
|
an AdgTable |
Returns : |
the newly created row or NULL |
Since 1.0
AdgTableRow * adg_table_row_new_before (AdgTableRow *before_row
);
Creates a new empty row with default height and inserts it
just before before_row
.
|
a valid AdgTableRow |
Returns : |
the newly created row or NULL |
Since 1.0
void adg_table_row_remove (AdgTableRow *table_row
,AdgTableCell *table_cell
);
Removes table_cell
from list of cells of table_row
.
|
a valid AdgTableRow |
|
the AdgTableCell to remove |
Since 1.0
void adg_table_row_set_height (AdgTableRow *table_row
,);
gdouble height
Sets a new height on table_row
. The extents will be invalidated to
recompute the whole layout of the table. Specifying 0
height
will use the default height set in the table style.
|
a valid AdgTableRow |
|
the new height |
Since 1.0
const AdgPair * adg_table_row_size_request (AdgTableRow *table_row
);
Computes the minimum space needed to properly render table_row
and updates the size component of the internal table_row
and should not be modified or freed.
|
a valid AdgTableRow |
Returns : |
the minimum size required. [transfer none] |
Since 1.0