MGtk HBox

MGtk HBox — Strumenti per l'archiviazione di strutture GtkHBox.

Stability Level

Unstable, unless otherwise indicated

Synopsis

#include <mgtk.h>

extern              mboolean mgtk_hbox_default_homogeneous;
extern              mint mgtk_hbox_default_spacing;
struct              MGtkHBoxData;
struct              MGtkHBox;
#define             MGTK_HBOX                           (data)
#define             MGTK_HBOX_user                      (data)
#define             MGTK_HBOX_hbox                      (data)
#define             MGTK_GET_M_HBOX                     (master,
                                                         hbox_collection,
                                                         mhbox_id)
#define             MGTK_GET_HBOX                       (master,
                                                         hbox_collection,
                                                         mhbox_id)
#define             MGTK_HBOX_S_                        (master,
                                                         mhbox_id)
#define             MGTK_M_HBOX_S_                      (master,
                                                         mhbox_id)
#define             MGTK_HBOX_                          (mhbox_id)
#define             MGTK_M_HBOX_                        (mhbox_id)
#define             MGTK_HBOX_SUBMASTER                 (master)
#define             MGTK_HBOX_ARCHIVE_ID                (idarchive,
                                                         id,
                                                         label)
#define             MGTK_HBOX_ARCHIVE_ID_SELECT         (idarchive,
                                                         master,
                                                         id,
                                                         label)
MGtkHBox *          mgtk_hbox_new                       (mboolean homogeneous,
                                                         mint spacing);
MGtkHBox *          mgtk_hbox_new_attach                (GtkHBox *hbox);
MStatus             mgtk_hbox_free                      (MGtkHBox *mhbox);
MId                 mgtk_hbox_collection                (MICollections *master);
MId                 mgtk_hbox_insert_select             (MICollections *master,
                                                         mboolean homogeneous,
                                                         mint spacing);
MId                 mgtk_hbox_insert                    (mboolean homogeneous,
                                                         mint spacing);
MId                 mgtk_hbox_insert_select_attach      (MICollections *master,
                                                         GtkHBox *hbox);
MId                 mgtk_hbox_insert_attach             (GtkHBox *hbox);

Description

Attraverso la struttura MGtkHBox è possibile archiviare strutture GtkHBox attraverso il sistema "MGtk Master Widgets".

Details

mgtk_hbox_default_homogeneous

extern mboolean mgtk_hbox_default_homogeneous;

Utilizzata nel passaggio di argomenti alle funzioni.

Viene impostata come HOMOGENEOUS_OFF

mgtk_hbox_default_spacing

extern mint mgtk_hbox_default_spacing;

Utilizzata nel passaggio di argomenti alle funzioni.

Viene impostata come SPACING_OFF

struct MGtkHBoxData

struct MGtkHBoxData {
            GtkHBox*        hbox;

            mboolean        homogeneous;

            mint            spacing;
};

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

GtkHBox *hbox;

 una GtkHBox 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 MGtkHBox

struct MGtkHBox {
        GtkWidget* const        hbox;
};

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

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

GtkWidget * const         hbox;

 indirizzo ad una struttura di tipo GtkHBox - only Read

MGTK_HBOX()

    #define MGTK_HBOX(data)     ds_CAST (MGtkHBox*,data)

stability: Unstable

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

data :

 struttura derivata

MGTK_HBOX_user()

    #define MGTK_HBOX_user(data)     ds_GET_PROPERTY(MGTK_HBOX(data),user)

stability: Unstable

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

data :

 una struttura derivata

MGTK_HBOX_hbox()

    #define MGTK_HBOX_hbox(data)     ds_GET_PROPERTY(MGTK_HBOX(data),hbox)

stability: Unstable

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

data :

 una struttura derivata

MGTK_GET_M_HBOX()

#define             MGTK_GET_M_HBOX(master,hbox_collection,mhbox_id)

stability: Unstable

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

Questa macro è utilizzata prevalentemente dal sistema.

master :

 un archivio "master" di tipo MICollections

hbox_collection :

 identificativo della collezione di MGtkHBox archiviata

mhbox_id :

 identificativo dell'elemento di tipo MGtkHBox archiviato

MGTK_GET_HBOX()

#define             MGTK_GET_HBOX(master,hbox_collection,mhbox_id)

stability: Unstable

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

Questa macro è utilizzata prevalentemente dal sistema.

master :

 un archivio "master" di tipo MICollections

hbox_collection :

 identificativo della collezione di MGtkHBox archiviata

