MGtk Button

MGtk Button — Strumenti per l'archiviazione di strutture GtkButton.

Stability Level

Unstable, unless otherwise indicated

Synopsis

#include <mgtk.h>

extern              mchars mgtk_button_default_label;
struct              MGtkButtonData;
struct              MGtkButton;
#define             MGTK_BUTTON                         (data)
#define             MGTK_BUTTON_user                    (data)
#define             MGTK_BUTTON_button                  (data)
#define             MGTK_GET_M_BUTTON                   (master,
                                                         button_collection,
                                                         mbutton_id)
#define             MGTK_GET_BUTTON                     (master,
                                                         button_collection,
                                                         mbutton_id)
#define             MGTK_BUTTON_S_                      (master,
                                                         mbutton_id)
#define             MGTK_M_BUTTON_S_                    (master,
                                                         mbutton_id)
#define             MGTK_BUTTON_                        (mbutton_id)
#define             MGTK_M_BUTTON_                      (mbutton_id)
#define             MGTK_BUTTON_SUBMASTER               (master)
#define             MGTK_BUTTON_ARCHIVE_ID              (idarchive,
                                                         id,
                                                         label)
#define             MGTK_BUTTON_ARCHIVE_ID_SELECT       (idarchive,
                                                         master,
                                                         id,
                                                         label)
MGtkButton *        mgtk_button_new                     (const mchar *label);
MGtkButton *        mgtk_button_new_attach              (GtkButton *button);
MStatus             mgtk_button_free                    (MGtkButton *mbutton);
MId                 mgtk_button_collection              (MICollections *master);
MId                 mgtk_button_insert_select           (MICollections *master,
                                                         const mchar *label);
MId                 mgtk_button_insert                  (const mchar *label);
MId                 mgtk_button_insert_select_attach    (MICollections *master,
                                                         GtkButton *button);
MId                 mgtk_button_insert_attach           (GtkButton *button);

Description

Attraverso la struttura MGtkButton è possibile archiviare strutture GtkButton attraverso il sistema "MGtk Master Widgets".

Details

mgtk_button_default_label

extern mchars mgtk_button_default_label;

Utilizzata nel passaggio di argomenti alle funzioni.

Viene impostata come NULL

struct MGtkButtonData

struct MGtkButtonData {
            GtkButton*          button;

            const mchar*        label;
};

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

GtkButton *`button`;	una GtkButton allocata e inizializzata
const mchar *`label`;	The text you want the GtkLabel to hold.

struct MGtkButton

struct MGtkButton {
        GtkWidget* const        button;
};

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

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

GtkWidget * const button;

indirizzo ad una struttura di tipo GtkButton - only Read

MGTK_BUTTON()

    #define MGTK_BUTTON(data)     ds_CAST (MGtkButton*,data)

stability: Unstable

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

data :

struttura derivata

MGTK_BUTTON_user()

    #define MGTK_BUTTON_user(data)     ds_GET_PROPERTY(MGTK_BUTTON(data),user)

stability: Unstable

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

data :

una struttura derivata

MGTK_BUTTON_button()

    #define MGTK_BUTTON_button(data)     ds_GET_PROPERTY(MGTK_BUTTON(data),button)

stability: Unstable

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

data :

una struttura derivata

MGTK_GET_M_BUTTON()

#define             MGTK_GET_M_BUTTON(master,button_collection,mbutton_id)

stability: Unstable

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

Questa macro è utilizzata prevalentemente dal sistema.

`master` :	un archivio "master" di tipo MICollections
`button_collection` :	identificativo della collezione di MGtkButton archiviata
`mbutton_id` :	identificativo dell'elemento di tipo MGtkButton archiviato

MGTK_GET_BUTTON()

#define             MGTK_GET_BUTTON(master,button_collection,mbutton_id)

stability: Unstable

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

Questa macro è utilizzata prevalentemente dal sistema.

`master` :	un archivio "master" di tipo MICollections
`button_collection` :	identificativo della collezione di MGtkButton archiviata
`mbutton_id` :	identificativo dell'elemento di tipo MGtkButton archiviato

MGTK_BUTTON_S_()

#define             MGTK_BUTTON_S_(master,mbutton_id)

stability: Unstable

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

`master` :	un archivio "master" di tipo MICollections
`mbutton_id` :	identificativo dell'elemento di tipo MGtkButton archiviato

