USR_42

*usr_42.txt*	Per Vim version 6.2.  Ultima modifica: 2002 Ott 08

		     VIM USER MANUAL - by Bram Moolenaar
		  Traduzione di questo capitolo: Luca Ferraro

		         Aggiungere nuovi menù


Da ora sapete che Vim è molto flessibile.  Ciò include i menu usati nella GUI.
Potete definire voi stessi le opzioni del vostro menu per rendere alcuni
comandi più facilmente accessibili.  Ciò soltanto per i felici utenti del
mouse!

|42.1|	Introduzione
|42.2|	Comandi dei menù
|42.3|	Vario
|42.4|	Toolbar ed i menù popup

  Capitolo seguente: |usr_43|  Utilizzo dei tipi di file
Capitolo precedente: |usr_41|  Preparare uno script Vim
	     Indice: |usr_toc|

*42.1*	Introduzione

I menù che Vim usa sono definiti nel file "$VIMRUNTIME/menu.vim".  Se volete
scrivere i vostri menu personali, potreste prima dare un'occhiata a questo
file.
   Per definire un elemento del menù, utilizzate il comando ":menu". La forma
fondamentale di questo comando è molto semplice:

	:menu {elemento-menù} {comando}

Il {elemento-menù} descrive in quale posizione del menù inserire l'elemento.
Un tipico {elemento-menù} è "File.Save", che rappresenta l'elemento "Save"
sotto il menù "File".  Un punto viene utilizzato per separare i nomi.  Un
esempio:

	:menu File.Save  :update<CR>

Il comando ":update" salva il file quando esso sia stato modificato.
   Potete aggiungere un altro livello: "Edit.Settings.Shiftwidth" definisce un
sotto menù "Settings" nel menù "Edit", con l'elemento "Shiftwidth".  Potreste
utilizzare anche livelli inferiori.  Non usatelo troppo, vi toccherebbe
spostare il mouse un bel po' per poter usare così un elemento.
   Il commando ":menu" è molto simile al comando ":map" : il lato sinistro
specifica quale elemento verrà lanciato ed il destro definisce i caratteri che
verranno eseguiti. {keys} sono caratteri, vengono usati solo come li avevate
scritti. Così nell'Insert mode, quando {keys} è puro testo, questo testo viene
inserito.


TASTI DI SCELTA RAPIDA

Il carattere ampersand (&), viene utilizzato per indicare un tasto di scelta
rapida.  Per esempio, potete utilizzare Alt-F per selezionare il menù "File" e
quindi premere S per il comando "Save". (L'opzione 'winaltkeys' può peraltro
disabilitare questa possibilità!).  Comunque il {menu-item} appare come
"&File.&Save".  I caratteri acceleratori veranno sottolineati nel menù.
   Dovrete fare attenzione che ogni tasto venga usato una sola volta in
ciascun menù.  Altrimenti non sapreste quale dei due potrebbe venire usato.
Vim non vi avvisa di ciò.


PRIORITA'

La definizione corrente dell'elemento di menù File.Save è come segue:

	:menu 10.340 &File.&Save<Tab>:w  :confirm w<CR>

Il numero 10.340 è chiamato il numero di priorità.  Questo viene utilizzato
dall'editor per decidere in quale posizione inserire l'elemento di menù.  Il
primo numero (10) indica la posizione sulla barra dei menù.  I menù con i
valori più bassi vengono posizionati a sinistra, quelli con valori più alti
a destra.
   Questi sono le priorità usate per i menù standard:

	  10	20     40     50      60       70		9999

	+------------------------------------------------------------+
	| File	Edit  Tools  Syntax  Buffers  Window		Help |
	+------------------------------------------------------------+

Notate che al menù Help viene dato un numero molto grande, per farlo apparire
il più a destra possibile.
   Il secondo numero (340) determina la posizione dell'elemento nel menù a
