Tutorial 8: I Menu

From UIC

Tutorial 8: I Menu

Tutorial 8: I Menu
Author:	Iczelion
Email:	Traduttore: -NeuRaL_NoiSE
Website:	Mirror
Date:	01/01/2001 (dd/mm/yyyy)
Level:
Language:	Italian
Comments:

Introduzione

In questo tutorial, impareremo come incorporare un menu nella nostra finestra.

Preliminari

Il Menu e' uno dei componenti piu' importanti nella vostra finestra. Il menu presenta una lista dei servizi che il programma offre all'utente. L'utente non deve necessariamente leggere il manuale incluso con il programma per poterlo usare, puo' sperimentare con i menu per avere una visione generale delle capacita' di un determinato programma, e pertanto cominciare a sfruttarlo immediatamente. Dal momento che un menu e' un mezzo per mettere l'utente a suo agio e fargli cominciare subito ad utilizzare il programma, dovreste seguire gli standard. In poche parole, i primi due menu items dovrebbero essere File ed Edit e l'ultimo dovrebbe essere Help. Potete inserire i vostri menu tra Edit ed Help. Se un menu item chiama una dialog box, dovreste aggiungere dei puntini sospensivi (...) alla stringa con il nome del menu. I menu sono una specie di resource (risorsa, NdT). Ci sono diversi tipi di resources, come il dialog box, la string table, le icone, i bitmap, i menu ecc. Le resources sono definite in un file separato chiamato "resource file", che normalmente ha un'estensione .rc. Voi quindi combinate le resources con il codice al momento del link. Il prodotto finale e' un file eseguibile che contiene sia le istruzioni che le resources. Potete scrivere scripts per le resources usando qualsiasi editor di testo. Essi sono composti di frasi che descrivono l'aspetto e altri attributi delle resources usate in un determinato programma. Nonostante possiate utilizzare un editor di testo per scrivere i resource scripts, cio' e' abbastanza difficile. Una scelta migliore e' quella di utilizzare un editor di risorse (resource editor), che vi permette di creare visualmente qualsiasi resource con semplicita'. I resource editors sono spesso inclusi nei package dei compilatori, come nel Visual C++, Borland C++, ecc. Essi scrivono il resource file per voi. Descrivete una menu resource in questo modo:

Chi programma in C potrebbe riconoscere che il procedimento e' simile alla dichiarazione di una structure. MyMenu e' il menu name, seguito dalla keyword MENU e la lista dei menu tra parentesi graffe. In alternativa, potete usare BEGIN e END invece delle parentesi graffe, se volete. Questa sintassi e' piu' consona a chi programma in Pascal. La lista dei menu puo' contenere sia statements MENUITEM che statements POPUP. Lo statement MENUITEM definisce una barra di menu che non chiama un menu di popup quando viene selezionato. La sintassi e' la seguente:

Si comincia con la keyword MENUITEM seguita dal testo che volete usare come nome del menu. Notate l'amperstand (il simbolo "&", NdT). Esso fa si che il carattere successivo sia sottolineato. Dopo la stringa di testo, c'e' la ID del menu item. La ID e' un numero che verra' usato per identificare il menu item nel messaggio inviato alla window procedure quando il menu item viene selezionato. Pertanto, le ID di menu devono essere uniche tra di loro. Le opzioni sono opzionali ( :-), NdT). Le opzioni disponibili sono queste:

• GRAYED Il menu item e' disattivato, e non genera un messaggio WM_COMMAND. Il testo e' grigio (per intenderci, quello dei menu non selezionabili, NdT).
• INACTIVE Il menu item e' disattivato, e non genera un messaggio WM_COMMAND. Il testo viene mostrato normalmente.
• MENUBREAK Questo item e gli items successivi appaiono su una linea nuova nel menu.
• HELP Questo item e gli items successivi sono giustificati a destra.
  

Potete usare una delle opzioni di cui sopra o combinarle con l'operatore "or". Ricordatevi pero' che INACTIVE e GRAYED non possono essere combinati. Lo statement POPUP ha la seguente sintassi:

