MGtk Window

MGtk Window — Strumenti per l'archiviazione di strutture GtkWindow.

Stability Level

Unstable, unless otherwise indicated

Synopsis

#include <mgtk.h>

extern              GtkWindowType mgtk_window_default_type;
struct              MGtkWindowData;
struct              MGtkWindow;
#define             MGTK_WINDOW                         (data)
#define             MGTK_WINDOW_user                    (data)
#define             MGTK_WINDOW_window                  (data)
#define             MGTK_GET_M_WINDOW                   (master,
                                                         window_collection,
                                                         mwindow_id)
#define             MGTK_GET_WINDOW                     (master,
                                                         window_collection,
                                                         mwindow_id)
#define             MGTK_WINDOW_S_                      (master,
                                                         mwindow_id)
#define             MGTK_M_WINDOW_S_                    (master,
                                                         mwindow_id)
#define             MGTK_WINDOW_                        (mwindow_id)
#define             MGTK_M_WINDOW_                      (mwindow_id)
#define             MGTK_WINDOW_SUBMASTER               (master)
#define             MGTK_WINDOW_ARCHIVE_ID              (idarchive,
                                                         id,
                                                         label)
#define             MGTK_WINDOW_ARCHIVE_ID_SELECT       (idarchive,
                                                         master,
                                                         id,
                                                         label)
MGtkWindow *        mgtk_window_new                     (GtkWindowType type,
                                                         const mchar *title);
MGtkWindow *        mgtk_window_new_attach              (GtkWindow *window);
MStatus             mgtk_window_free                    (MGtkWindow *mwindow);
MId                 mgtk_window_collection              (MICollections *master);
MId                 mgtk_window_insert_select           (MICollections *master,
                                                         GtkWindowType type,
                                                         const mchar *title);
MId                 mgtk_window_insert                  (GtkWindowType type,
                                                         const mchar *title);
MId                 mgtk_window_insert_select_attach    (MICollections *master,
                                                         GtkWindow *window);
MId                 mgtk_window_insert_attach           (GtkWindow *window);

Description

Attraverso la struttura MGtkWindow è possibile archiviare strutture GtkWindow attraverso il sistema "MGtk Master Widgets".

Details

mgtk_window_default_type

extern GtkWindowType mgtk_window_default_type;

Utilizzata nel passaggio di argomenti alle funzioni.

Viene impostata come GTK_WINDOW_POPUP

struct MGtkWindowData

struct MGtkWindowData {
            GtkWindow*          window;

            GtkWindowType       type;

            const mchar*        title;
};

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

GtkWindow *window;

 una GtkWindow allocata e inizializzata

GtkWindowType type;

 type of window

const mchar *title;

 title of the window

struct MGtkWindow

struct MGtkWindow {
        GtkWidget* const        window;
};

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

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

GtkWidget * const         window;

 indirizzo ad una struttura di tipo GtkWindow - only Read

MGTK_WINDOW()

    #define MGTK_WINDOW(data)     ds_CAST (MGtkWindow*,data)

stability: Unstable

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

data :

 struttura derivata

MGTK_WINDOW_user()

    #define MGTK_WINDOW_user(data)     ds_GET_PROPERTY(MGTK_WINDOW(data),user)

stability: Unstable

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

data :

 una struttura derivata

MGTK_WINDOW_window()

    #define MGTK_WINDOW_window(data)     ds_GET_PROPERTY(MGTK_WINDOW(data),window)

stability: Unstable

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

data :

 una struttura derivata

MGTK_GET_M_WINDOW()

#define             MGTK_GET_M_WINDOW(master,window_collection,mwindow_id)

stability: Unstable

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

Questa macro è utilizzata prevalentemente dal sistema.

master :

 un archivio "master" di tipo MICollections

window_collection :

 identificativo della collezione di MGtkWindow archiviata

mwindow_id :

 identificativo dell'elemento di tipo MGtkWindow archiviato

MGTK_GET_WINDOW()

#define             MGTK_GET_WINDOW(master,window_collection,mwindow_id)

stability: Unstable

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

Questa macro è utilizzata prevalentemente dal sistema.

master :

 un archivio "master" di tipo MICollections

window_collection :

 identificativo della collezione di MGtkWindow archiviata

mwindow_id :

 identificativo dell'elemento di tipo MGtkWindow archiviato

MGTK_WINDOW_S_()