discesa.  I numeri più bassi vanno in alto, quelli più alti in fondo.  Queste
sono le priorità nel menù File:

			+-----------------+
	    10.310	|Open...	  |
	    10.320	|Split-Open...	  |
	    10.325	|New		  |
	    10.330	|Close		  |
	    10.335	|---------------- |
	    10.340	|Save		  |
	    10.350	|Save As...	  |
	    10.400	|---------------- |
	    10.410	|Split Diff with  |
	    10.420	|Split Patched By |
	    10.500	|---------------- |
	    10.510	|Print		  |
	    10.600	|---------------- |
	    10.610	|Save-Exit	  |
	    10.620	|Exit		  |
			+-----------------+

Notate che c'è un intervallo tra i numeri.  Qui è dove potete inserire i
vostri elementi personali, se lo volete davvero (spesso è meglio lasciare
stare i menù standard ed aggiungere un nuovo menù per i vostri elementi
personali).
   Quando create un sotto-menù, potete aggiungere un altro ".numero" alla
priorità.  Così ogni nome nel {menu-item} ha i propri numeri di priorità.

CARATTERI SPECIALI

Il {menu-item} in questo esempio è  "&File.&Save<Tab>:w".  Ciò evidenzia un
punto importante: {menu-item} deve essere una sola parola.  Se volete mettere
un punto, spazio o tabulatore nel nome usate la notazione <> (<space> e <tab>,
ad esempio) od usare l'escape backslash (\).

	:menu 10.305 &File.&Do\ It\.\.\. :exit<CR>

In questo esempio, l'elemento di menù "Do It..." contiene uno spazio ed il
comando è ":exit<CR>".

Il carattere <Tab> nel nome del menù viene usato per separare la parte che
definisce il nome del menù da quella che da un'indicazione all'utente.  La
parte dopo il <Tab> viene visualizzata allineata nel menù.  Nel menù File.Save
il nome usato è "&File.&Save<Tab>:w".  Così il nome del menù è File.Save e
l'indicazione è ":w".


SEPARATORI

Le linee di separazione, utilizzare per raggruppare assieme elementi di menù,
possono essere definite usando un nome che inizi e finisca in un '-'.  Ad
esempio "-sep-".  Se si usano diversi separatori i nomi debbono essere
differenti.  Altrimenti i nomi non vanno.
   Il comando da un separatore non verrà mai eseguito, ma voi dovete definirne
comunque uno.  Un solo due punti va bene.  Esempio:

	:amenu 20.510 Edit.-sep3- :

*42.2*	Comandi dei menù

Potete definire elementi del menù che esistono solo per alcune modalità. Ciò
funziona proprio come le variazioni nel comando ":map" :

	:menu		Normal, Visual and Operator-pending mode
	:nmenu		Normal mode
	:vmenu		Visual mode
	:omenu		Operator-pending mode
	:menu!		Insert and Command-line mode
	:imenu		Insert mode
	:cmenu		Command-line mode
	:amenu		All modes

Per evitare che i comandi di un elemento del menù vengano mappati, usate il
comando ":noremenu", ":nnoremenu", ":anoremenu", etc.


UTILIZZO DI :AMENU

Il comando ":amenu" è leggermente diverso.  Esso assume che le {keys} che voi
date debbano essere eseguite in Normal mode.  Quando Vim è in Visual od Insert
mode quando il menù viene usato, Vim prima deve tornare al Normal mode.
":amenu" inserisce un CTRL-C o un CTRL-O per voi.  Per esempio, se usate
questo comando:

	:amenu  90.100 Mine.Find\ Word  *

Allora i comandi del menù risultanti saranno:

	Normal mode:		*
	Visual mode:		CTRL-C *
	Operator-pending mode:	CTRL-C *
	Insert mode:		CTRL-O *
	Command-line mode:	CTRL-C *

Se siete in modalità Command-line, il CTRL-C abbandonerà il comando sinora
scritto.  In Visual e Operator-pending mode CTRL-C fermerà la modalità.  In
Insert mode CTRL-O eseguirà il comando e quindi ritornerà in Insert mode.
   CTRL-O funziona per un solo comando.  Se avete necessità di usare due o più
comandi, inseriteli in una funzione e quindi chiamate questa funzione.
Esempio:

	:amenu  Mine.Next\ File  :call <SID>NextFile()<CR>
	:function <SID>NextFile()
	:  next
	:  1/^Code
	:endfunction

