1. Introduzione
Questa DLL vi permette di creare dei menu a tendina colorati con delle icone. L'idea base di questa DLL è quella di costruire una volta sola il menu e di richiamarlo in seguito per farlo comparire. Non è necessario ricostruire continuamente il menu. Ci sono delle funzioni che vi permettono di modificare lo stato di un menu o di inserire/cancellare degli item del menu per renderlo modificabile dinamicamente. Il limite attuale della DLL è di 40 popups caricati simultaneamente
Importante : Ogni comando della DLL espresso con $dll() ritorna un messaggo che può essere di 2 tipi:
S_OK <optionnal data> - Messaggio che indica il successo, nel quale potrebbero essere specificati dei parametri o dei messaggi
S_ERROR <error message> - Messaggio che indica l'errore, specificandolo
2. Mpopup
Questo comando permette di chiamare il menu, di farlo apparire alle coordinate X Y e di indicarne lo stile
Comando:
/dll MPopup.dll MPopup NAME > X Y ALIGN VALIGN CLICK
$dll(MPopup.dll,MPopup,NAME > X Y ALIGN VALIGN CLICK)
- NAME - Nome del menu
- X - Posizione X del Menu
- Y - Posizione Y del Menu
- ALIGN
- center - Menu centrato secondo il valore X
- right - Menu allineato a destra secondo il valore X
- left - Menu allineato a sinistra secondo il valore X (standard)
- VALIGN
- center - Menu centrato secondo il valore Y
- right - Menu allineato in basso secondo il valore Y
- left - Menu allineato in alto secondo il valore Y (standard)
- CLICK
- left - Opzioni cliccabili solamente con il tasto sinistro del mouse (standard)
- right - Opzioni cliccabili solamente con il tasto destro del mouse
Valore di ritorno in caso di successo:
Ritorna l'ID dell'item selezionato. Questa funzione invia ugualmente un Signal al mIRC con l'ID selezionato. Vedere la sezione Eventi
3. MPcreateMenu
Crea un menu vuoto
Comando:
$dll(MPopup.dll,MPCreateMenu,NAME)
Valore di ritorno in caso di successo:
S_OK HMENU
dove HMENU è un Handle di menu per aggiungergli opzioni .
4. MPaddItem
Comando che permette di aggiungere un item a un menu o ad un sottomenu
Comando:
/dll MPopup.dll MPAddItem HMENU > ID ICON STYLE TEXT > Comando
$dll(MPopup.dll,MPAddItem,HMENU > ID ICON STYLE TEXT > Comando)
- HMENU - Handle del menu (valore di ritorno di MPCreateMenu o di MPAddSubMenu)
- ID - ID dell'item (1-500)
- ICON - Icona del menu (0 = nessuna)
- STYLE - Stile del menu (0 - normale, 1 - disabilitato, 2 - con visto, 3 - disabilitato+visto)
- TEXT - Testo dell'item (supporta gli identificatori (preceduti da $) mIRC)
- Comando - un comando mIRC da eseguire quando l'item viene cliccato ( Importante mettere "-" se non vi è alcun comando da compiere)
N.B. Per creare un Menu Separator : HMENU > ID 0 0 -
Valore di ritorno in caso di successo:
S_OK
5. MPaddSubMenu
Questo comando consente di creare un sotto-menu dipendente da un menu-item
Comando:
/dll MPopup.dll MPAddSubMenu HMENU > ID ICON STYLE TEXT
$dll(MPopup.dll,MPAddSubMenu,HMENU > ID ICON STYLE TEXT)
- HMENU - Handle del menu da cui dipende il sotto-menu
- ID - ID dell'item (1-500)
- ICON - Icona del menu (0 = nessuna)
- STYLE - Stile del menu(0 - normale, 1 - disabilitato, 2 - con visto, 3 - disabilitato+visto)
- TEXT - Testo dell'item (supporta gli identificatori (preceduti da $) mIRC)
- Comando - un comando mIRC da essere eseguito quando l'item viene cliccato ( Importante mettere "-" se non vi è alcun comando da compiere)
Valore di ritorno in caso di successo:
S_OK HSMENU
dove HSMENU è un Handle di sotto-menu per aggiungergli opzioni. 6. MPaddIcon
Questa funzione permette di aggiungere un'icona alla lista delle icone del menu. Le icone sono di default definite dal parametro ICON degli item e vanno da 1 a N (il numero di icone della lista)
Comando:
/dll MPopup.dll MPAddIcon NAME > File > index
$dll(MPopup.dll,MPAddIcon,NAME > File > index)
Valore di ritorno in caso di successo:
S_OK
7. MPdeleteMenu
Questa funzione elimina un menu
Comando:
/dll MPopup.dll MPDeleteMenu NAME
$dll(MPopup.dll,MPDeleteMenu,NAME)
Valore di ritorno in caso di successo:
S_OK
8. MPmenuColor
Questa funzione permette di cambiare i colori del menu (i colori standard sono indicanti sull'immagine).
Comando:
/dll MPopup.dll MPMenuColor NAME > TYPE > RGB
$dll(MPopup.dll,MPMenuColor,NAME > TYPE > RGB)
- TYPE
- RGB_TEXT - Colore del testo di un item normale
- RGB_BACK - Colore dello sfondo del menu
- RGB_GRAY - Colore del testo di un item disabilitato
- RGB_HIGH - Colore di un item selezionato
- RGB_HBOX - Colore del bordo di un item selezionato
- RGB_BAND - Colore della banda verticale sinistra del menu
- RGB_CBOX - Colore del bordo di un checkbox con visto
- RGB_BBOX - Colore di riempimento di un checkbox con visto
- RGB_CSEP - Colore del separatore del menu
- RGB - Valore RGB del colore, esprimere con $rgb()
Valore di ritorno in caso di successo:
S_OK
9. MPisMenu
Questa funzione ritorna "true" o "false" a dipendenza se il menu esiste o no
Comando:
$dll(MPopup.dll,MPIsMenu,NAME)
Valore di ritorno in caso di successo:
$true | $false
10 . MPmodifyTtem
Comando che permette di modificare le informazioni di un item. Se non si desidera modificare un parametro, sostituire con un "*" il valore del parametro ed esso rimarrà tale.
Comando:
/dll MPopup.dll MPModifyItem NAME > ID ICON STYLE TEXT > COMMAND
$dll(MPopup.dll,MPModifyItem,NAME > ID ICON STYLE TEXT > COMMAND)
- NAME - Nome del menu
- ID - ID dell'item
- ICON - Icona del menu (0 = nessuna)
- STYLE - Stile dell'item (0 - normale, 1 - disabilitato, 2 - con visto, 3 - disabilitato+visto)
- TEXT - Stile dell'item (supporta gli identificatori (preceduti da $) mIRC)
- COMMAND - un comando mIRC da essere eseguito quando l'item viene cliccato ( Importante mettere "-" se non vi è alcun comando da compiere)
Valore di ritorno in caso di successo:
S_OK
11. MPInsertTtem
Comando che permette di inserire un item a una data posizione all'interno di un menu.
Comando:
/dll MPopup.dll MPInsertItem NAME > ID ICON STYLE TEXT > INSID POS > COMMAND
$dll(MPopup.dll,MPInsertItem,NAME > ID ICON STYLE TEXT > INSID POS > COMMAND)
- NAME - Nome del menu
- ID - ID dell'item
- ICON - Icona del menu (0 = nessuna)
- STYLE - Stile dell'item (0 - normale, 1 - disabilitato, 2 - con visto, 3 - disabilitato+visto)
- TEXT - Stile dell'item (supporta gli identificatori (preceduti da $) mIRC)
- INSID - ID dell'item dove il nuovo item sarà inserito
- POS
- top - l'item sarà inserito sopra l'item INSID
- bottom - l'item sarà inserito sotto l'item INSID
- COMMAND - un comando mIRC da essere eseguito quando l'item viene cliccato ( Importante mettere "-" se non vi è alcun comando da compiere)
N.B. Pour inserire un Menu Separator : NAME > ID 0 0 - > INSID POS
Valore di ritorno in caso di successo:
S_OK
12 . MPdeleteTtem
Comando che permette di cancellare un item.
Comando:
/dll MPopup.dll MPDeleteItem NAME > ID
$dll(MPopup.dll,MPDeleteItem,NAME > ID)
- NAME - Nome del menu
- ID - ID dell'item
Valore di ritorno in caso di successo:
S_OK
13 . MPgetTtemInfo
Quest'utilità ritorna delle informazioni relative all'item di un menu.
Comando:
/dll MPopup.dll MPGetItemInfo NAME > ID
$dll(MPopup.dll,MPGetItemInfo,NAME > ID)
- NAME - Nome del menu
- ID - ID dell'item
Valore di ritorno in caso di successo:
ICON STATE TEXT
14 . MPgetMenuHandle
Questa funzione ritorna l'Handle Menu del sotto-menu per un item puntante verso un sotto-menu.
Comando:
/dll MPopup.dll MPGetMenuHandle NAME > ID
$dll(MPopup.dll,MPGetMenuHandle,NAME > ID)
- NAME - Nome del menu
- ID - ID dell'item
Valore di ritorno in caso di successo:
HMENU - Handle Menu del sotto-menu puntato dall'item
15 . MPIsMenuId
Questa funzione ritorna "true" o "false" a dipendenza se l'ID esiste nel menu o no.
Comando:
/dll MPopup.dll MPIsMenuID NAME > ID
$dll(MPopup.dll,MPIsMenuID,NAME > ID)
- NAME - Nome del menu
- ID - ID dell'item
Valore di ritorno in caso di successo:
$true | $false
16 . Eventi
Ricevete un evento quando selezionate un item nel menu.
Formato:
ON *:SIGNAL:MPOPUP.<NAME>: { echo -a MPOPUP SIGNAL $1- }
-
$1 - ID dell'item (nessuna selezione: ID = 0)
17 . Version
Ritorna informazioni sulla versione della DLL.
18 . Change Log
20/08/2003
- Aggiunta la possibilità di mettere degli identificatori mIRC nel testo degli item
-
Aggiunta la possiblità di mettere un comando da eseguire quando un item è selezionato
-
La freccia che indica i sotto-menu è ora disegnata da me (ClickHeRe, ndT) quindi è migliorata rispetto a quella di Windows
Da fare:
Autore ClickHere
- Testing-> NightMaRe
- #scriptsdb.org @ Undernet @ Webnet
- http://scriptsdb.org
- Versione tradotta in italiano per mIRC Mania da SkY
|