mhbox_id :

 identificativo dell'elemento di tipo MGtkHBox archiviato

MGTK_HBOX_S_()

#define             MGTK_HBOX_S_(master,mhbox_id)

stability: Unstable

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

master :

 un archivio "master" di tipo MICollections

mhbox_id :

 identificativo dell'elemento di tipo MGtkHBox archiviato

MGTK_M_HBOX_S_()

#define             MGTK_M_HBOX_S_(master,mhbox_id)

stability: Unstable

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

master :

 un archivio "master" di tipo MICollections

mhbox_id :

 identificativo dell'elemento di tipo MGtkHBox archiviato

MGTK_HBOX_()

#define             MGTK_HBOX_(mhbox_id)

stability: Unstable

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

mhbox_id :

 identificativo dell'elemento di tipo MGtkHBox archiviato

MGTK_M_HBOX_()

#define             MGTK_M_HBOX_(mhbox_id)

stability: Unstable

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

mhbox_id :

 identificativo dell'elemento di tipo MGtkHBox archiviato

MGTK_HBOX_SUBMASTER()

#define             MGTK_HBOX_SUBMASTER(master)

stability: Unstable

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

master :

 indirizzo ad una struttura derivata allocata di tipo MICollection

Returns :

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

MGTK_HBOX_ARCHIVE_ID()

#define             MGTK_HBOX_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 MGtkHBox

label :

 una stringa univoca che identifica l'identificativo id

Returns :

 un identificativo valido o MERROR in caso di errore

MGTK_HBOX_ARCHIVE_ID_SELECT()

#define             MGTK_HBOX_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 MGtkHBox

label :

 una stringa univoca che identifica l'identificativo id

Returns :

 un identificativo valido o MERROR in caso di errore

mgtk_hbox_new ()

MGtkHBox *          mgtk_hbox_new                       (mboolean homogeneous,
                                                         mint spacing);

stability: Unstable

Crea una nuova MGtkHBox.

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 MGtkHBox o NULL in caso di errore.

Since 0.0.1

mgtk_hbox_new_attach ()

MGtkHBox *          mgtk_hbox_new_attach                (GtkHBox *hbox);

stability: Unstable

Crea una nuova MGtkHBox. Non viene creata una nuova GtkHBox come nella funzione mgtk_hbox_new() ma viene inserita quella passata come argomento hbox.

hbox :

 una GtkHBox allocata e inizializzata

Returns :

 una nuova MGtkHBox o NULL in caso di errore.

Since 0.0.1

mgtk_hbox_free ()

MStatus             mgtk_hbox_free                      (MGtkHBox *mhbox);

stability: Unstable

Libera la memoria allocata per una MGtkHBox.

mhbox :

 indirizzo ad una struttura derivata allocata di tipo MGtkHBox

Returns :

 MCORRECT o MERROR in caso di errore.

Since 0.0.1

mgtk_hbox_collection ()

MId                 mgtk_hbox_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 MGtkHBox.

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_hbox_collection() l'indirizzo master, viene ritornato l'identificativo alla relativa struttura derivata di tipo MICollectionQuark già archiviata.

Since 0.0.1

mgtk_hbox_insert_select ()

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

stability: Unstable

Crea una nuova MGtkHBox 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 MGtkHBox o MERROR in caso di errore.

Since 0.0.1

mgtk_hbox_insert ()

MId                 mgtk_hbox_insert                    (mboolean homogeneous,
                                                         mint spacing);

stability: Unstable

Crea una nuova MGtkHBox 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 MGtkHBox o MERROR in caso di errore.

Since 0.0.1

mgtk_hbox_insert_select_attach ()

MId                 mgtk_hbox_insert_select_attach      (MICollections *master,
                                                         GtkHBox *hbox);

stability: Unstable

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

Non viene creata una nuova GtkHBox come nella funzione mgtk_hbox_insert_select() ma viene inserita quella passata come argomento hbox.

master :

 indirizzo ad una struttura derivata allocata di tipo MICollection

hbox :

 una GtkHBox allocata e inizializzata

Returns :

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

Since 0.0.1

mgtk_hbox_insert_attach ()

MId                 mgtk_hbox_insert_attach             (GtkHBox *hbox);

stability: Unstable

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

Non viene creata una nuova GtkHBox come nella funzione mgtk_hbox_insert() ma viene inserita quella passata come argomento hbox.

hbox :

 una GtkHBox allocata e inizializzata

Returns :

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

Since 0.0.1

Generated by GTK-Doc V1.14