MGtk VBox

MGtk VBox — Strumenti per l'archiviazione di strutture GtkVBox.

Stability Level

Unstable, unless otherwise indicated

Synopsis

#include <mgtk.h>

extern              mboolean mgtk_vbox_default_homogeneous;
extern              mint mgtk_vbox_default_spacing;
struct              MGtkVBoxData;
struct              MGtkVBox;
#define             MGTK_VBOX                           (data)
#define             MGTK_VBOX_user                      (data)
#define             MGTK_VBOX_vbox                      (data)
#define             MGTK_GET_M_VBOX                     (master,
                                                         vbox_collection,
                                                         mvbox_id)
#define             MGTK_GET_VBOX                       (master,
                                                         vbox_collection,
                                                         mvbox_id)
#define             MGTK_VBOX_S_                        (master,
                                                         mvbox_id)
#define             MGTK_M_VBOX_S_                      (master,
                                                         mvbox_id)
#define             MGTK_VBOX_                          (mvbox_id)
#define             MGTK_M_VBOX_                        (mvbox_id)
#define             MGTK_VBOX_SUBMASTER                 (master)
#define             MGTK_VBOX_ARCHIVE_ID                (idarchive,
                                                         id,
                                                         label)
#define             MGTK_VBOX_ARCHIVE_ID_SELECT         (idarchive,
                                                         master,
                                                         id,
                                                         label)
MGtkVBox *          mgtk_vbox_new                       (mboolean homogeneous,
                                                         mint spacing);
MGtkVBox *          mgtk_vbox_new_attach                (GtkVBox *vbox);
MStatus             mgtk_vbox_free                      (MGtkVBox *mvbox);
MId                 mgtk_vbox_collection                (MICollections *master);
MId                 mgtk_vbox_insert_select             (MICollections *master,
                                                         mboolean homogeneous,
                                                         mint spacing);
MId                 mgtk_vbox_insert                    (mboolean homogeneous,
                                                         mint spacing);
MId                 mgtk_vbox_insert_select_attach      (MICollections *master,
                                                         GtkVBox *vbox);
MId                 mgtk_vbox_insert_attach             (GtkVBox *vbox);

Description

Attraverso la struttura MGtkVBox è possibile archiviare strutture GtkVBox attraverso il sistema "MGtk Master Widgets".

Details

mgtk_vbox_default_homogeneous

extern mboolean mgtk_vbox_default_homogeneous;

Utilizzata nel passaggio di argomenti alle funzioni.

Viene impostata come HOMOGENEOUS_OFF

mgtk_vbox_default_spacing

extern mint mgtk_vbox_default_spacing;

Utilizzata nel passaggio di argomenti alle funzioni.

Viene impostata come SPACING_OFF

struct MGtkVBoxData

struct MGtkVBoxData {
            GtkVBox*        vbox;

            mboolean        homogeneous;

            mint            spacing;
};

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

GtkVBox *vbox;

 una GtkVBox allocata e inizializzata

mboolean homogeneous;

 TRUE if all children are to be given equal space allotments

mint spacing;

 the number of pixels to place by default between children

struct MGtkVBox

struct MGtkVBox {
        GtkWidget* const        vbox;
};

Contiene l'indirizzo ad una struttura GtkVBox 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 MGtkVBox.

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

GtkWidget * const         vbox;

 indirizzo ad una struttura di tipo GtkVBox - only Read

MGTK_VBOX()

    #define MGTK_VBOX(data)     ds_CAST (MGtkVBox*,data)

stability: Unstable

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

data :

 struttura derivata

MGTK_VBOX_user()

    #define MGTK_VBOX_user(data)     ds_GET_PROPERTY(MGTK_VBOX(data),user)

stability: Unstable

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

data :

 una struttura derivata

MGTK_VBOX_vbox()

    #define MGTK_VBOX_vbox(data)     ds_GET_PROPERTY(MGTK_VBOX(data),vbox)

stability: Unstable

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

data :

 una struttura derivata

MGTK_GET_M_VBOX()

#define             MGTK_GET_M_VBOX(master,vbox_collection,mvbox_id)

stability: Unstable

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

Questa macro è utilizzata prevalentemente dal sistema.

master :

 un archivio "master" di tipo MICollections

vbox_collection :

 identificativo della collezione di MGtkVBox archiviata

mvbox_id :

 identificativo dell'elemento di tipo MGtkVBox archiviato

MGTK_GET_VBOX()

#define             MGTK_GET_VBOX(master,vbox_collection,mvbox_id)

stability: Unstable

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

Questa macro è utilizzata prevalentemente dal sistema.

master :

 un archivio "master" di tipo MICollections

vbox_collection :

 identificativo della collezione di MGtkVBox archiviata

mvbox_id :

 identificativo dell'elemento di tipo MGtkVBox archiviato

MGTK_VBOX_S_()

#define             MGTK_VBOX_S_(master,mvbox_id)

stability: Unstable

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

master :

 un archivio "master" di tipo MICollections

mvbox_id :

 identificativo dell'elemento di tipo MGtkVBox archiviato

MGTK_M_VBOX_S_()

#define             MGTK_M_VBOX_S_(master,mvbox_id)

stability: Unstable

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

master :

 un archivio "master" di tipo MICollections

