MGtk Image

MGtk Image — Strumenti per l'archiviazione di strutture GtkImage.

Stability Level

Unstable, unless otherwise indicated

Synopsis

#include <mgtk.h>

extern              mchars mgtk_image_default_filename;
struct              MGtkImageData;
struct              MGtkImage;
#define             MGTK_IMAGE                          (data)
#define             MGTK_IMAGE_user                     (data)
#define             MGTK_GET_IMAGE                      (master,
                                                         image_collection,
                                                         image_id)
#define             MGTK_IMAGE_S_                       (master,
                                                         image_id)
#define             MGTK_IMAGE_                         (image_id)
#define             MGTK_IMAGE_SUBMASTER                (master)
#define             MGTK_IMAGE_ARCHIVE_ID               (idarchive,
                                                         id,
                                                         label)
#define             MGTK_IMAGE_ARCHIVE_ID_SELECT        (idarchive,
                                                         master,
                                                         id,
                                                         label)
MGtkImage *         mgtk_image_new                      (const mchar *filename);
MGtkImage *         mgtk_image_new_attach               (GtkImage *image);
MStatus             mgtk_image_free                     (MGtkImage *mimage);
MId                 mgtk_image_collection               (MICollections *master);
MId                 mgtk_image_insert_select            (MICollections *master,
                                                         const mchar *filename);
MId                 mgtk_image_insert                   (const mchar *filename);
MId                 mgtk_image_insert_select_attach     (MICollections *master,
                                                         GtkImage *image);
MId                 mgtk_image_insert_attach            (GtkImage *image);

Description

Attraverso la struttura MGtkImage è possibile archiviare strutture GtkImage attraverso il sistema "MGtk Master Widgets".

Details

mgtk_image_default_filename

extern mchars mgtk_image_default_filename;

Utilizzata nel passaggio di argomenti alle funzioni.

Viene impostata come NULL

struct MGtkImageData

struct MGtkImageData {
            GtkImage*           image;

            const mchar*        filename;
};

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

GtkImage *`image`;	una GtkImage allocata e inizializzata
const mchar *`filename`;	a filename.

struct MGtkImage

struct MGtkImage {
        GtkWidget* const        image;
};

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

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

GtkWidget * const image;

indirizzo ad una struttura di tipo GtkImage - only Read

MGTK_IMAGE()

    #define MGTK_IMAGE(data)     ds_CAST (MGtkImage*,data)

stability: Unstable

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

data :

struttura derivata

MGTK_IMAGE_user()

    #define MGTK_IMAGE_user(data)     ds_GET_PROPERTY(MGTK_IMAGE(data),user)

stability: Unstable

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

data :

una struttura derivata

MGTK_GET_IMAGE()

#define             MGTK_GET_IMAGE(master,image_collection,image_id)

stability: Unstable

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

Questa macro è utilizzata prevalentemente dal sistema.

`master` :	un archivio "master" di tipo MICollections
`image_collection` :	identificativo della collezione di MGtkImage archiviata
`image_id` :	identificativo dell'elemento di tipo MGtkImage archiviato

MGTK_IMAGE_S_()

#define             MGTK_IMAGE_S_(master,image_id)

stability: Unstable

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

`master` :	un archivio "master" di tipo MICollections
`image_id` :	identificativo dell'elemento di tipo MGtkImage archiviato

MGTK_IMAGE_()

#define             MGTK_IMAGE_(image_id)

stability: Unstable

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

image_id :

identificativo dell'elemento di tipo MGtkImage archiviato

MGTK_IMAGE_SUBMASTER()

#define             MGTK_IMAGE_SUBMASTER(master)

stability: Unstable

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

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

MGTK_IMAGE_ARCHIVE_ID()

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

MGTK_IMAGE_ARCHIVE_ID_SELECT()

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

mgtk_image_new ()

MGtkImage *         mgtk_image_new                      (const mchar *filename);

stability: Unstable

Crea una nuova MGtkImage.

`filename` :	a filename.
Returns :	una nuova MGtkImage o `NULL` in caso di errore.

Since 0.0.1

mgtk_image_new_attach ()

MGtkImage *         mgtk_image_new_attach               (GtkImage *image);

stability: Unstable

Crea una nuova MGtkImage. Non viene creata una nuova GtkImage come nella funzione mgtk_image_new() ma viene inserita quella passata come argomento image.

`image` :	una GtkImage allocata e inizializzata
Returns :	una nuova MGtkImage o `NULL` in caso di errore.

Since 0.0.1

mgtk_image_free ()

MStatus             mgtk_image_free                     (MGtkImage *mimage);

stability: Unstable

Libera la memoria allocata per una MGtkImage.

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

Since 0.0.1

mgtk_image_collection ()

MId                 mgtk_image_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 MGtkImage.

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

Since 0.0.1

mgtk_image_insert_select ()

MId                 mgtk_image_insert_select            (MICollections *master,
                                                         const mchar *filename);

stability: Unstable

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

`master` :	indirizzo ad una struttura derivata allocata di tipo MICollection
`filename` :	a filename.
Returns :	l'identificativo ad una nuova MGtkImage o `MERROR` in caso di errore.

Since 0.0.1

mgtk_image_insert ()

MId                 mgtk_image_insert                   (const mchar *filename);

stability: Unstable

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

`filename` :	a filename.
Returns :	l'identificativo ad una nuova MGtkImage o `MERROR` in caso di errore.

Since 0.0.1

mgtk_image_insert_select_attach ()

MId                 mgtk_image_insert_select_attach     (MICollections *master,
                                                         GtkImage *image);

stability: Unstable

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

Non viene creata una nuova GtkImage come nella funzione mgtk_image_insert_select() ma viene inserita quella passata come argomento image.

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

Since 0.0.1

mgtk_image_insert_attach ()

MId                 mgtk_image_insert_attach            (GtkImage *image);

stability: Unstable

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

Non viene creata una nuova GtkImage come nella funzione mgtk_image_insert() ma viene inserita quella passata come argomento image.

`image` :	una GtkImage allocata e inizializzata
Returns :	l'identificativo ad una nuova MGtkImage o `MERROR` in caso di errore.

Since 0.0.1

			MGtk Reference Manual
Top \| Description