MGtk Label

MGtk Label — Strumenti per l'archiviazione di strutture GtkLabel.

Stability Level

Unstable, unless otherwise indicated

Synopsis

#include <mgtk.h>

struct              MGtkLabelData;
struct              MGtkLabel;
#define             MGTK_LABEL                          (data)
#define             MGTK_LABEL_user                     (data)
#define             MGTK_LABEL_label                    (data)
#define             MGTK_GET_M_LABEL                    (master,
                                                         label_collection,
                                                         mlabel_id)
#define             MGTK_GET_LABEL                      (master,
                                                         label_collection,
                                                         mlabel_id)
#define             MGTK_LABEL_S_                       (master,
                                                         mlabel_id)
#define             MGTK_M_LABEL_S_                     (master,
                                                         mlabel_id)
#define             MGTK_LABEL_                         (mlabel_id)
#define             MGTK_M_LABEL_                       (mlabel_id)
#define             MGTK_LABEL_SUBMASTER                (master)
#define             MGTK_LABEL_ARCHIVE_ID               (idarchive,
                                                         id,
                                                         label)
#define             MGTK_LABEL_ARCHIVE_ID_SELECT        (idarchive,
                                                         master,
                                                         id,
                                                         label)
MGtkLabel *         mgtk_label_new                      (const mchar *str);
MGtkLabel *         mgtk_label_new_attach               (GtkLabel *label);
MStatus             mgtk_label_free                     (MGtkLabel *mlabel);
MId                 mgtk_label_collection               (MICollections *master);
MId                 mgtk_label_insert_select            (MICollections *master,
                                                         const mchar *str);
MId                 mgtk_label_insert                   (const mchar *str);
MId                 mgtk_label_insert_select_attach     (MICollections *master,
                                                         GtkLabel *label);
MId                 mgtk_label_insert_attach            (GtkLabel *label);

Description

Attraverso la struttura MGtkLabel è possibile archiviare strutture GtkLabel attraverso il sistema "MGtk Master Widgets".

Details

struct MGtkLabelData

struct MGtkLabelData {
            GtkLabel*           label;

            const mchar*        str;
};

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

GtkLabel *label;

 una GtkLabel allocata e inizializzata

const mchar *str;

 The text of the label.

struct MGtkLabel

struct MGtkLabel {
        GtkWidget* const        label;
};

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

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

GtkWidget * const         label;

 indirizzo ad una struttura di tipo GtkLabel - only Read

MGTK_LABEL()

    #define MGTK_LABEL(data)     ds_CAST (MGtkLabel*,data)

stability: Unstable

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

data :

 struttura derivata

MGTK_LABEL_user()

    #define MGTK_LABEL_user(data)     ds_GET_PROPERTY(MGTK_LABEL(data),user)

stability: Unstable

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

data :

 una struttura derivata

MGTK_LABEL_label()

    #define MGTK_LABEL_label(data)     ds_GET_PROPERTY(MGTK_LABEL(data),label)

stability: Unstable

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

data :

 una struttura derivata

MGTK_GET_M_LABEL()

#define             MGTK_GET_M_LABEL(master,label_collection,mlabel_id)

stability: Unstable

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

Questa macro è utilizzata prevalentemente dal sistema.

master :

 un archivio "master" di tipo MICollections

label_collection :

 identificativo della collezione di MGtkLabel archiviata

mlabel_id :

 identificativo dell'elemento di tipo MGtkLabel archiviato

MGTK_GET_LABEL()

#define             MGTK_GET_LABEL(master,label_collection,mlabel_id)

stability: Unstable

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

Questa macro è utilizzata prevalentemente dal sistema.

master :

 un archivio "master" di tipo MICollections

label_collection :

 identificativo della collezione di MGtkLabel archiviata

mlabel_id :

 identificativo dell'elemento di tipo MGtkLabel archiviato

MGTK_LABEL_S_()

#define             MGTK_LABEL_S_(master,mlabel_id)

stability: Unstable

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

master :

 un archivio "master" di tipo MICollections