mvbox_id :

 identificativo dell'elemento di tipo MGtkVBox archiviato

MGTK_VBOX_()

#define             MGTK_VBOX_(mvbox_id)

stability: Unstable

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

mvbox_id :

 identificativo dell'elemento di tipo MGtkVBox archiviato

MGTK_M_VBOX_()

#define             MGTK_M_VBOX_(mvbox_id)

stability: Unstable

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

mvbox_id :

 identificativo dell'elemento di tipo MGtkVBox archiviato

MGTK_VBOX_SUBMASTER()

#define             MGTK_VBOX_SUBMASTER(master)

stability: Unstable

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

master :

 indirizzo ad una struttura derivata allocata di tipo MICollection

Returns :

 una struttura derivata di tipo MICollectionQuark o NULL in caso di errore

MGTK_VBOX_ARCHIVE_ID()

#define             MGTK_VBOX_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.

idarchive :

 un MIdArchive inizializzato

id :

 un identificativo univoco relativo a un MGtkVBox

label :

 una stringa univoca che identifica l'identificativo id

Returns :

 un identificativo valido o MERROR in caso di errore

MGTK_VBOX_ARCHIVE_ID_SELECT()

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

stability: Unstable

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

idarchive :

 un MIdArchive inizializzato

master :

 indirizzo ad una struttura derivata allocata di tipo MICollection

id :

 un identificativo univoco relativo a un MGtkVBox

label :

 una stringa univoca che identifica l'identificativo id

Returns :

 un identificativo valido o MERROR in caso di errore

mgtk_vbox_new ()

MGtkVBox *          mgtk_vbox_new                       (mboolean homogeneous,
                                                         mint spacing);

stability: Unstable

Crea una nuova MGtkVBox.

homogeneous :

 TRUE if all children are to be given equal space allotments

spacing :

 the number of pixels to place by default between children

Returns :

 una nuova MGtkVBox o NULL in caso di errore.

Since 0.0.1

mgtk_vbox_new_attach ()

MGtkVBox *          mgtk_vbox_new_attach                (GtkVBox *vbox);

stability: Unstable

Crea una nuova MGtkVBox. Non viene creata una nuova GtkVBox come nella funzione mgtk_vbox_new() ma viene inserita quella passata come argomento vbox.

vbox :

 una GtkVBox allocata e inizializzata

Returns :

 una nuova MGtkVBox o NULL in caso di errore.

Since 0.0.1

mgtk_vbox_free ()

MStatus             mgtk_vbox_free                      (MGtkVBox *mvbox);

stability: Unstable

Libera la memoria allocata per una MGtkVBox.

mvbox :

 indirizzo ad una struttura derivata allocata di tipo MGtkVBox

Returns :

 MCORRECT o MERROR in caso di errore.

Since 0.0.1

mgtk_vbox_collection ()

MId                 mgtk_vbox_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 MGtkVBox.

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

master :

 indirizzo ad una struttura derivata allocata di tipo MICollections

Returns :

 l'identificativo alla relativa struttura derivata di tipo MICollectionQuark archiviata nel master. Nel caso fosse già stato passato alla funzione mgtk_vbox_collection() l'indirizzo master, viene ritornato l'identificativo alla relativa struttura derivata di tipo MICollectionQuark già archiviata.

Since 0.0.1

mgtk_vbox_insert_select ()

MId                 mgtk_vbox_insert_select             (MICollections *master,
                                                         mboolean homogeneous,
                                                         mint spacing);

stability: Unstable

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

master :

 indirizzo ad una struttura derivata allocata di tipo MICollection

homogeneous :

 TRUE if all children are to be given equal space allotments

spacing :

 the number of pixels to place by default between children

Returns :

 l'identificativo ad una nuova MGtkVBox o MERROR in caso di errore.

Since 0.0.1

mgtk_vbox_insert ()

MId                 mgtk_vbox_insert                    (mboolean homogeneous,
                                                         mint spacing);

stability: Unstable

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

homogeneous :

 TRUE if all children are to be given equal space allotments

spacing :

 the number of pixels to place by default between children

Returns :

 l'identificativo ad una nuova MGtkVBox o MERROR in caso di errore.

Since 0.0.1

mgtk_vbox_insert_select_attach ()

MId                 mgtk_vbox_insert_select_attach      (MICollections *master,
                                                         GtkVBox *vbox);

stability: Unstable

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

Non viene creata una nuova GtkVBox come nella funzione mgtk_vbox_insert_select() ma viene inserita quella passata come argomento vbox.

master :

 indirizzo ad una struttura derivata allocata di tipo MICollection

vbox :

 una GtkVBox allocata e inizializzata

Returns :

 l'identificativo ad una nuova MGtkVBox o MERROR in caso di errore.

Since 0.0.1

mgtk_vbox_insert_attach ()

MId                 mgtk_vbox_insert_attach             (GtkVBox *vbox);

stability: Unstable

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

Non viene creata una nuova GtkVBox come nella funzione mgtk_vbox_insert() ma viene inserita quella passata come argomento vbox.

vbox :

 una GtkVBox allocata e inizializzata

Returns :

 l'identificativo ad una nuova MGtkVBox o MERROR in caso di errore.

Since 0.0.1

Generated by GTK-Doc V1.14