mgtk_table_default_rows

extern muint mgtk_table_default_rows;

Utilizzata nel passaggio di argomenti alle funzioni.

Viene impostata come 4

mgtk_table_default_columns

extern muint mgtk_table_default_columns;

Utilizzata nel passaggio di argomenti alle funzioni.

Viene impostata come 4

mgtk_table_default_homogeneous

extern mboolean mgtk_table_default_homogeneous;

Utilizzata nel passaggio di argomenti alle funzioni.

Viene impostata come HOMOGENEOUS_OFF

struct MGtkTableData

struct MGtkTableData {
            GtkTable*       table;

            muint           rows;

            muint           columns;

            mboolean        homogeneous;
};

Utilizzata nel passaggio di argomenti alle funzioni di creazione/archiviazione di strutture derivate di tipo MGtkTable.

struct MGtkTable

struct MGtkTable {
        GtkWidget* const        table;
};

Contiene l'indirizzo ad una struttura GtkTable e delle specifiche proprietà per la corretta archiviazione di questa attraverso il sistema "MGtk Master Widgets".

Se utilizzata in una struttura non e' necessario che questa contenga una MDefine poiche' gia' presente nella MGtkTable.

Questa è una struttura derivata ed è diretta evoluzione della struttura MGtkObjectData, della quale eredita le proprietà.

struct MGtkAttachMapTable

struct MGtkAttachMapTable {
            muint           left_attach;

            muint           right_attach;

            muint           top_attach;

            muint           bottom_attach;
};

Contiene le informazioni rispetto ai confini di una cella singola o complessa all'interno di una GtkTable.

Secondo la libreria MGtk, per cella singola si intende uno spazio unitario all'interno di una tabella, confinante ai suoi quattro lati da altrettante celle unitarie.

Es. considerando una cella nei termini dei suoi quattro attacchi ( left_attach, right_attach, top_attach, bottom_attach ) una cella singola 'a' protrebbe così essere definita: a{ 0,1,2,3 }

Al contrario, per cella complessa si intende uno spazio non unitario, un'area, confinante ai suoi quattro lati con celle unitarie e celle complesse.

Es. considerando una cella nei termini dei suoi quattro attacchi ( left_attach, right_attach, top_attach, bottom_attach ) una cella complessa 'a' protrebbe così essere definita: a{ 0,2,2,4 }

struct MGtkAttach4MapTable

struct MGtkAttach4MapTable {
            MGtkAttachMapTable*         left_top_cell;

            MGtkAttachMapTable*         right_top_cell;

            MGtkAttachMapTable*         left_bottom_cell;

            MGtkAttachMapTable*         right_bottom_cell;
};

Contiene le informazioni rispetto ai confini di una cella singola o complessa, all'interno di una GtkTable.

I confini sono espressi attraverso i quattro angoli della cella, ognuno comprensivo dei 4 attacchi.

Nel caso particolare di una cella singola, i quattro angoli della cella espressi come celle, risultano essere la stessa cella.

Nel caso particolare di una cella lineare, gli angoli della cella risultano essere due coppie di celle simili.

MGTK_ATTACH_MAP_TABLE_EXPAND()

#define             MGTK_ATTACH_MAP_TABLE_EXPAND(map,cell)

stability: Unstable

si espande in 4 argomenti separati da virgola rappresentanti i quattro attacchi di una cella all'interno di una GtkTable. Non viene inserita una virgola dopo il quarto argomento.

MGTK_ATTACH_4MAP_TABLE_EXPAND()

#define             MGTK_ATTACH_4MAP_TABLE_EXPAND(map)

stability: Unstable

si espande in 4 argomenti separati da virgola rappresentanti i quattro attacchi di una cella all'interno di una GtkTable. Non viene inserita una virgola dopo il quarto argomento.

MGTK_4MAP_GET_LEFT_ATTACH()