mlabel_id :

 identificativo dell'elemento di tipo MGtkLabel archiviato

MGTK_M_LABEL_S_()

#define             MGTK_M_LABEL_S_(master,mlabel_id)

stability: Unstable

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

master :

 un archivio "master" di tipo MICollections

mlabel_id :

 identificativo dell'elemento di tipo MGtkLabel archiviato

MGTK_LABEL_()

#define             MGTK_LABEL_(mlabel_id)

stability: Unstable

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

mlabel_id :

 identificativo dell'elemento di tipo MGtkLabel archiviato

MGTK_M_LABEL_()

#define             MGTK_M_LABEL_(mlabel_id)

stability: Unstable

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

mlabel_id :

 identificativo dell'elemento di tipo MGtkLabel archiviato

MGTK_LABEL_SUBMASTER()

#define             MGTK_LABEL_SUBMASTER(master)

stability: Unstable

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

master :

 indirizzo ad una struttura derivata allocata di tipo MICollection

Returns :

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

MGTK_LABEL_ARCHIVE_ID()

#define             MGTK_LABEL_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 MGtkLabel

label :

 una stringa univoca che identifica l'identificativo id

Returns :

 un identificativo valido o MERROR in caso di errore

MGTK_LABEL_ARCHIVE_ID_SELECT()

#define             MGTK_LABEL_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 MGtkLabel

label :

 una stringa univoca che identifica l'identificativo id

Returns :

 un identificativo valido o MERROR in caso di errore

mgtk_label_new ()

MGtkLabel *         mgtk_label_new                      (const mchar *str);

stability: Unstable

Crea una nuova MGtkLabel.

str :

 The text of the label.

Returns :

 una nuova MGtkLabel o NULL in caso di errore.

Since 0.0.1

mgtk_label_new_attach ()

MGtkLabel *         mgtk_label_new_attach               (GtkLabel *label);

stability: Unstable

Crea una nuova MGtkLabel. Non viene creata una nuova GtkLabel come nella funzione mgtk_label_new() ma viene inserita quella passata come argomento label.

label :

 una GtkLabel allocata e inizializzata

Returns :

 una nuova MGtkLabel o NULL in caso di errore.

Since 0.0.1

mgtk_label_free ()

MStatus             mgtk_label_free                     (MGtkLabel *mlabel);

stability: Unstable

Libera la memoria allocata per una MGtkLabel.

mlabel :

 indirizzo ad una struttura derivata allocata di tipo MGtkLabel

Returns :

 MCORRECT o MERROR in caso di errore.

Since 0.0.1

mgtk_label_collection ()

MId                 mgtk_label_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 MGtkLabel.

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

Since 0.0.1

mgtk_label_insert_select ()

MId                 mgtk_label_insert_select            (MICollections *master,
                                                         const mchar *str);

stability: Unstable

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

master :

 indirizzo ad una struttura derivata allocata di tipo MICollection

str :

 The text of the label.

Returns :

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

Since 0.0.1

mgtk_label_insert ()

MId                 mgtk_label_insert                   (const mchar *str);

stability: Unstable

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

str :

 The text of the label.

Returns :

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

Since 0.0.1

mgtk_label_insert_select_attach ()

MId                 mgtk_label_insert_select_attach     (MICollections *master,
                                                         GtkLabel *label);

stability: Unstable

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

Non viene creata una nuova GtkLabel come nella funzione mgtk_label_insert_select() ma viene inserita quella passata come argomento label.

master :

 indirizzo ad una struttura derivata allocata di tipo MICollection

label :

 una GtkLabel allocata e inizializzata

Returns :

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

Since 0.0.1

mgtk_label_insert_attach ()

MId                 mgtk_label_insert_attach            (GtkLabel *label);

stability: Unstable

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

Non viene creata una nuova GtkLabel come nella funzione mgtk_label_insert() ma viene inserita quella passata come argomento label.

label :

 una GtkLabel allocata e inizializzata

Returns :

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

Since 0.0.1

Generated by GTK-Doc V1.14