Come faccio? - parte VI

Capacità non sfruttate

Per interderci: implementare un completo supporto per il drag-and-drop (come in Smalled o con DragText) non è semplice, anzi, è molto difficile! Ma, implementare cose basilari come il salvataggio della posizione di una finestra con i suoi presentation parameters è molto semplice e non richiede poi molto lavoro. Questo è proprio ciò di cui discuteremo questo mese.

Molti termini citati sopra richiedono una spiegazione. Perciò prima di addentrarci nella programmazione vediamo cosa significano.

Presentation Parameters. Li adoro! I PP sono un modo fantastico di cambiare (e ricordare) le informazioni sui colori e i font di praticamente ogni parte della vostra applicazione. Chiunque usi OS/2 li conosce ma probabilmente non li riconoscerà sotto il nome di Presentation Parameters. I PP sono molto facili da applicare, basta usare le tavolozze colori e font nella cartella Impostazioni del sistema e trascinare un font o un colore sull'area che si vuole cambiare. Vedremo come salvare i PP tra un momento.

Profili. Questa è un'altra caratteristica di OS/2 che tutti usano, lo vogliano o no. Qualsiasi cosa facciate nel vostro sistema, come cambiare i colori, cambiare la posizione di finestre o icone, ecc, viene registrato. In questo modo OS/2 può ripristinare tutte le vostre impostazioni quando riavviate il sistema. OS/2 usa due profili, OS2.INI per le impostazioni utente (useremo anche queste) e OS2SYS.INI per le impostazioni di sistema.

Il profilo di OS/2 può essere confrontato con il file SYSTEM.INI di Windows. Ad ogni modo, la versione OS/2 del profilo è un database binario ed è molto superiore alla versione Windows.

A parte questi due profili, è anche possibile usare un profilo privato (tratteremo questo aspetto un'altra volta).

Ora, dopo questa introduzione piuttosto lunga, cosa faremo questo mese? Aggiungeremo una funzionalità al nostro programma esempio (ZIP, 14.5k) che salverà la posizione della finestra e tutti le informazioni sui colori e i font che vengono modificate tramite i PP. Poiché molti non gradiscono che i programmi mettano le mani sul loro OS2.INI, aggiungeremo anche un'opzione di menu per rimuovere queste informazioni dal file OS2.INI.

Cosa succede quando un programma viene chiuso?

Molti messaggi hanno un ruolo nella chiusura di una applicazione. Ovviamente c'è il messaggio WM_QUIT (ne abbiamo parlato in un articolo precedente). Questo messaggio non è molto conveniente da usare per azioni dell'ultimo minuto perché è questo messaggio che termina la coda messaggi per l'applicazione.

C'è anche il messaggio WM_CLOSE. Questo messaggio viene inviato dal PM quando l'utente seleziona la voce "Chiudi" dal menu sistema o fa doppio click sull'icona del menu sistema [o preme il pulsante di chiusura in Warp4 n.d.t.]. La "window procedure" di default (WinDefWindowProc) reagisce a questo messaggio inviando un WM_QUIT, quindi chiudendo l'applicazione. Però non possiamo assumere che WM_CLOSE venga inviato ogni volta che l'applicazione viene chiusa (un WM_QUIT può essere inviato da un'altra azione).

Così, cosa stiamo cercando? C'è un altro messaggio che viene inviato dal PM appena prima che l'applicazione si chiuda, è il messaggio WM_SAVEAPPLICATION (un nome adatto). Questo messagio è fatto apposta per salvare lo stato dell'applicazione e sicuramente è il messaggio che useremo nel nostro esempio.

Gli sviluppatori di OS/2 2.0 aggiunsero due funzioni che rendono davvero semplice salvare e ripristinare lo stato corrente della frame window. Sono le funzioni WinStoreWindowPos e WinRestoreWindowPos. Queste funzioni salvano la dimensione e la posizione, nonché tutti i PP, di ogni controllo del frame. (Nota: quando si aggiungono controlli come una barra di stato, è sempre conveniente renderli controlli di frame, perché in questo modo non dovete preoccuparvi di salvare font, colori, ecc. separatamente. Ci occuperemo di questo qualche altra volta).