#define             MGTK_4MAP_GET_LEFT_ATTACH(map)

stability: Unstable

si espande ritornando il campo "left_attach" della parete MGtkAttachMapTable costituente la cella.

MGTK_4MAP_GET_RIGHT_ATTACH()

#define             MGTK_4MAP_GET_RIGHT_ATTACH(map)

stability: Unstable

si espande ritornando il campo "right_attach" della parete MGtkAttachMapTable costituente la cella.

MGTK_4MAP_GET_TOP_ATTACH()

#define             MGTK_4MAP_GET_TOP_ATTACH(map)

stability: Unstable

si espande ritornando il campo "top_attach" della parete MGtkAttachMapTable costituente la cella.

MGTK_4MAP_GET_BOTTOM_ATTACH()

#define             MGTK_4MAP_GET_BOTTOM_ATTACH(map)

stability: Unstable

si espande ritornando il campo "bottom_attach" della parete MGtkAttachMapTable costituente la cella.

MGTK_TABLE()

    #define MGTK_TABLE(data)     ds_CAST (MGtkTable*,data)

stability: Unstable

Provvede al casting di una struttura data ritornando una struttura di tipo MGtkTable

MGTK_TABLE_user()

    #define MGTK_TABLE_user(data)     ds_GET_PROPERTY(MGTK_TABLE(data),user)

stability: Unstable

Provvede al casting di un dato data ritornando la proprietà "user"

MGTK_TABLE_table()

    #define MGTK_TABLE_table(data)     ds_GET_PROPERTY(MGTK_TABLE(data),table)

stability: Unstable

Provvede al casting di un dato data ritornando la proprietà "table"

MGTK_GET_M_TABLE()

#define             MGTK_GET_M_TABLE(master,table_collection,mtable_id)

stability: Unstable

Provvede al casting di un archivio "master" ritornando una struttura derivata di tipo MGtkTable

Questa macro è utilizzata prevalentemente dal sistema.

MGTK_GET_TABLE()

#define             MGTK_GET_TABLE(master,table_collection,mtable_id)

stability: Unstable

Provvede al casting di un archivio "master" ritornando una struttura di tipo GtkTable

Questa macro è utilizzata prevalentemente dal sistema.

MGTK_TABLE_S_()

#define             MGTK_TABLE_S_(master,mtable_id)

stability: Unstable

Provvede al casting di un archivio "master" personale,ritornando una struttura di tipo GtkTable

MGTK_M_TABLE_S_()

#define             MGTK_M_TABLE_S_(master,mtable_id)

stability: Unstable

Provvede al casting di un archivio "master" personale,ritornando una struttura derivata di tipo MGtkTable

MGTK_TABLE_()

#define             MGTK_TABLE_(mtable_id)

stability: Unstable

Provvede al casting dell'archivio "master" di default,ritornando una struttura di tipo GtkTable

MGTK_M_TABLE_()

#define             MGTK_M_TABLE_(mtable_id)

stability: Unstable

Provvede al casting dell'archivio "master" di default,ritornando una struttura derivata di tipo MGtkTable

MGTK_TABLE_SUBMASTER()

#define             MGTK_TABLE_SUBMASTER(master)

stability: Unstable

Provvede al casting di un archivio master,ritornando una sottostruttura submaster corrispondente la collezione di MGtkTable.

MGTK_TABLE_ARCHIVE_ID()

#define             MGTK_TABLE_ARCHIVE_ID(idarchive,id,label)

stability: Unstable

Inserisce un id in un MIdArchive al quale associa una stringa di identificazione label.

L'utilizzo di questa macro presuppone che il "master" sia quello di default.

MGTK_TABLE_ARCHIVE_ID_SELECT()

#define             MGTK_TABLE_ARCHIVE_ID_SELECT(idarchive,master,id,label)

stability: Unstable

Inserisce un id in un MIdArchive al quale associa una stringa di identificazione label.