Lo statement POPUP definisce una barra di menu che, quando selezionata, apre una lista di menu items in una piccola finestra di popup. La lista dei menu puo' essere di tipo MENUTIEM o POPUP. C'e' un tipo speciale di statement MENUITEM, e cioe' MENUITEM SEPARATOR, che disegna una linea orizzontale nella finestra di popup. Il passo successivo, una volta terminato il menu resource script, e' di riferirvisi dal vostro programma. Potete farlo in due posti diversi del programma.

• Nel membro lpszMenuName della struttura WNDCLASSEX. Ad esempio, se avete un menu chiamato "FirstMenu", potete assegnare il menu alla vostra finestra in questo modo:

• Nel parametro "menu handle" di CreateWindowEx, in questo modo:

A questo punto potreste chiedervi, qual'e' la differenza tra questi due metodi ?
Quando riferite un menu nella struttura WNDCLASSEX, il menu diventa il menu predefinito, di "default", per la window class. Ogni finestra di quella class avra' lo stesso menu. Se volete che ogni finestra creata dalla stessa class abbia menu diversi, dovete scegliere il secondo metodo. In questo caso, qualsiasi finestra a cui e' passato un menu handle nella funzione CreateWindowEx avra' un menu che "sovrascrive" il menu di default definito nella struttura WNDCLASSEX. Successivamente esamineremo in che modo un menu notifica alla window procedure che l'utente seleziona un menu item. Quando l'utente seleziona un menu item, la window procedure ricevera' un messaggio WM_COMMAND. La low word di wParam contiene la menu ID del menu item selezionato. A questo punto abbiamo abbastanza informazioni per creare ed usare un menu. Facciamolo.

Contenuto

Il primo esempio mostra come creare ed usare un menu specificando il nome del menu nella window class.

Analizziamo prima il resource file.

Queste righe definiscono le menu IDs usate dal menu script. Potete assegnare qualsiasi valore alle ID sempre che tale valore sia unico nel menu.

Dichiara il vostro menu con la keyword MENU.

Definiscono un menu a popup con quattro menu items, di cui il terzo e' un menu separator.

Definisce una barra di menu nel menu principale.
Successivamente esamineremo il codice:

MenuName e' il nome del menu nel resource file. Notate che potete definire piu' di un menu nel resource file, pertanto dovete specificare quale menu usare. Le restanti tre righe definiscono le stringe testuali che devono essere mostrate in message boxes, che vengono chiamate quando l'appropriato menu item viene selezionato dall'utente.

Definiscono le menu IDs per poterle utilizzare nella window procedure. Questi valori DEVONO essere identici a quelli definiti nel resource file.

Nella window procedure, elaboriamo i messaggi WM_COMMAND. Quando l'utente seleziona un menu item, la menu ID di quel menu item e' inviata alla window procedure nella low word di wParam assieme al messaggio WM_COMMAND. Pertanto quando salviamo il valore di wParam in eax, compariamo il valore in ax alle menu IDs che abbiamo definito in precedenza e ci comportiamo di conseguenza. Nei primi tre casi, quando l'utente sceglie i menu items Test, Say Hello, e Say GoodBye, noi mostreremo semplicemente una stringa di testo in una message box. Se l'utente seleziona il menu item Exit, chiamiamo DestroyWindow con l'handle della nostra finestra come parametro, il che chiudera' la nostra finestra. Come potete vedere, specificare un nome di menu in una window class e' un'operazione abbastanza semplice e diretta. Comunque potete anche utilizzare un metodo alternativo per caricare un menu nella vostra finestra. Non vi mostrero' l'intero codice qui. Il resource file e' identico con entrambi i metodi. Ci sono solo alcuni piccoli cambiamenti nel file sorgente che vi mostrero' qui sotto.

Definisce una variabile di tipo HMENU per conservare l'handle del nostro menu.

Prima di chiamare CreateWindowEx, chiamiamo LoadMenu con l'instance handle e un puntatore al nome del nostro menu. LoadMenu restituisce l'handle del nostro menu nel resource file che poi passiamo a CreateWindowEx.

Note finali

Questi tutorials erano presenti nel sito di RingZero. Li rimettiamo a disposizione a chiunque voglia poter leggerli nella loro traduzione in italiano che fu curata da NeuralNoise.

phobos

Disclaimer