Vediamo la funzione WinStoreWindowPos per prima. Lo svantaggio di queste funzioni è che salvano tutto nel file OS2.INI. Come detto prima, non tutti gradiscono ciò. La funzione WinStoreWindowPos prende tre parametri:

PSZ     pAppName;  // Stringa che contiene il nome dell'applicazione.
PSZ     pKeyName;  // Stringa che contiene il nome della chiava.
HWND    hwnd;      // Handle della finestra che si vuol salvare.

rc = WinRestoreWindowPos(pAppName, pKeyName, hwnd);

La funzione WinStoreWindowPos deve conoscere solo il nome dell'applicazione e il nome della chiave per i dati nel file OS2.INI. Normalmente, si assegnano questi nomi con dei #define nel file header. In questo modo è più semplice tenere traccia di quali nomi vengono usati. L'estrazione dei valori dalla frame window è gestita interamente da WinStoreWindowPos perciò l'azione che eseguiamo in risposta a WM_SAVEAPPLICATION è molto semplice.

// Segmento dal file Sample6.h

#define APPNAME "Sample6"
#define WINPOS  "Sample6WinPos"

//----------------------------------------------------------------------------
// Salva posizione e dimensioni della finestra all'uscita
//----------------------------------------------------------------------------
case WM_SAVEAPPLICATION:
        {
        WinStoreWindowPos(APPNAME, WINPOS,
                                   WinQueryWindow(hwnd, QW_PARENT));
        }
break;

Parliamo ora di ripristinare i dati. Vogliamo farlo quando siamo sicuri che la finestra sia stata creata. Anche questo codice è molto semplice:

WinRestoreWindowPos(APPNAME,       // Ripristina dimensione/posizione e PP da OS2.INI
                                WINPOS,        //
                                hwndFrame))    //

Nessun problema, abbiamo definito il flag FCF_SHELLPOSITION per la creazione della finestra. E di sicuro, la prima volta che il programma viene eseguito, questo gestisce tutto il dimensionamento e posizionamento della finestra.

Però, se c'è una voce in OS2.INI, il flag FCF_SHELLPOSITION fa in modo che la finestra venga prima mostrata nella posizione e dimensione determinate dal PM, e poi venga spostata secondo quanto salvato dalla sessione precedente. Questo non è esattamente elegante. Quindi cosa facciamo? Dobbiamo impostare dimensioni e posizione a mano se la chiamata a WinRestoreWindowPos fallisce. Per fortuna, questo funzione ritorna un valore per determinare se è stata eseguita con successo. Se questo non si verifica, dobbiamo chiamare WinSetWindowPos con posizione e dimensioni esplicite. Il codice per gestire tutto questo appare così:

//-------------------------------------------------------------------------
// Ripristina posizione/dimensioni e PP da OS2.INI
//-------------------------------------------------------------------------
if (!WinRestoreWindowPos(APPNAME, WINPOS, hwndFrame))
     {
     WinSetWindowPos(hwndFrame,
                     NULLHANDLE,
                     10,10,550,300,
                     SWP_ACTIVATE| SWP_MOVE| SWP_SIZE |SWP_SHOW);
     }

Siamo arrivati all'ultima parte di questo articolo. Sarebbe bello rimuovere la voce che sample6.exe inserisce nel file OS2.INI. Questo può essere fatto con una delle API per i profili. La funzione PrfWriteProfileData può essere usata per inserire dati nel profilo, ma anche per rimuoverli. Senza scendere nei dettagli (lo farò qualche altra volta), farò solo vedere la funzione che si occuperà del nostro problema. Per renderla accessibile, c'è una voce di menu. Questa chiama la seguente funzione:

PrfWriteProfileData(HINI_USERPROFILE, APPNAME, NULL, NULL, 0);

Note conclusive

Fino al prossimo mese, arrivederci.