#define             MGTK_WINDOW_S_(master,mwindow_id)

stability: Unstable

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

master :

 un archivio "master" di tipo MICollections

mwindow_id :

 identificativo dell'elemento di tipo MGtkWindow archiviato

MGTK_M_WINDOW_S_()

#define             MGTK_M_WINDOW_S_(master,mwindow_id)

stability: Unstable

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

master :

 un archivio "master" di tipo MICollections

mwindow_id :

 identificativo dell'elemento di tipo MGtkWindow archiviato

MGTK_WINDOW_()

#define             MGTK_WINDOW_(mwindow_id)

stability: Unstable

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

mwindow_id :

 identificativo dell'elemento di tipo MGtkWindow archiviato

MGTK_M_WINDOW_()

#define             MGTK_M_WINDOW_(mwindow_id)

stability: Unstable

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

mwindow_id :

 identificativo dell'elemento di tipo MGtkWindow archiviato

MGTK_WINDOW_SUBMASTER()

#define             MGTK_WINDOW_SUBMASTER(master)

stability: Unstable

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

master :

 indirizzo ad una struttura derivata allocata di tipo MICollection

Returns :

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

MGTK_WINDOW_ARCHIVE_ID()

#define             MGTK_WINDOW_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 MGtkWindow

label :

 una stringa univoca che identifica l'identificativo id

Returns :

 un identificativo valido o MERROR in caso di errore

MGTK_WINDOW_ARCHIVE_ID_SELECT()

#define             MGTK_WINDOW_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 MGtkWindow

label :

 una stringa univoca che identifica l'identificativo id

Returns :

 un identificativo valido o MERROR in caso di errore

mgtk_window_new ()

MGtkWindow *        mgtk_window_new                     (GtkWindowType type,
                                                         const mchar *title);

stability: Unstable

Crea una nuova MGtkWindow.

type :

 type of window

title :

 title of the window

Returns :

 una nuova MGtkWindow o NULL in caso di errore.

Since 0.0.1

mgtk_window_new_attach ()

MGtkWindow *        mgtk_window_new_attach              (GtkWindow *window);

stability: Unstable

Crea una nuova MGtkWindow. Non viene creata una nuova GtkWindow come nella funzione mgtk_window_new() ma viene inserita quella passata come argomento window.

window :

 una GtkWindow allocata e inizializzata

Returns :

 una nuova MGtkWindow o NULL in caso di errore.

Since 0.0.1

mgtk_window_free ()

MStatus             mgtk_window_free                    (MGtkWindow *mwindow);

stability: Unstable

Libera la memoria allocata per una MGtkWindow.

mwindow :

 indirizzo ad una struttura derivata allocata di tipo MGtkWindow

Returns :

 MCORRECT o MERROR in caso di errore.

Since 0.0.1

mgtk_window_collection ()

MId                 mgtk_window_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 MGtkWindow.

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

Since 0.0.1

mgtk_window_insert_select ()

MId                 mgtk_window_insert_select           (MICollections *master,
                                                         GtkWindowType type,
                                                         const mchar *title);

stability: Unstable

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

master :

 indirizzo ad una struttura derivata allocata di tipo MICollection

type :

 type of window

title :

 title of the window

Returns :

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

Since 0.0.1

mgtk_window_insert ()

MId                 mgtk_window_insert                  (GtkWindowType type,
                                                         const mchar *title);

stability: Unstable

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

type :

 type of window

title :

 title of the window

Returns :

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

Since 0.0.1

mgtk_window_insert_select_attach ()

MId                 mgtk_window_insert_select_attach    (MICollections *master,
                                                         GtkWindow *window);

stability: Unstable

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

Non viene creata una nuova GtkWindow come nella funzione mgtk_window_insert_select() ma viene inserita quella passata come argomento window.

master :

 indirizzo ad una struttura derivata allocata di tipo MICollection

window :

 una GtkWindow allocata e inizializzata

Returns :

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

Since 0.0.1

mgtk_window_insert_attach ()

MId                 mgtk_window_insert_attach           (GtkWindow *window);

stability: Unstable

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

Non viene creata una nuova GtkWindow come nella funzione mgtk_window_insert() ma viene inserita quella passata come argomento window.

window :

 una GtkWindow allocata e inizializzata

Returns :

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

Since 0.0.1

Generated by GTK-Doc V1.14