mgtk_table_new ()

MGtkTable *         mgtk_table_new                      (muint rows,
                                                         muint columns,
                                                         mboolean homogeneous);

stability: Unstable

Crea una nuova MGtkTable.

Since 0.0.1

mgtk_squared_table_new ()

MGtkTable *         mgtk_squared_table_new              (muint area,
                                                         mboolean homogeneous);

stability: Unstable

Crea una nuova MGtkTable.

Differisce dalla funzione mgtk_table_new() perchè ritorna sempre una MGtkTable quadrata. L'argomento area specifica il numero di celle necessarie. Nel caso queste non rappresentino un quadrato perfetto, verrà creata la più piccola tabella quadrata costruibile.

Since 0.0.1

mgtk_table_new_attach ()

MGtkTable *         mgtk_table_new_attach               (GtkTable *table);

stability: Unstable

Crea una nuova MGtkTable. Non viene creata una nuova GtkTable come nella funzione mgtk_table_new() ma viene inserita quella passata come argomento table.

Since 0.0.1

mgtk_table_free ()

MStatus             mgtk_table_free                     (MGtkTable *mtable);

stability: Unstable

Libera la memoria allocata per una MGtkTable.

Since 0.0.1

mgtk_table_collection ()

MId                 mgtk_table_collection               (MICollections *master);

stability: Unstable

Archivia in una struttura derivata allocata master una collezione di tipo MICollectionQuark inizializzata per l'inserimento successivo di strutture derivate di tipo MGtkTable.

Provvede all'archiviazione dell'indirizzo alla struttura derivata master e dell'identificativo riferito alla struttura di tipo MICollectionQuark inizializzata.

Since 0.0.1

mgtk_table_insert_select ()

MId                 mgtk_table_insert_select            (MICollections *master,
                                                         muint rows,
                                                         muint columns,
                                                         mboolean homogeneous);

stability: Unstable

Crea una nuova MGtkTable e provvede alla sua archiviazione in una struttura derivata master di tipo MICollections.

Since 0.0.1

mgtk_table_insert ()

MId                 mgtk_table_insert                   (muint rows,
                                                         muint columns,
                                                         mboolean homogeneous);

stability: Unstable

Crea una nuova MGtkTable e provvede alla sua archiviazione nella struttura derivata "master" di tipo MICollections di default.

Since 0.0.1

mgtk_squared_table_insert_select ()

MId                 mgtk_squared_table_insert_select    (MICollections *master,
                                                         muint area,
                                                         mboolean homogeneous);

stability: Unstable

Crea una nuova MGtkTable e provvede alla sua archiviazione in una struttura derivata master di tipo MICollections.

Differisce dalla funzione mgtk_table_insert_select() perchè crea sempre una MGtkTable quadrata. L'argomento area specifica il numero di celle necessarie. Nel caso queste non rappresentino un quadrato perfetto, verrà creata la più piccola tabella quadrata costruibile.

Since 0.0.1

mgtk_squared_table_insert ()

MId                 mgtk_squared_table_insert           (muint area,
                                                         mboolean homogeneous);

stability: Unstable

Crea una nuova MGtkTable e provvede alla sua archiviazione nella struttura derivata "master" di tipo MICollections di default.

Differisce dalla funzione mgtk_table_insert() perchè crea sempre una MGtkTable quadrata. L'argomento area specifica il numero di celle necessarie. Nel caso queste non rappresentino un quadrato perfetto, verrà creata la più piccola tabella quadrata costruibile.

Since 0.0.1

mgtk_table_insert_select_attach ()

MId                 mgtk_table_insert_select_attach     (MICollections *master,
                                                         GtkTable *table);

stability: Unstable

Crea una nuova MGtkTable e provvede alla sua archiviazione in una struttura derivata master di tipo MICollections.

Non viene creata una nuova GtkTable come nella funzione mgtk_table_insert_select() ma viene inserita quella passata come argomento table.