Questa opzione del menù va al prossimo file nella lista degli argomenti con
":next".  Poi cerca la linea che inizia con "Code".
   Il <SID> prima del nome della funzione è l'ID dello script.  Ciò rende la
funzione locale allo script di Vim corrente.  Ciò evita problemi quando una
funzione con lo stesso nome  viene definita in un altro file di script.
Vedere |<SID>|.


MENU' SILENTI

Il menù esegue le {keys} come le avete scritte.  Per un comando ":" ciò
significa che vedrete il comando scritto sulla linea di comando.  Se è un
comando lungo, allora apparirà il prompt hit-Enter.  Ciò potrebbe essere molto
fastidioso!
   Per evitare ciò rendete muto il menù.  Ciò viene fatto con l'argomento
<silent>.  Ad esempio, prendete al chiamata a NextFile() nell'esempio
precedente.  Quando usate questo menù vedrete ciò sulla linea di comando:

	:call <SNR>34_NextFile() 

Per evitare la comparsa del testo, inseriamo "<silent>" come primo argomento:

	:amenu <silent> Mine.Next\ File :call <SID>NextFile()<CR>

Non utilizzate "<silent>" troppo spesso.  Non è necessario per comandi brevi.
Se realizzate dei menù per qualcun altro, poter vedere il comando eseguito
darà un suggerimento su ciò che egli può avere scritto, invece di usare il
mouse.


ELENCARE I MENU'

Quando un comando del menù viene usato senza la parte {keys}, esso elenca i
menù già definiti.  Potete specificare un questo si comporta richiamando il
contenuto di un menù già definito. Potete specificare un {menu-item} od una
parte di esso, per elencare menù specifici.  Esempio:

	:amenu

Ciò elenca tutti i menù.  Che è una lista lunga!  Meglio specificate il nome
di un menù per ottenere una lista più corta:

	:amenu Edit

Questo mostra solo gli elementi del menù "Edit" per tutte le modalità.  Per
mostrare solo uno specifico elemento del menù per l'Insert mode:

	:imenu Edit.Undo

Attenti a scrivere esattamente il nome giusto.  Qui contano maiuscole e
minuscole.  Ma  l'&' per gli acceleratori può venire omesso.  Il <Tab> e ciò
che viene dopo può ugualmente venir lasciato fuori.


CANCELLARE I MENU'

Per cancellare un menù, si utilizza lo stesso comando usato per elencarli, ma
con "menu" cambiato in "unmenu".  Così ":menu" diventa ":unmenu", ":nmenu"
diventa ":nunmenu", ecc.  Per eliminare l'elemento "Tools.Make" per l'Insert
mode:

	:iunmenu Tools.Make

Potete cancellare un intero menù, con tutti i propri elementi, usando il nome
del menù stesso:  Esempio:

	:aunmenu Syntax

Ciò cancella il menù Syntax e tutti i suoi elementi.

*42.3*	Vario

Potete cambiare l'aspetto dei menù tramite delle flags in 'guioptions'.  Nel
valore di default esse sono tutte incluse. Potete rimuovere una flag con un
comando del tipo:

	:set guioptions-=m

	m		Quando rimossa la barra dei menù non viene mostrata.

	M		Quando rimossa non vengono caricati i menù di default.

	g		Quando rimossa  i menù inattivi sono completamente
			rimossi (Non funziona su tutti i sistemi).

	t		Quando rimossa il tearoff non viene abilitato.

La linea punteggiata in cima ai menù non è una linea di separazione.  Quando
selezionate questo elemento il menù biene "teared-off": Viene mostrato entro
una finestra separata.  Questo viene chiamato menù tearoff.  E' utile quando
usate lo stesso menù spesso.

Per la traduzione degli elementi dei menù, vedete |:menutrans|.

Poichè bisogna utilizzare il mouse per selezionare gli elementi dei menù, è
bene usare il comando ":browse" per selezionare un file.  Ed il comando
":confirm" per avere una finestra di dialogo invece di un messaggio di errore,
ad esempio, quando il buffer corrente ha subito modifiche.  Questi due possono
venir combinati:

	:amenu File.Open  :browse confirm edit<CR>

