Come faccio? - parte III

Benvenuti a questa nuova lezione sulla programmazione PM. In questi articoli saranno discussi semplici problemi di programmazione Presentation Manager. Questi articoli sono indirizzati a persone interessate alla programmazione PM o semplicemente curiose di sapere come funzionano i programmi PM. Per comprendere questi articoli, è utile un po' di esperienza di programmazione (preferibilmente in C++).

Siate pigri!

Se vi chiedete di cosa stia parlando, facciamo un semplice esempio. Il mese scorso abbiamo scritto un piccolo programma che inseriva un pulsante in una finestra. Per farlo abbiamo semplicemente creato una istanza della classe pulsante. L'unica cosa che abbiamo fatto da noi è stata impostare (o calcolare) la dimensione del pulsante. Potevamo farlo nel modo più difficile e disegnare tutto il pulsante; così facendo ci saremmo ritrovati persi in un mare di chiamate grafiche. La classe pulsante che è definita in OS/2 fa tutto questo al posto nostro.

A parte essere pigro, sono anche a favore del principio "fallo più semplice possibile". Questo mese introduciamo le risorse come un possibile metodo per mantenere il nostro programma semplice e lavorare il meno possibile (ovvero essere prigri!).

Risorse

Ma prima descriviamo cosa sono le risorse.

In un file di risorse (.RC) possiamo descrivere i controlli con un semplice linguaggio. Questo non è esattamente un linguaggio di programmazione, quanto piuttosto un linguaggio usato per descrivere come appaiono i controlli. In un file di risorse si possono descrivere ad esempio:

• Menu
• Tavole delle scorciatoie
• Modelli per box di dialogo e finestre
• Icone
• Fonts
• Bitmaps
• Stringhe

Nella maggior parte dei casi, non dobbiamo preoccuparci di scrivere il file delle risorse a mano. Assieme a molti compilatori, come pure nel Toolkit di OS/2, vengono forniti speciali editor per le risorse. Questi strumenti offrono un ambiente grafico in cui si possono disegnare le risorse che vogliamo usare.

Sfortunatamente, per le risorse di menu di solito non c'è un strumento grafico. Quindi vediamo come si crea un menu. Il modo migliore per spigarlo è fare un esempio:

MENU MAIN
BEGIN
        SUBMENU "Menu ~1", IDM_MENU1
        BEGIN
                MENUITEM "Item 1.~1", IDM_ITEM1_1
                MENUITEM "Item 1.~2", IDM_ITEM1_2
        END

        SUBMENU "Menu ~2", IDM_MENU2
        BEGIN
                MENUITEM "Item 2.~1", IDM_ITEM2_1
                MENUITEM SEPARATOR
                MENUITEM "Item 2.~2", IDM_ITEM2_2
                MENUITEM "Item 2.~3", IDM_ITEM2_3
        END

        MENUITEM "~About", IDM_ABOUT
END

Se guardate la definizione, dovreste farvi un'idea generale di come appaia il menu. Viene descritto un menu principale con tre elementi, chiamati "Menu 1", "Menu 2" e "About". Se si attiva "Menu 1" o "Menu 2" apparirà un sottomenu, mentre il terzo, "About", è fatto per generare direttamente un evento.

Qualche definizione:

MENU:

L'identificatore MENU è il punto di partenza. Dopo questa parola segue un blocco di definizioni. Tutto assieme forma un menu. Questo blocco deve essere racchiuso tra le parole BEGIN e END.

SUBMENU:

La parola SUBMENU viene usate per dichiarare un sottomenu. Ogni cosa tra BEGIN e END dopo questa parola definisce tale menu. Dentro un sottomenu si possono definire ulteriori sottomenu.

MENUITEM:

Definisce un elemento del menu. Proprio come con SUBMENU, il nome viene inserito subito dopo. Questo è il nome che apparirà nel menu. Notate che in alcuni posti viene usata la ~ (tilde). Ciò può essere fatto solo una volta in ciascun nome. La lettera che segue la tilde sarà sottolineata e potrà essere usata per accedere rapidamente alla voce di menu.

SEPARATOR:

Questa parola è usata in "Menu 2". Se si scrive MENUITEM SEPARATOR, si creerà una linea nel menu. Nel nostro esempio "Item 2.1" e "Item 2.2" saranno separate da una linea.

Con le parole descritte fino ad ora possiamo costruire un menu piuttosto completo. Ci sono comunque molte altre possibiltà, come pulsanti ecc. Queste saranno discusse in un prossimo articolo. C'è un'altra cosa che non ho spiegato a proposito dell'esempio precedente: dopo quasi ogni linea c'è un identificatore tipo IDM_ITEM1_1. Questi sono chiamati identificatori di risorse.

Identificatori di risorse

#define MAIN           1

#define IDM_MENU1      100
#define IDM_ITEM1_1    101
#define IDM_ITEM1_2    102

#define IDM_MENU2      200
#define IDM_ITEM2_1    201
#define IDM_ITEM2_2    203
#define IDM_ITEM2_3    204

#define IDM_ABOUT      300

#include "simple3.h"

param1   USHORT  uscmd         // Valore del comando

param2   USHORT  ussource      // tipo dell'origine
         USHORT  uspointer     // indicatore del puntatore

returns  ULONG   ulReserved    // valore riservato, dovrebbe essere 0

Avrete notato che il primo parametro è un USHORT, perciò non possiamo usarlo semplicemente come ULONG (quale in effetti è, come ogni parametro dei messaggi). Dobbiamo estrarre lo SHORT da questo ULONG. Per fare questo, c'è una piccola macro chiamata SHORT1FROMMP. Guardate questo segmento di codice:

case WM_COMMAND:
     {
     switch (SHORT1FROMMP(mpParm1))
          {
          case IDM_ITEM1_1:
               {
               // Gestiamo l'elemento 1.1
               }
          break;

          case IDM_ITEM1_2:
               {
               // Gestiamo l'elemento 1.2
               }
          break;
          }
     }
break;

Usare le risorse di menu

Dopo aver fatto ciò, dobbiamo dire alla frame window quale risorsa caricare alla sua creazione. Abbiamo chiamato il nostro menu MAIN (che vale 1). Aggiungiamolo al codice di esempio (negli esempi precedenti era impostato a 0).

WinCreateStdWindow (HWND_DESKTOP,     // Genitore
                    WS_VISIBLE,       // Stile (visibile)
                    &flFrameFlags,    // flag di creazione
                    "SampleClass",    // nome della classe
                    "Simple 3 for OS/2 e-Zine!",// Testo del titolo
                    0,                // Client style
                    NULLHANDLE,       // Resource handle
                    MAIN,             // Frame ID  <======= Eccolo!
                    &hwndClient);     // Client handle

WM_COMMAND e il pulsante

Compilare i file .RC

Note conclusive

Tutti i cambiamenti nel file SIMPLE3.CPP (ZIP, 16.7k) sono marcate con "NEW" per renderle più evidenti.