Since 0.0.1

mgtk_table_insert_attach ()

MId                 mgtk_table_insert_attach            (GtkTable *table);

stability: Unstable

Crea una nuova MGtkTable e provvede alla sua archiviazione nella struttura derivata "master" di tipo MICollections di default.

Non viene creata una nuova GtkTable come nella funzione mgtk_table_insert() ma viene inserita quella passata come argomento table.

Since 0.0.1

mgtk_attach_map_table_validate ()

MStatus             mgtk_attach_map_table_validate      (MGtkAttachMapTable *map);

stability: Unstable

Controlla la validità dei confini di una cella.

Since 0.0.1

mgtk_attach_map_table_new ()

MGtkAttachMapTable * mgtk_attach_map_table_new          (muint left_attach,
                                                         muint right_attach,
                                                         muint top_attach,
                                                         muint bottom_attach);

stability: Unstable

Crea nuova MGtkAttachMapTable.

Since 0.0.1

mgtk_attach_mapping_table_new ()

MGtkAttachMapTable * mgtk_attach_mapping_table_new      (GtkTable *table);

stability: Unstable

Crea un array dinamico di MGtkAttachMapTable.

Attraverso questa funzione viene mappata una GtkTable table assegnando ad ogni cella singola un identificativo di posizione di tipo muint.

Since 0.0.1

mgtk_attach_maps_table_validate ()

MStatus             mgtk_attach_maps_table_validate     (MGtkAttachMapTable *left_top_cell,
                                                         MGtkAttachMapTable *right_top_cell,
                                                         MGtkAttachMapTable *left_bottom_cell,
                                                         MGtkAttachMapTable *right_bottom_cell);

stability: Unstable

Controlla la validità dei confini di una cella.

Since 0.0.1

mgtk_attach_4map_table_validate ()

MStatus             mgtk_attach_4map_table_validate     (MGtkAttach4MapTable *map);

stability: Unstable

Controlla la validità dei confini di una cella.

Since 0.0.1

mgtk_single_attach_4map_table_validate ()

MStatus             mgtk_single_attach_4map_table_validate
                                                        (MGtkAttach4MapTable *map);

stability: Unstable

Controlla la validità dei confini di una cella singola.

Since 0.0.1

mgtk_attach_4map_table_new ()

MGtkAttach4MapTable * mgtk_attach_4map_table_new        (MGtkAttachMapTable *left_top_cell,
                                                         MGtkAttachMapTable *right_top_cell,
                                                         MGtkAttachMapTable *left_bottom_cell,
                                                         MGtkAttachMapTable *right_bottom_cell);

stability: Unstable

Crea nuova MGtkAttach4MapTable.

Since 0.0.1

mgtk_attach_4map_table_new_from_angle ()

MGtkAttach4MapTable * mgtk_attach_4map_table_new_from_angle
                                                        (MGtkAttachMapTable *angle1,
                                                         MGtkAttachMapTable *angle2);

stability: Unstable

Crea nuova MGtkAttach4MapTable.

A differenza della funzione mgtk_attach_4map_table_new() vengono richiesti solo 2 argomenti rappresentanti 2 angoli opposti della cella da mappare.

Since 0.0.1

mgtk_attach_4map_table_to_one ()

MGtkAttachMapTable * mgtk_attach_4map_table_to_one      (MGtkAttach4MapTable *map);

stability: Unstable

Trasforma una cella espressa da una MGtkAttach4MapTable in una cella espressa da una MGtkAttachMapTable.

Since 0.0.1

mgtk_attach_map_table_to_four ()

MGtkAttach4MapTable * mgtk_attach_map_table_to_four     (MGtkAttachMapTable *map);

stability: Unstable

Trasforma una cella espressa da una MGtkAttachMapTable in una cella espressa da una MGtkAttach4MapTable.

Since 0.0.1