MGtk Toggle Button

MGtk Toggle Button — Strumenti per l'archiviazione di strutture GtkToggleButton.

Stability Level

Unstable, unless otherwise indicated

Synopsis

#include <mgtk.h>

extern              mchars mgtk_toggle_button_default_label;
struct              MGtkToggleButtonData;
struct              MGtkToggleButton;
#define             MGTK_TOGGLE_BUTTON                  (data)
#define             MGTK_TOGGLE_BUTTON_user             (data)
#define             MGTK_TOGGLE_BUTTON_tbutton          (data)
#define             MGTK_GET_M_TOGGLE_BUTTON            (master,
                                                         tbutton_collection,
                                                         mtbutton_id)
#define             MGTK_GET_TOGGLE_BUTTON              (master,
                                                         tbutton_collection,
                                                         mtbutton_id)
#define             MGTK_TOGGLE_BUTTON_S_               (master,
                                                         mtbutton_id)
#define             MGTK_M_TOGGLE_BUTTON_S_             (master,
                                                         mtbutton_id)
#define             MGTK_TOGGLE_BUTTON_                 (mtbutton_id)
#define             MGTK_M_TOGGLE_BUTTON_               (mtbutton_id)
#define             MGTK_TOGGLE_BUTTON_SUBMASTER        (master)
#define             MGTK_TOGGLE_BUTTON_ARCHIVE_ID       (idarchive,
                                                         id,
                                                         label)
#define             MGTK_TOGGLE_BUTTON_ARCHIVE_ID_SELECT(idarchive,
                                                         master,
                                                         id,
                                                         label)
MGtkToggleButton *  mgtk_toggle_button_new              (const mchar *label);
MGtkToggleButton *  mgtk_toggle_button_new_attach       (GtkToggleButton *tbutton);
MStatus             mgtk_toggle_button_free             (MGtkToggleButton *mtbutton);
MId                 mgtk_toggle_button_collection       (MICollections *master);
MId                 mgtk_toggle_button_insert_select    (MICollections *master,
                                                         const mchar *label);
MId                 mgtk_toggle_button_insert           (const mchar *label);
MId                 mgtk_toggle_button_insert_select_attach
                                                        (MICollections *master,
                                                         GtkToggleButton *tbutton);
MId                 mgtk_toggle_button_insert_attach    (GtkToggleButton *tbutton);

Description

Attraverso la struttura MGtkToggleButton è possibile archiviare strutture GtkToggleButton attraverso il sistema "MGtk Master Widgets".

Details

mgtk_toggle_button_default_label

extern mchars mgtk_toggle_button_default_label;

Utilizzata nel passaggio di argomenti alle funzioni.

Viene impostata come NULL

struct MGtkToggleButtonData

struct MGtkToggleButtonData {
            GtkToggleButton*    tbutton;

            const mchar*        label;
};

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

GtkToggleButton *tbutton;

 una GtkToggleButton allocata e inizializzata

const mchar *label;

 a string containing the message to be placed in the toggle button.

struct MGtkToggleButton

struct MGtkToggleButton {
        GtkWidget* const    tbutton;
};

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

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

GtkWidget * const     tbutton;

 indirizzo ad una struttura di tipo GtkToggleButton - only Read

MGTK_TOGGLE_BUTTON()

    #define MGTK_TOGGLE_BUTTON(data)     ds_CAST (MGtkToggleButton*,data)

stability: Unstable

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

data :

 struttura derivata

MGTK_TOGGLE_BUTTON_user()

    #define MGTK_TOGGLE_BUTTON_user(data)     ds_GET_PROPERTY(MGTK_TOGGLE_BUTTON(data),user)

stability: Unstable

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

data :

 una struttura derivata

MGTK_TOGGLE_BUTTON_tbutton()

    #define MGTK_TOGGLE_BUTTON_tbutton(data)     ds_GET_PROPERTY(MGTK_TOGGLE_BUTTON(data),tbutton)

stability: Unstable

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

data :

 una struttura derivata

MGTK_GET_M_TOGGLE_BUTTON()

#define             MGTK_GET_M_TOGGLE_BUTTON(master,tbutton_collection,mtbutton_id)

stability: Unstable

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

Questa macro è utilizzata prevalentemente dal sistema.

master :

 un archivio "master" di tipo MICollections

tbutton_collection :

 identificativo della collezione di MGtkToggleButton archiviata

mtbutton_id :

 identificativo dell'elemento di tipo MGtkToggleButton archiviato

MGTK_GET_TOGGLE_BUTTON()

#define             MGTK_GET_TOGGLE_BUTTON(master,tbutton_collection,mtbutton_id)

stability: Unstable

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

Questa macro è utilizzata prevalentemente dal sistema.

master :

 un archivio "master" di tipo MICollections

tbutton_collection :

 identificativo della collezione di MGtkToggleButton archiviata

mtbutton_id :

 identificativo dell'elemento di tipo MGtkToggleButton archiviato