":browse" fa apparire un navigatore di file per selezionare il file da aprire.
":confirm" fa apparire una finestra di dialogo se il file corrente ha subito
modifiche.  Potete scegliere se salvare le modifiche, gettarle via o
cancellare il comando.
   Per elementi più complicati, le funzioni confirm() e inputdialog() possono
venir utilizzate.  I menù di default contengono qualche esempio.

*42.4*	Toolbar ed i menù popup

Ci sono due menù speciali: ToolBar e PopUp.  Elementi che iniziano con
questi nomi non compaiono nella barra del menù normale.


TOOLBAR

La toolbar compare solo se la flag "T" è inclusa nell'opzione 'guioptions'.
   La toolbar utilizza icone piuttosto che testo per rappresentare il comando.
Per esempio, il {menu-item} chiamato "ToolBar.New" provoca la comparsa
dell'icona "New" sulla toolbar.
   Vim ha un set di 28 icone built-in.  Potete trovare una tabella qui:
|builtin-tools|.  La maggior parte di queste è già usata nella toolbar di
default.  Potete ridefinirne l'azione (dopo che i menù di default siano a
punto).
   Potete aggiungere una nuova bitmap per un elemento della toolbar.  Oppure
definire un nuovo elemento per la toolbar con una bitmap.  Per esempio,
definiamo un nuovo elemento di toolbar con:

	:tmenu ToolBar.Compile  Compila il file corrente
	:amenu ToolBar.Compile  :!cc % -o %:r<CR>


Ora bisogna creare una nuova icona.  Per gli utenti di MS-Windows, questa
deve essere in formato bitmap, con il nome "Compile.bmp".  Per Unix viene
usato il formato XPM, il nome è "Compile.xpm".  Le dimensioni devono essere
18x18 pixels (sotto Windows è possibile utilizzare anche altre dimensioni, ma
apparirà noioso).
   Mettete le bitmap nella directory "bitmaps" entro una delle directory del
'runtimepath'. Ad esempio, per Unix "~/.vim/bitmaps/Compile.xpm".

Potete definire anche delle didascalie per le icone della toolbar.  Una
didascalia è una breve testo che spiega cosa farà un elemento della toolbar.
Per esempio "Open file".  Apparirà quando il puntatore del mouse si trova
sull'elemento, senza spostarsi per un attimo.  Ciò è molto utile per capire
l'immagine se non fosse chiara.  Esempio:

	:tmenu ToolBar.Make  Run make in the current directory

	Note:
	Fate molta attenzione alle maiuscole/minuscole.  "Toolbar" e "toolbar"
	sono diverse da "ToolBar"!

Per eliminare una didascalia, usate il comando |:tunmenu|.

L'opzione 'toolbar' può essere utilizzata per mostrare del testo invece di una
bitmap, oppure entrambi testo ed una bitmap.  Molti usano solo la bitmap
poichè il testo prende più spazio.


MENU' POPUP

I menù popup compaiono dove si trova il mouse.  In MS-Windows li attivate
cliccando con il tasto destro del mouse.  Allora potete selezionare un
elemento con il tasto sinistro del mouse.  In Unix i menù popup si attivano
cliccando e rilasciando il tasto destro del mouse.
   I menù popup compaiono solo se l'opzione 'mousemodel' è stata impostata
su "popup" o su "popup_setpos".  La differenza tra le due è che "popup_setpos"
muove il cursore verso la posizione in cui si trova il puntatore del mouse.
Quando si clicca entro una selezione, questa verrà utilizzata non modificata.
Quando c'è una selezione, ma cliccate fuori di essa, la selezione viene
rimossa.
   Esistono menù popup separati per ogni modalità.  Così non ci sono mai
elementi inattivi come nei menù normali.

Qual è il significato della vita, dell'universo e di ogni cosa?  **
Douglas Adams, la sola persona che ha conosciuto cosa fosse davvero questa
questione è ormai morto, sfortunatamente.  Così adesso potreste chiedervi
quale sia il significato della morte...

Capitolo seguente: |usr_43|  Utilizzo dei tipi di file

Copyright: vedere |manual-copyright|  vim:tw=78:ts=8:ft=help:norl:

Segnalare refusi a Bartolomeo Ravera - E-mail: barrav at libero.it

Generated by vim2html on Thu Jun 17 12:17:02 CEST 2004