MGTK_M_BUTTON_S_()

#define             MGTK_M_BUTTON_S_(master,mbutton_id)

stability: Unstable

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

`master` :	un archivio "master" di tipo MICollections
`mbutton_id` :	identificativo dell'elemento di tipo MGtkButton archiviato

MGTK_BUTTON_()

#define             MGTK_BUTTON_(mbutton_id)

stability: Unstable

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

mbutton_id :

identificativo dell'elemento di tipo MGtkButton archiviato

MGTK_M_BUTTON_()

#define             MGTK_M_BUTTON_(mbutton_id)

stability: Unstable

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

mbutton_id :

identificativo dell'elemento di tipo MGtkButton archiviato

MGTK_BUTTON_SUBMASTER()

#define             MGTK_BUTTON_SUBMASTER(master)

stability: Unstable

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

`master` :	indirizzo ad una struttura derivata allocata di tipo MICollection
Returns :	una struttura derivata di tipo MICollectionQuark o `NULL` in caso di errore

MGTK_BUTTON_ARCHIVE_ID()

#define             MGTK_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 MGtkButton
`label` :	una stringa univoca che identifica l'identificativo `id`
Returns :	un identificativo valido o `MERROR` in caso di errore

MGTK_BUTTON_ARCHIVE_ID_SELECT()

#define             MGTK_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 MGtkButton
`label` :	una stringa univoca che identifica l'identificativo `id`
Returns :	un identificativo valido o `MERROR` in caso di errore

mgtk_button_new ()

MGtkButton *        mgtk_button_new                     (const mchar *label);

stability: Unstable

Crea una nuova MGtkButton.

`label` :	The text you want the GtkLabel to hold.
Returns :	una nuova MGtkButton o `NULL` in caso di errore.

Since 0.0.1

mgtk_button_new_attach ()

MGtkButton *        mgtk_button_new_attach              (GtkButton *button);

stability: Unstable

Crea una nuova MGtkButton. Non viene creata una nuova GtkButton come nella funzione mgtk_button_new() ma viene inserita quella passata come argomento button.

`button` :	una GtkButton allocata e inizializzata
Returns :	una nuova MGtkButton o `NULL` in caso di errore.

Since 0.0.1

mgtk_button_free ()

MStatus             mgtk_button_free                    (MGtkButton *mbutton);

stability: Unstable

Libera la memoria allocata per una MGtkButton.

`mbutton` :	indirizzo ad una struttura derivata allocata di tipo MGtkButton
Returns :	`MCORRECT` o `MERROR` in caso di errore.

Since 0.0.1

mgtk_button_collection ()

MId                 mgtk_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 MGtkButton.

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

Since 0.0.1

mgtk_button_insert_select ()

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

stability: Unstable

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

`master` :	indirizzo ad una struttura derivata allocata di tipo MICollection
`label` :	The text you want the GtkLabel to hold.
Returns :	l'identificativo ad una nuova MGtkButton o `MERROR` in caso di errore.

Since 0.0.1

mgtk_button_insert ()

MId                 mgtk_button_insert                  (const mchar *label);

stability: Unstable

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

`label` :	The text you want the GtkLabel to hold.
Returns :	l'identificativo ad una nuova MGtkButton o `MERROR` in caso di errore.

Since 0.0.1

mgtk_button_insert_select_attach ()

MId                 mgtk_button_insert_select_attach    (MICollections *master,
                                                         GtkButton *button);

stability: Unstable

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

Non viene creata una nuova GtkButton come nella funzione mgtk_button_insert_select() ma viene inserita quella passata come argomento button.

`master` :	indirizzo ad una struttura derivata allocata di tipo MICollection
`button` :	una GtkButton allocata e inizializzata
Returns :	l'identificativo ad una nuova MGtkButton o `MERROR` in caso di errore.

Since 0.0.1

mgtk_button_insert_attach ()

MId                 mgtk_button_insert_attach           (GtkButton *button);

stability: Unstable

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

Non viene creata una nuova GtkButton come nella funzione mgtk_button_insert() ma viene inserita quella passata come argomento button.

`button` :	una GtkButton allocata e inizializzata
Returns :	l'identificativo ad una nuova MGtkButton o `MERROR` in caso di errore.

Since 0.0.1

			MGtk Reference Manual
Top \| Description