MGTK_TOGGLE_BUTTON_S_()

#define             MGTK_TOGGLE_BUTTON_S_(master,mtbutton_id)

stability: Unstable

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

master :

 un archivio "master" di tipo MICollections

mtbutton_id :

 identificativo dell'elemento di tipo MGtkToggleButton archiviato

MGTK_M_TOGGLE_BUTTON_S_()

#define             MGTK_M_TOGGLE_BUTTON_S_(master,mtbutton_id)

stability: Unstable

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

master :

 un archivio "master" di tipo MICollections

mtbutton_id :

 identificativo dell'elemento di tipo MGtkToggleButton archiviato

MGTK_TOGGLE_BUTTON_()

#define             MGTK_TOGGLE_BUTTON_(mtbutton_id)

stability: Unstable

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

mtbutton_id :

 identificativo dell'elemento di tipo MGtkToggleButton archiviato

MGTK_M_TOGGLE_BUTTON_()

#define             MGTK_M_TOGGLE_BUTTON_(mtbutton_id)

stability: Unstable

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

mtbutton_id :

 identificativo dell'elemento di tipo MGtkToggleButton archiviato

MGTK_TOGGLE_BUTTON_SUBMASTER()

#define             MGTK_TOGGLE_BUTTON_SUBMASTER(master)

stability: Unstable

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

master :

 indirizzo ad una struttura derivata allocata di tipo MICollection

Returns :

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

MGTK_TOGGLE_BUTTON_ARCHIVE_ID()

#define             MGTK_TOGGLE_BUTTON_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 MGtkToggleButton

label :

 una stringa univoca che identifica l'identificativo id

Returns :

 un identificativo valido o MERROR in caso di errore

MGTK_TOGGLE_BUTTON_ARCHIVE_ID_SELECT()

#define             MGTK_TOGGLE_BUTTON_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 MGtkToggleButton

label :

 una stringa univoca che identifica l'identificativo id

Returns :

 un identificativo valido o MERROR in caso di errore

mgtk_toggle_button_new ()

MGtkToggleButton *  mgtk_toggle_button_new              (const mchar *label);

stability: Unstable

Crea una nuova MGtkToggleButton.

label :

 a string containing the message to be placed in the toggle button.

Returns :

 una nuova MGtkToggleButton o NULL in caso di errore.

Since 0.0.1

mgtk_toggle_button_new_attach ()

MGtkToggleButton *  mgtk_toggle_button_new_attach       (GtkToggleButton *tbutton);

stability: Unstable

Crea una nuova MGtkToggleButton. Non viene creata una nuova GtkToggleButton come nella funzione mgtk_toggle_button_new() ma viene inserita quella passata come argomento tbutton.

tbutton :

 una GtkToggleButton allocata e inizializzata

Returns :

 una nuova MGtkToggleButton o NULL in caso di errore.

Since 0.0.1

mgtk_toggle_button_free ()

MStatus             mgtk_toggle_button_free             (MGtkToggleButton *mtbutton);

stability: Unstable

Libera la memoria allocata per una MGtkToggleButton.

mtbutton :

 indirizzo ad una struttura derivata allocata di tipo MGtkToggleButton

Returns :

 MCORRECT o MERROR in caso di errore.

Since 0.0.1

mgtk_toggle_button_collection ()

MId                 mgtk_toggle_button_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 MGtkToggleButton.

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

Since 0.0.1

mgtk_toggle_button_insert_select ()

MId                 mgtk_toggle_button_insert_select    (MICollections *master,
                                                         const mchar *label);

stability: Unstable

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

master :

 indirizzo ad una struttura derivata allocata di tipo MICollection

label :

 a string containing the message to be placed in the toggle button.

Returns :

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

Since 0.0.1

mgtk_toggle_button_insert ()

MId                 mgtk_toggle_button_insert           (const mchar *label);

stability: Unstable

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

label :

 a string containing the message to be placed in the toggle button.

Returns :

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

Since 0.0.1

mgtk_toggle_button_insert_select_attach ()

MId                 mgtk_toggle_button_insert_select_attach
                                                        (MICollections *master,
                                                         GtkToggleButton *tbutton);

stability: Unstable

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

Non viene creata una nuova GtkToggleButton come nella funzione mgtk_toggle_button_insert_select() ma viene inserita quella passata come argomento tbutton.

master :

 indirizzo ad una struttura derivata allocata di tipo MICollection

tbutton :

 una GtkToggleButton allocata e inizializzata

Returns :

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

Since 0.0.1

mgtk_toggle_button_insert_attach ()

MId                 mgtk_toggle_button_insert_attach    (GtkToggleButton *tbutton);

stability: Unstable

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

Non viene creata una nuova GtkToggleButton come nella funzione mgtk_toggle_button_insert() ma viene inserita quella passata come argomento tbutton.

tbutton :

 una GtkToggleButton allocata e inizializzata

Returns :

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

Since 0.0.1

Generated by GTK-Doc V1.14